> ## 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. # Agents > Profound MCP で利用できる Agent ツールについて説明します Profound MCP は、MCP クライアントから直接 Profound Agents を構築、管理、実行するためのツールを AI アシスタントに提供します。MCP クライアントをホスト型サーバーに接続するには、[接続ガイド](/ja-jp/mcp/common-mcp-clients)を参照してください。 Profound Agents の詳細については、[Profound ヘルプセンター](https://help.tryprofound.com/articles/9762251986-agents-overview)をご覧ください。 ## ツールの連携のしくみ ### Agent を実行する どの Agent があるかを尋ねます。アシスタントは [`list_agents`](#list-agents) で組織の Agents を、または [`list_agent_definition_templates`](#list-agent-definition-templates) で構築済みのテンプレートを参照します。 Agent の実行に何が必要かを尋ねます。アシスタントは実行を開始する前に、[`get_agent`](#get-agent) で Agent の `input_schema` を読み取ります。 Agent の実行を依頼します。アシスタントは Agent の `input_schema` に合った入力を渡して、[`run_agent`](#run-agent) で実行を開始します。 実行が完了したかどうかを尋ねます。アシスタントは [`get_agent_run`](#get-agent-run) で実行の状態を確認します。 ### Agent を構築する Agent の構築を依頼します。アシスタントは [`start_agent_build_session`](#start-agent-build-session) でビルドセッションを開始し、返された `agent_build_session_id` を以降のすべてのビルド呼び出しに含めます。これにより、構築の試行全体が 1 つのセッションとして追跡されます。 アシスタントは [`list_agent_node_types`](#list-agent-node-types) と [`get_agent_node_schema`](#get-agent-node-schema) を使ってワークフローグラフを組み立てるか、[`list_agent_definition_templates`](#list-agent-definition-templates) でテンプレートから始めます。 接続済みアカウント上で実行されるノードがグラフに含まれる場合、アシスタントは [`list_integrations`](#list-integrations) から取得した ID をそのノードの `integration_id` に設定します。 アシスタントは [`create_agent_definition`](#create-agent-definition) または [`update_agent_definition`](#update-agent-definition) でプランをプレビューし、確認後に下書きを保存します。 アシスタントは [`validate_agent_definition`](#validate-agent-definition) で Agent の構造の問題を早期に検出し、`update_agent_definition` で修正します。これは Agent を公開する前の簡易チェックです。 Agent を公開するよう依頼します。アシスタントは [`publish_agent_definition`](#publish-agent-definition) で公開プランをプレビューし、確認後に適用します。 #### Claude を使用する場合は自然言語で指示する クライアントとして Claude を使用している場合は、さまざまなツールを手動で順に実行させなくても、自然言語でプロンプトを入力するだけで Agent を一度に構築できます。 以下は、プロンプトの例と、それを使って Claude が生成する可能性のある Agent の構造です。 ```text wrap theme={null} Build an Agent in Profound that creates a structured, AEO-optimized article based on provided inputs. It should analyze top-cited pages, live Google results, and existing brand content to produce a well-researched article ``` 上記のプロンプトで Claude が生成した Agent の構造を示す図の例 ## 動作と安全性 Agents ツールは、Agent 定義の作成・更新や Agent の実行開始を行えます。作成、更新、公開のツールはデフォルトでプレビューモードになっており、アシスタントはまず変更のプランを受け取り、確認後に適用します。 | 動作 | 意味 | | - | - | | 適用前のプレビュー | 作成、更新、公開のツールはデフォルトでプレビューモードになります | | ライブデータ | ツールは Profound API から読み取るため、結果は呼び出し元の現在のアクセス権とデータを反映します | ## Agents ツール | ツール | 用途 | | - | - | | `list_agents` | 組織で利用可能な Agents を一覧表示します | | `get_agent` | 入力スキーマを含む、特定の Agent の詳細を取得します | | `run_agent` | Agent の実行を開始します | | `get_agent_run` | 以前に開始した実行のステータスと出力を確認します | | `start_agent_build_session` | Agent を構築または修正するためのビルドセッションを開始します | | `list_agent_node_types` | Agent グラフの構築に使用できるノードタイプを一覧表示します | | `get_agent_node_schema` | 特定のノードタイプの設定スキーマを取得します | | `list_integrations` | ノードの `integration_id` を設定するために、組織が接続しているインテグレーションを一覧表示します | | `list_agent_definition_templates` | 出発点として使用できる構築済みの Agent テンプレートを参照します | | `get_agent_definition` | Agent のワークフローグラフ全体を読み取ります | | `create_agent_definition` | 新しい Agent 定義の下書きを作成します | | `update_agent_definition` | 既存の Agent 定義の下書きを更新します | | `validate_agent_definition` | Agent 定義の下書きが有効で公開可能かどうかを確認します | | `publish_agent_definition` | Agent 定義の下書きを公開して稼働させます | 組織で定義されている Agents を一覧表示します。 **プロンプトの例**: * 「公開済みの Agent はどれですか?」 * 「下書きの Agent を表示して。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `statuses` | いいえ | `["published"]` | 含める Agent のステータス: `published`、`draft`、またはその両方 | | `cursor` | いいえ | - | 前のページから取得したページネーションカーソル | | `limit` | いいえ | - | 返す Agent の最大数 | `input_schema` を含む、特定の Agent の詳細を取得します。アシスタントは `run_agent` を呼び出す前にこれを読み取り、Agent が必要とする入力を確認します。 **プロンプトの例**: * 「記事作成 Agent にはどんな入力が必要ですか?」 * 「週次レポート Agent は何を生成しますか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 取得する Agent の ID | | `version` | いいえ | `published` | 稼働中のバージョンは `published`、未公開の最新の変更は `draft` | Agent の実行を開始します。アシスタントが `get_agent_run` で使用できる実行 ID を返します。 **プロンプトの例**: * 「記事作成 Agent を『AI search trends』というトピックで実行して。」 * 「週次レポート Agent を開始して。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 実行する Agent の ID | | `inputs` | はい | - | Agent の `input_schema` に基づく入力値 | **注意事項**: * `inputs` の各キーは、Agent の `input_schema` のプロパティ ID です。各プロパティの人間が読めるラベルは、そのプロパティの `title` に含まれています。 以前に開始した Agent の実行のステータスと出力を取得します。アシスタントは、実行が成功または失敗して終了するまで、これを繰り返し確認します。 **プロンプトの例**: * 「あの Agent の実行は終わりましたか?」 * 「記事作成 Agent は何を生成しましたか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 実行が属する Agent の ID | | `run_id` | はい | - | `run_agent` から返された実行 ID | | `verbose` | いいえ | `false` | `true` の場合、各ステップの未加工の出力をレスポンスに含めます | Agent のビルドセッションを開始します。これは Agent を構築または修正する前の最初のステップです。アシスタントは他のビルドツールより先にこれを呼び出し、返された `agent_build_session_id` を以降のすべてのビルド呼び出しに含めます。 **プロンプトの例**: * 「引用データから AEO に最適化された記事の下書きを作成する Agent を構築して。」 * 「週次レポート Agent を作り直そう。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `intent` | はい | - | Agent に実行させたい内容の、平易な言葉による短い説明 | Agent の構築に使用できるノードタイプを一覧表示します。各タイプの `node_type` 識別子、表示名、1 行の説明を返します。アシスタントは、ビルドセッションを開始した後、新しい Agent を組み立てる際にこれを呼び出します。 **プロンプトの例**: * 「Agent ではどんな構成要素を使えますか?」 * 「Web 検索を実行するノードはありますか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `kind` | いいえ | `null` | ノードが使用する認証情報の種類で一覧を絞り込みます: `third_party`、`platform_key`、または `native`。省略すると全一覧を返します | **注意事項**: * `third_party` ノードは、WordPress や Slack など、組織が接続したアカウント上で実行されます。`platform_key` ノードは、Exa や Perplexity など、Profound が契約している外部のリサーチベンダー上で実行されるため、ユーザー側で接続する必要はありません。`native` ノードは Profound 独自のノードで、`llm` や `code` などの構造ノードと、Profound のデータを読み取る `profound_*` ノードが含まれます。 特定のノードタイプの設定スキーマと例を取得します。アシスタントは返されたスキーマを使用して、Agent の構築や編集時にノードの `config` を正しく設定します。 **プロンプトの例**: * 「LLM ノードはどのように設定しますか?」 * 「code ノードにはどんな設定がありますか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `node_type` | はい | - | `list_agent_node_types` から取得したノードタイプ識別子 | 組織が接続し、Agents で利用できるようにしたインテグレーションを一覧表示します。接続ごとに `integration_id` を返し、アシスタントは Agent を公開する前にこれをインテグレーションノードに使用します。 **プロンプトの例**: * 「Agent で使えるインテグレーションはどれですか?」 * 「WordPress は接続されていて、Agent から公開できますか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `provider` | いいえ | `null` | `wordpress` や `google_gmail` など、インテグレーションプロバイダーで結果を絞り込みます。結果が空の場合、そのプロバイダーのインテグレーションは接続されていません | **注意事項**: * このツールはアクティブな接続のみを返します。 * 各接続は `integration_id`、`provider`、`account`、`label`、`status`、`level`(`org` または `user`)を返します。 * 同じインテグレーションプロバイダーの接続が複数ある場合(たとえば、ブログ用とドキュメント用の 2 つの異なる WordPress サイト)、`account` フィールドで接続を区別できます。 * Google Docs、Google Slides、Google Sheets は組織の Google Drive 接続を使用するため、返された `google_drive` 接続は 3 つすべてのノードに対応します。Gmail と Google Search Console には、それぞれ独自の接続があります。 構築済みの Agent テンプレートの公開カタログを参照します。各テンプレートには、平易な言葉で書かれた目標、必要な入力、生成されるもの、出発点として使用できるワークフローの骨組みが含まれます。アシスタントは、新しい Agent をゼロから構築する前にこれを呼び出します。 **プロンプトの例**: * 「どの Agent テンプレートから始められますか?」 * 「コンテンツ更新ワークフロー用のテンプレートはありますか?」 **入力:** なし。 `create_agent_definition` と `update_agent_definition` が受け付けるのと同じ形式で、Agent の定義グラフを読み取ります。アシスタントは、既存の Agent をコピーする場合や、複製したいノードタイプを調べる場合にこれを使用します。 **プロンプトの例**: * 「記事作成 Agent がどのように構築されているか見せて。」 * 「週次レポート Agent をコピーして、新しい Agent の出発点にして。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 読み取る Agent の ID | | `version` | いいえ | `published` | 稼働中のバージョンは `published`、未公開の最新の変更は `draft` | 新しい Agent 定義の下書きを作成します。プレビューでは何も保存せずに、平易な言葉によるプランとワークフロー図を返し、確認後にアシスタントが下書きを保存します。 **プロンプトの例**: * 「そのワークフローを下書きの Agent として保存して。」 * 「今設計した Agent を作成して。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `name` | はい | - | Agent の表示名 | | `description` | はい | - | Agent が行うこと | | `organization_id` | はい | - | Agent を作成する組織(`list_organizations` から取得) | | `graph` | はい | - | `{ nodes, edges }` オブジェクト形式のワークフローグラフ | | `agent_build_session_id` | はい | - | `start_agent_build_session` から取得したセッション ID | | `preview` | いいえ | `true` | `true` の場合は保存せずにプランを返し、`false` の場合は下書きを保存します | 既存の Agent 定義の下書きを更新します。アシスタントは、`create_agent_definition` の後に検証の問題を修正したり、保存済みの下書きを反復的に改善したりするためにこのツールを使用します。最初にプレビューを表示し、確認後に適用します。 **プロンプトの例**: * 「検証の問題を修正して下書きを更新して。」 * 「下書きの Agent に Web 検索のステップを追加して。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 更新する下書き Agent の ID | | `graph` | はい | - | 更新後の定義グラフ | | `agent_build_session_id` | はい | - | `start_agent_build_session` から取得したセッション ID | | `preview` | いいえ | `true` | `true` の場合は保存せずにプランを返し、`false` の場合は保存します | 保存済みの Agent 定義の下書きが有効かどうかを確認します。`valid`(ブール値)、`issues`(対処可能なエラーの一覧)、および下書きが公開可能な場合は、公開後に Agent が公開する `input_schema` と `output_schema` を返します。 **プロンプトの例**: * 「下書きの Agent が公開可能か確認して。」 * 「公開する前に、Agent に問題はありますか?」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 検証する下書き Agent の ID | | `agent_build_session_id` | はい | - | `start_agent_build_session` から取得したセッション ID | **注意事項:** * 下書きの Agent は実行できないため、公開前に利用できるチェックはこれだけです。 * このチェックは Agent の構造のみを対象とするため、合格した下書きでも公開時に拒否される場合があります。公開時にはより厳格なチェックが適用されます。 * このチェックでは、設定されているが使用できない必須フィールドも報告されます。たとえば、接続済みアカウント上で実行されるノードの `integration_id` が空の場合や、Profound のデータを読み取るノードに `data.category_id` がない場合です。公開時にはどちらも許可されるため、いずれかが未解決のまま公開された Agent は実行時に失敗します。 * チェックで問題が見つかった場合、アシスタントは `update_agent_definition` で修正します。 Agent 定義を公開して稼働させ、組織全体で表示できるようにします。最初にプレビューを表示し、確認後に適用します。 **プロンプトの例**: * 「チームが使えるように Agent を公開して。」 * 「記事作成 Agent を稼働させて。」 **入力** | 入力 | 必須 | デフォルト | 説明 | | - | - | - | - | | `agent_id` | はい | - | 公開する下書き Agent の ID | | `agent_build_session_id` | はい | - | `start_agent_build_session` から取得したセッション ID | | `preview` | いいえ | `true` | `true` の場合は公開せずにプランを返し、`false` の場合は公開します | **注意事項**: * 公開時には、変更が行われる前に Agent の構造と出力の接続がチェックされるため、構造上の問題がある下書きは拒否され、下書きのまま残ります。このチェックは `validate_agent_definition` が実行するチェックよりも厳格です。 * 公開時には、Agent の実行に必要なものはチェックされません。ノードの `integration_id` または `data.category_id` が欠けている Agent は公開できますが、実行時に失敗するため、公開前に両方を解決してください。 ## リソース Profound MCP は、Agents のリファレンス資料を読み取り専用の MCP リソースとして提供します。 | リソース URI | 説明 | | - | - | | `file:///profound/agent-builder-guide` | 要件のヒアリングと構築から、プレビュー、検証、公開、実行までを網羅した Agent 構築のプレイブック | | `file:///profound/glossary/agent` | Profound Agent の定義 | | `file:///profound/glossary/agent-run` | Agent の実行の定義 |