ツールの連携方法
1
カテゴリーを特定する
プロンプトはカテゴリー単位で管理されるため、プロンプトを操作する前に、アシスタントは
list_categories でカテゴリーを特定します。2
トラッキング内容を確認する
カテゴリーで実行しているプロンプトを尋ねます。アシスタントは
list_prompts でプロンプトを一覧表示し、依頼に応じてステータス、トピック、タグで絞り込みます。3
回答を読む
AI エンジンが何と答えているかを尋ねます。アシスタントは
get_prompt_answers で、指標の元となる生の回答を取得します。4
作成または修正する
新しいプロンプトのトラッキングを依頼すると、アシスタントは
create_prompts でプロンプトの下書きを作成してプレビューします。既存のプロンプトの変更を依頼すると、update_prompts でフィールドごとの変更をプレビューします。5
有効化、無効化、削除
プロンプトの一時停止、再開、完全な削除を依頼します。アシスタントは
update_prompts_status でプロンプトのステータスを一括で切り替えます。動作と安全性
書き込みツールはデフォルトでプレビューモードになっています。アシスタントはまず変更の計画を受け取り、preview: false でその計画を適用するまでは何も保存されません。
動作
MCP ヒント
読み取りツール(list_prompts と get_prompt_answers)はデータを取得するだけで、Profound 内の何も変更しません。書き込みツールには、次の MCP ヒントが設定されています。
プロンプトツール
list_prompts
list_prompts
カテゴリーに設定されているプロンプトを、その ID と詳細とともに一覧表示します。他のプロンプトツールは、この一覧からプロンプト ID を取得します。プロンプトの例:
- 「Banking カテゴリーでトラッキングしているプロンプトはどれですか?」
- 「普通預金口座のトピックで無効になっているプロンプトを表示してください。」
get_prompt_answers
get_prompt_answers
指定した期間内に、カテゴリーのプロンプトに対して AI エンジンが返した回答(可視性指標の元となる生のテキスト)を取得します。プロンプトの例:
- 「先週、普通預金のプロンプトに対して AI エンジンはどのように回答しましたか?」
- 「先月の可視性低下の原因となった回答を取得してください。」
注意事項:
- 1 つのリストに複数の ID を指定すると、いずれかの ID に一致するものが対象になります。両方の入力が設定されている場合、回答は両方に一致する必要があります。
- フィルターはページネーションの前に適用されるため、フィルターを指定した呼び出しでは一致する回答のみがページングされます。
create_prompts
create_prompts
カテゴリー内に 1 つ以上のプロンプトを作成します。各プロンプトでは、尋ねる質問、所属するトピック、実行するプラットフォームと地域を指定します。プロンプトの例:
- 「米国の ChatGPT で ‘What are the best running shoes for flat feet?’ のトラッキングを開始してください。」
- 「普通預金口座のトピックで、これらの質問のプロンプトを作成してください。」
prompts の各エントリーでは、次の項目を指定できます。注意事項:
- トピック名とタグ名は完全一致で照合されます。名前のスペルを誤ると、既存のトピックやタグに追加されるのではなく新しいトピックやタグが作成され、データが 2 つに分散されます。プレビューでは、これらが
topics_createdとtags_createdにカウントされるため、確定する前に意図しない新しいトピックやタグがないか確認してください。 - 作成はべき等ではありません。同じ呼び出しを 2 回適用すると、重複したプロンプトが作成されます。
update_prompts
update_prompts
1 つ以上の既存のプロンプトを更新します。プレビューでは、プロンプトごとにフィールド単位の比較が返されます。単一のフィールドについては変更前と変更後の値、コレクションについては追加された値と削除された値が示されます。プロンプトの例:
- 「料金関連のプロンプトを ‘Fees’ トピックに移動してください。」
- 「普通預金のプロンプトに ‘high priority’ タグを付けてください。」
prompts の各エントリーでは、次の項目を指定できます。注意事項:
tags、regions、platforms、personasフィールドでは、nullを渡すと値は変更されず、[]を渡すと値が消去され、空でないリストを渡すとセット全体が置き換えられます。タグを 1 つ追加する場合、アシスタントは既存のタグを含む完全なタグのセットを送信します。
update_prompts_status
update_prompts_status
プロンプトのステータスを変更します。
active- 毎日の実行を再開しますdisabled- 今後の実行を停止し、履歴を保持しますdeleted- プロンプトとその履歴データを完全に削除します
- 「ホリデー関連のプロンプトを無効にしてください。11 月に再開します。」
- 「先ほど作成したテスト用のプロンプトを削除してください。」
注意事項:
- すでに同じステータスになっているプロンプトにそのステータスを適用しても、何も変更されません。