> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompts

> Profound MCP を通じて利用できるプロンプトツールについて理解します

Profound MCP は、カテゴリーでトラッキングしているプロンプトの確認、それらに対して AI エンジンが返した回答の閲覧、新しいプロンプトの作成、既存プロンプトの更新、プロンプトの一括での有効化・無効化・削除を行うためのツールを AI アシスタントに提供します。MCP クライアントをホスト型サーバーに接続するには、[接続ガイド](/ja-jp/mcp/common-mcp-clients)を参照してください。

## ツールの連携方法

<Steps>
  <Step title="カテゴリーを特定する">
    プロンプトはカテゴリー単位で管理されるため、プロンプトを操作する前に、アシスタントは [`list_categories`](/ja-jp/mcp/capabilities/discovery-tools#list-categories) でカテゴリーを特定します。
  </Step>

  <Step title="トラッキング内容を確認する">
    カテゴリーで実行しているプロンプトを尋ねます。アシスタントは [`list_prompts`](#list-prompts) でプロンプトを一覧表示し、依頼に応じてステータス、トピック、タグで絞り込みます。
  </Step>

  <Step title="回答を読む">
    AI エンジンが何と答えているかを尋ねます。アシスタントは [`get_prompt_answers`](#get-prompt-answers) で、指標の元となる生の回答を取得します。
  </Step>

  <Step title="作成または修正する">
    新しいプロンプトのトラッキングを依頼すると、アシスタントは [`create_prompts`](#create-prompts) でプロンプトの下書きを作成してプレビューします。既存のプロンプトの変更を依頼すると、[`update_prompts`](#update-prompts) でフィールドごとの変更をプレビューします。
  </Step>

  <Step title="有効化、無効化、削除">
    プロンプトの一時停止、再開、完全な削除を依頼します。アシスタントは [`update_prompts_status`](#update-prompts-status) でプロンプトのステータスを一括で切り替えます。
  </Step>
</Steps>

## 動作と安全性

書き込みツールはデフォルトでプレビューモードになっています。アシスタントはまず変更の計画を受け取り、`preview: false` でその計画を適用するまでは何も保存されません。

### 動作

| 動作 | 意味 |
| - | - |
| 適用前のプレビュー | `create_prompts`、`update_prompts`、`update_prompts_status` は最初に計画を返し、変更が適用されるまで何も保存しません |
| 作成はべき等ではない | 適用された `create_prompts` の呼び出しごとに新しいプロンプトが作成されるため、同じ入力で 2 回適用すると重複が作成されます |
| コレクションは置換される | 更新時、`tags`、`regions`、`platforms`、`personas` は、マージされるのではなくセット全体が置き換えられます |
| 削除は完全に行われる | `deleted` を指定した `update_prompts_status` は、プロンプトとその履歴データを削除します |
| 参照の自動作成 | プロンプトでまだ存在しないトピックやタグが指定された場合、ツールはエラーを返すのではなくそれを作成します |
| ライブデータ | ツールは Profound API から読み込むため、結果には現在のアクセス権とデータが反映されます |

### MCP ヒント

読み取りツール(`list_prompts` と `get_prompt_answers`)はデータを取得するだけで、Profound 内の何も変更しません。書き込みツールには、次の MCP ヒントが設定されています。

| ツール | ヒント | 意味 |
| - | - | - |
| `create_prompts` | `idempotentHint: false` | 適用済みの呼び出しを再試行すると、さらにプロンプトが作成されます |
| `update_prompts` | `destructiveHint: true`、`idempotentHint: true` | `tags`、`regions`、`platforms`、`personas` は置き換えられ、同じ入力を 2 回適用しても同じ状態になります |
| `update_prompts_status` | `destructiveHint: true`、`idempotentHint: true` | `deleted` は完全に削除され、すでに対象のステータスになっているプロンプトはスキップされます |

## プロンプトツール

| ツール | 用途 |
| - | - |
| `list_prompts` | ステータス、タグ、トピックのフィルターを使用して、カテゴリーのプロンプトを一覧表示します |
| `get_prompt_answers` | カテゴリーのプロンプトに対して AI エンジンが返した回答を読み込みます |
| `create_prompts` | カテゴリー内に 1 つ以上のプロンプトを作成します |
| `update_prompts` | 既存のプロンプトのフィールドを更新します |
| `update_prompts_status` | プロンプトを一括で有効化、無効化、削除します |

<AccordionGroup>
  <Accordion title="list_prompts" id="list-prompts">
    カテゴリーに設定されているプロンプトを、その ID と詳細とともに一覧表示します。他のプロンプトツールは、この一覧からプロンプト ID を取得します。

    **プロンプトの例**:

    * 「Banking カテゴリーでトラッキングしているプロンプトはどれですか?」
    * 「普通預金口座のトピックで無効になっているプロンプトを表示してください。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `category_id` | はい | - | プロンプトを一覧表示するカテゴリー |
    | `status` | いいえ | `all` | `active`、`disabled`、`all` のいずれか |
    | `tag_ids` | いいえ | `null` | これらのタグが付いたプロンプトのみを含めます |
    | `topic_ids` | いいえ | `null` | これらのトピックに属するプロンプトのみを含めます |
    | `exclude_tag_ids` | いいえ | `null` | これらのタグが付いたプロンプトを除外します |
    | `exclude_topic_ids` | いいえ | `null` | これらのトピックに属するプロンプトを除外します |
    | `combine` | いいえ | `AND` | `tag_ids` と `topic_ids` の両方が設定されている場合の組み合わせ方法: `AND` または `OR` |
    | `limit` | いいえ | `100` | 返されるプロンプトの最大数 |
    | `cursor` | いいえ | `null` | 前回のレスポンスの `next_cursor` から取得したページネーショントークン |
  </Accordion>

  <Accordion title="get_prompt_answers" id="get-prompt-answers">
    指定した期間内に、カテゴリーのプロンプトに対して AI エンジンが返した回答(可視性指標の元となる生のテキスト)を取得します。

    **プロンプトの例**:

    * 「先週、普通預金のプロンプトに対して AI エンジンはどのように回答しましたか?」
    * 「先月の可視性低下の原因となった回答を取得してください。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `category_id` | はい | - | プロンプトの回答を取得するカテゴリー |
    | `start_date` | はい | - | 期間の開始日(この日を含む)。`YYYY-MM-DD` 形式 |
    | `end_date` | はい | - | 期間の終了日(この日を含む)。`YYYY-MM-DD` 形式 |
    | `prompt_id` | いいえ | `null` | 結果を 1 つのプロンプトに絞り込みます |
    | `country` | いいえ | `null` | 名前または ID で 1 つ以上の国に絞り込みます。`region` とは併用できません |
    | `region` | いいえ | `null` | 名前または ID で 1 つ以上の地域に絞り込みます。`country` とは併用できません |
    | `topic_ids` | いいえ | `null` | `list_topics` から取得した ID で 1 つ以上のトピックに絞り込みます |
    | `model_ids` | いいえ | `null` | `list_models` から取得した ID で、回答した 1 つ以上の AI モデルに絞り込みます |
    | `limit` | いいえ | `100` | 結果の 1 ページあたりに返されるプロンプト数 |
    | `offset` | いいえ | `0` | ページネーションのオフセット |

    **注意事項**:

    * 1 つのリストに複数の ID を指定すると、いずれかの ID に一致するものが対象になります。両方の入力が設定されている場合、回答は両方に一致する必要があります。
    * フィルターはページネーションの前に適用されるため、フィルターを指定した呼び出しでは一致する回答のみがページングされます。
  </Accordion>

  <Accordion title="create_prompts" id="create-prompts">
    カテゴリー内に 1 つ以上のプロンプトを作成します。各プロンプトでは、尋ねる質問、所属するトピック、実行するプラットフォームと地域を指定します。

    **プロンプトの例**:

    * 「米国の ChatGPT で 'What are the best running shoes for flat feet?' のトラッキングを開始してください。」
    * 「普通預金口座のトピックで、これらの質問のプロンプトを作成してください。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `category_id` | はい | - | トラッキング対象のカテゴリー。`list_categories` から取得します |
    | `prompts` | はい | - | 作成するプロンプト |
    | `preview` | いいえ | `true` | `true` の場合は実行内容を表示し、`false` の場合は作成します |

    `prompts` の各エントリーでは、次の項目を指定できます。

    | フィールド | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `prompt` | はい | - | プロンプトのテキスト |
    | `topic` | はい | - | トピックの ID または名前。存在しない名前の場合は作成されます |
    | `platforms` | はい | - | プロンプトを実行するプラットフォームの ID または名前 |
    | `regions` | はい | - | プロンプトを実行する地域の ID または名前 |
    | `language` | いいえ | `en-US` | プロンプトの言語 |
    | `tags` | いいえ | `[]` | タグの ID または名前。存在しない名前の場合は作成されます |
    | `analysis_types` | いいえ | `["visibility"]` | 実行する分析の種類: `visibility`、[`sentiment`](https://help.tryprofound.com/articles/3189907319-about-sentiment)、[`accuracy`](https://help.tryprofound.com/articles/5793584301-about-factcheck) |
    | `personas` | いいえ | `[]` | ペルソナの ID または名前 |
    | `asset` | いいえ | `null` | プロンプトに関連付けるアセット |

    **注意事項**:

    * トピック名とタグ名は完全一致で照合されます。名前のスペルを誤ると、既存のトピックやタグに追加されるのではなく新しいトピックやタグが作成され、データが 2 つに分散されます。プレビューでは、これらが `topics_created` と `tags_created` にカウントされるため、確定する前に意図しない新しいトピックやタグがないか確認してください。
    * 作成はべき等ではありません。同じ呼び出しを 2 回適用すると、重複したプロンプトが作成されます。
  </Accordion>

  <Accordion title="update_prompts" id="update-prompts">
    1 つ以上の既存のプロンプトを更新します。プレビューでは、プロンプトごとにフィールド単位の比較が返されます。単一のフィールドについては変更前と変更後の値、コレクションについては追加された値と削除された値が示されます。

    **プロンプトの例**:

    * 「料金関連のプロンプトを 'Fees' トピックに移動してください。」
    * 「普通預金のプロンプトに 'high priority' タグを付けてください。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `category_id` | はい | - | プロンプトを所有するトラッキング対象のカテゴリー |
    | `prompts` | はい | - | 適用するプロンプトの更新内容 |
    | `preview` | いいえ | `true` | `true` の場合は計画された変更を返し、`false` の場合は適用します |

    `prompts` の各エントリーでは、次の項目を指定できます。

    | フィールド | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `id` | はい | - | 更新するプロンプト。`list_prompts` から取得します |
    | `prompt` | いいえ | `null` | 新しいプロンプトのテキスト |
    | `topic` | いいえ | `null` | 新しいトピック |
    | `tags` | いいえ | `null` | 新しいタグのセット |
    | `regions` | いいえ | `null` | 新しい地域のセット |
    | `platforms` | いいえ | `null` | 新しいプラットフォームのセット |
    | `personas` | いいえ | `null` | 新しいペルソナのセット |
    | `analysis_types` | いいえ | `null` | 新しい分析の種類: `visibility`、[`sentiment`](https://help.tryprofound.com/articles/3189907319-about-sentiment)、[`accuracy`](https://help.tryprofound.com/articles/5793584301-about-factcheck) |
    | `language` | いいえ | `null` | 新しい言語 |
    | `asset` | いいえ | `null` | 新しく関連付けるアセット |

    **注意事項**:

    * `tags`、`regions`、`platforms`、`personas` フィールドでは、`null` を渡すと値は変更されず、`[]` を渡すと値が消去され、空でないリストを渡すとセット全体が置き換えられます。タグを 1 つ追加する場合、アシスタントは既存のタグを含む完全なタグのセットを送信します。
  </Accordion>

  <Accordion title="update_prompts_status" id="update-prompts-status">
    プロンプトのステータスを変更します。

    * `active` - 毎日の実行を再開します
    * `disabled` - 今後の実行を停止し、履歴を保持します
    * `deleted` - プロンプトとその履歴データを完全に削除します

    <Warning>
      `deleted` ステータスは注意して使用してください。プロンプトとその履歴データが完全に削除されます。
    </Warning>

    **プロンプトの例**:

    * 「ホリデー関連のプロンプトを無効にしてください。11 月に再開します。」
    * 「先ほど作成したテスト用のプロンプトを削除してください。」

    **入力**

    | 入力 | 必須 | デフォルト | 説明 |
    | - | - | - | - |
    | `category_id` | はい | - | プロンプトを所有するトラッキング対象のカテゴリー |
    | `prompt_ids` | はい | - | ステータスを変更するプロンプトの ID |
    | `status` | はい | - | `active`、`disabled`、`deleted` |
    | `preview` | いいえ | `true` | `true` の場合は計画を返し、`false` の場合は適用します |

    **注意事項**:

    * すでに同じステータスになっているプロンプトにそのステータスを適用しても、何も変更されません。
  </Accordion>
</AccordionGroup>

## リソース

Profound MCP は、プロンプトに関する参考資料を読み取り専用の MCP リソースとして提供しています。

| リソース URI | 説明 |
| - | - |
| `file:///profound/glossary/prompt` | プロンプト(AI アンサーエンジンに送信される個々のクエリ)の定義 |
| `file:///profound/glossary/prompt-generation-model` | Prompt Generation Model の定義。トピックが実行するプロンプトの言い回しや文脈を変化させるモデルです |
| `file:///profound/glossary/responses` | レスポンス(AI エンジンがプロンプトに対して返した完全な回答)の定義 |