HubSpotのMCPクライアントでBreeze agentsへのプロンプトを設定
更新日時 2025年9月3日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
HubSpot MCPクライアントを使用してBreeze agentsをMCPサーバーに接続したら、プロンプトで明確な指示を追加して、どのMCPツールをいつ使用するかをBreeze Agentsに案内する必要があります。プロンプトは、特定のユースケース、セットアップ、および目標に基づいてカスタマイズする必要があります。
Breeze agentsにMCPプロンプトを追加
- HubSpotアカウントにて、[ Breeze > Breeze Studio]に移動します。
- [ エージェント ] タブで、MCP プロンプト を追加するエージェントの名前をクリックします。
- 右上の [エージェントの設定]をクリックします。
- [このエージェントの動作をガイド ]セクションで、[ 追加の手順を追加]をクリックします。
- [その他の手順 ]テキストフィールドに MCPプロンプトを入力します。
![エージェントのMCPプロンプトを入力するための[追加の指示]テキストフィールドを示すスクリーンショット。](https://53.fs1.hubspotusercontent-na1.net/hub/53/hubfs/Knowledge_Base_2023-24-25/KB-breeze-studio/breeze-studio-add-extra-instructions.png?width=500&height=271&name=breeze-studio-add-extra-instructions.png)
Breeze agentsへのMCPプロンプトの追加に関するベストプラクティス
以下の例は、Notion MCPサーバーに接続されたBreezeエージェントにMCPプロンプトを追加するためのガイドとして使用します。これらのベストプラクティスは一般的なフレームワークを提供しますが、特定のユースケースや他のMCPサーバーに合わせてカスタマイズできます。
データベースを識別する
Notionのページとデータベースは固定構造に従わないため、どのデータベースを使用するかをエージェントに正確に指示する必要があります。データベースの名前と目的を明記し、データベースIDがある場合はそれを含めることをお勧めします。
プロンプトの例:
プロジェクト名、ステータス、所有者、期日を含む「Content Projects Tracker」というタイトルのNotionデータベースを使用します。
プロパティーや列の構造を説明
Breezeエージェントがデータを理解できるようにデータベース構造を記述します。関連する列名、列に含まれる内容、プロパティーの種類もリストアップすることをお勧めします。
プロンプトの例:
データベースには、「プロジェクト名」(タイトル)、「所有者」(人物)、「ステータス」(選択)、および「期限」(日付)の列が含まれています。
任意のフィールドがある場合や、常に使用されていない場合は、その旨も伝えておくと役に立ちます。
エージェントのタスクを定義する
エージェントが検出または抽出するべき具体的な情報を明確にします。
プロンプトの例:
-
ステータスが「進行中」で期限が7日以内の全ての項目を検索します。
-
タイトルに「製品発売」が含まれる全てのエントリーを要約します。
アクションとツールの指定
エージェントがquery_database、list_databases、retrieve_pageなどの特定のアクションを実行する必要がある場合、使用すべきツールとその方法を明示的に示すと便利です。これは、エージェントが複数のツールから選択しなければならない場合に特に便利です。
入力と出力の例を示す
エージェントがエントリーを追加または編集する必要がある場合は、データの例を含めることをお勧めします。
プロンプトの例:
新しいエントリーを作成するときは、デフォルトで「ステータス」を「開始前」として入力し、「期限」は空白のままにします。
Breeze agentsの完全なMCPプロンプトの例
Notion MCPサーバーに接続しています。「Feature Rollouts Tracker」というタイトルのデータベースを使用します。これには、[機能名](タイトル)、[ステータス](選択:[未開始]、[進行中]、[完了)]、[PM所有者](人)、[ターゲットリリース日](日付)の列が含まれます。あなたの仕事は、「進行中」とマークされているすべてのフィーチャを見つけて、PM 所有者と共に名前を返すことです。query_databaseツールを使用して、このデータベースからのみ結果を取得できます。