メインコンテンツにスキップ
お客さまへの大切なお知らせ:膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。正確な最新情報については本コンテンツの英語版をご覧ください。

HubSpotのMCPクライアントでBreeze agentsへのプロンプトを設定

更新日時 2025年9月3日

以下の 製品でご利用いただけます(別途記載されている場合を除きます)。

HubSpot MCPクライアントを使用してBreeze agentsをMCPサーバーに接続したら、プロンプトで明確な指示を追加して、どのMCPツールをいつ使用するかをBreeze Agentsに案内する必要があります。プロンプトは、特定のユースケース、セットアップ、および目標に基づいてカスタマイズする必要があります。 

Breeze agentsにMCPプロンプトを追加

  1. HubSpotアカウントにて、[ Breeze > Breeze Studio]に移動します。
  2. [ エージェント ] タブで、MCP プロンプト を追加するエージェントの名前をクリックします。
  3. 右上の [エージェントの設定]をクリックします。
  4. [このエージェントの動作をガイド ]セクションで、[ 追加の手順を追加]をクリックします。
  5. [その他の手順 ]テキストフィールドに MCPプロンプトを入力します。

エージェントのMCPプロンプトを入力するための[追加の指示]テキストフィールドを示すスクリーンショット。

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ツールを使用して、このデータベースからのみ結果を取得できます。

この記事はお役に立ちましたか?
こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。