Profound Docs のドキュメントは Knowledge Base のドキュメントではありません。AI アシスタントや Agents が検索・取得するコンテンツを追加するには、代わりに
add_knowledge_base_document ツールを使用してください。Knowledge Base を参照してください。ツールの連携方法
1
ドキュメントを探す
ドキュメントが存在するかどうか、または最近変更されたドキュメントはどれかを尋ねます。アシスタントは
list_docs でドキュメント名を検索し、各結果へのリンクを提示します。2
内容を読む
要約または全文を依頼します。アシスタントは
get_doc でドキュメントを読み込みます。デフォルトでは冒頭部分のみを確認し、タスクに必要な場合は本文全体を読み込みます。3
作成または修正する
新しいドキュメントを依頼すると、アシスタントが下書きを作成し、
create_doc で保存します。既存のドキュメントの変更を依頼すると、replace_doc_content でドキュメントを書き換えます。4
名前変更、共有範囲の変更、削除
ドキュメントの名前変更や閲覧できるユーザーの変更(
update_doc)、またはアシスタントが以前に作成したドキュメントの削除(delete_doc)を依頼します。動作と安全性
書き込みツールはデフォルトでプレビューモードになっています。アシスタントはまず変更の計画を受け取り、その計画を適用するまでは何も変更されません。例外はdelete_doc で、プレビューがなく、最初の呼び出しで削除が実行されます。
動作
MCP ヒント
書き込みツールには、次の MCP ヒントが設定されています。
すべての書き込みツールには
openWorldHint: true も設定されています。これは書き込みがライブの共有環境に反映されることを MCP クライアントに伝えるもので、クライアントは実行前に確認を求める場合があります。
Profound Docs ツール
list_docs
list_docs
ドキュメントと、その名前、オーナー、公開範囲、リンク(
url)などの詳細を検索します。結果は最終更新日時の新しい順に並べられ、ドキュメントの本文は含まれません。プロンプトの例:- 「AEO 戦略に関するドキュメントはすでにありますか?」
- 「最近変更された Profound ドキュメントはどれですか?」
制限事項:
- このツールは、ドキュメントの作成者やオーナーで絞り込むことはできません。特定のユーザーのドキュメントを探す場合、アシスタントはすべてのドキュメントを一覧表示して各行のオーナーを確認するため、時間がかかることがあります。
- このツールは、ドキュメントの総数を返しません。
get_doc
get_doc
1 つのドキュメントを読み込みます。デフォルトのプレビューでは、本文の冒頭部分のみが返されます。タスクで全文やドキュメント上のディスカッションが必要な場合、アシスタントは本文全体またはコメントを読み込みます。プロンプトの例:
- 「AEO 戦略メモを要約してください。」
- 「Q3 の振り返りを、寄せられたコメントも含めて全文読んでください。」
create_doc
create_doc
アシスタントが下書きしたコンテンツから新しいドキュメントを作成します。このツールは 1 回の呼び出しで本文全体を受け取ります。プロンプトの例:
- 「今四半期の可視性データに基づいて Q3 の AEO 振り返りを作成し、Profound ドキュメントとして保存してください。」
- 「競合ブリーフの下書きを作成し、後で共有できるように Profound に保存してください。」
注意事項:
- ドキュメントのタイトルは組織内で一意です。既存のタイトルでドキュメントを作成すると、既存のドキュメントが返され、新しい本文は破棄されます。
- 新しいドキュメントは作成者のみが閲覧できます。
- ドキュメントの作成から本文の保存までの間に呼び出しが失敗した場合、ドキュメントは空の状態で存在し、レスポンスで
content_written: falseが報告されます。再試行すると、本文が書き込まれるのではなく、同じ空のドキュメントが返されます。
replace_doc_content
replace_doc_content
ドキュメントのコンテンツを新しいテキストに置換します。チェックボックスへのチェックからセクションの書き換えまで、既存のドキュメントへのあらゆる変更はこのツールを通じて行われます。プロンプトの例:
- 「AEO 戦略メモにショッピングプロンプトに関するセクションを追加してください。」
- 「Q3 の振り返りの誤字を修正してください。」
注意事項:
- ドキュメントのコンテンツが置換されると、
skip_title_syncがtrueでない限り、タイトルは新しいコンテンツの最初の見出しに合わせて更新されます。
update_doc
update_doc
ドキュメントの名前変更、閲覧できるユーザーの変更、またはその両方を 1 回の呼び出しで行います。プロンプトの例:
- 「戦略メモの名前を ‘AEO strategy H2’ に変更してください。」
- 「Q3 の振り返りを組織全体に公開してください。」
注意事項:
nameとvisibilityのうち少なくとも 1 つが必要です。どちらも指定しない呼び出しはエラーを返します。- ドキュメントの名前を変更しても、ドキュメントの最初の見出しは変更されず、以降タイトルは見出しに追従しなくなります。たとえば、“AEO strategy” を “AEO strategy H2” に名前変更しても、ドキュメントの最初の見出しは “AEO strategy” のままです。
update_docで組織内の全員に付与できるアクセスレベルは閲覧のみです。組織内の全員がすでに編集アクセス権を持っている場合、MCP を通じてvisibilityをorganizationに設定すると、そのアクセス権は閲覧のみに格下げされます。- このツールは、MCP を通じて作成されたドキュメント、または Profound プラットフォームで自分自身が作成したドキュメントにのみ使用できます。自分と共有されたドキュメントは、編集アクセス権があっても名前変更や共有範囲の変更はできず、公開範囲を変更できるのは作成者のみです。
delete_doc
delete_doc
アシスタントが以前に MCP 接続を通じて作成したドキュメント(誤っていた下書きや重複など)を削除します。プレビューモードがない唯一の書き込みツールです。プロンプトの例:
- 「先ほど作成した下書きを削除してください。最終版を残します。」
- 「そのブリーフは重複していたので削除してください。」
注意事項:
- 削除できるのは MCP を通じて作成されたドキュメントのみで、削除できるのはその作成者のみです。
- 削除は確定的で、元に戻すことはできません。