ベータエージェントビルダーでエージェントを作成・カスタマイズする

ビジネスプロセスに基づいてデータの分析、出力の生成、アクションの実行が可能なカスタムエージェント（ベータ版）を作成します。Modern Builder では、エージェントがどのような動作を行うべきか、どのデータにアクセスできるか、そしてどのように応答すべきかを定義することができます。

カスタムエージェントは、データに対して一貫したロジックを適用することで、タスクの実行方法を標準化し、手作業の負担を軽減します。これは、記録の確認、構造化された出力の生成、あるいは複数のデータソースに基づいて意思決定を行う必要があるプロセスにおいて有用です。

AI機能の利用に向けたアカウント設定の概要については、「」を参照し、AI機能を利用するためにHubSpotアカウントを設定する方法をご確認ください（）。

注：AI設定でAI機能へのアクセスを管理し、共有するデータを設定できます。AIのセキュリティー管理、データ使用、コンプライアンスの詳細については、HubSpotのAI信頼性に関するFAQおよびAIモデルカードをご確認ください。

始める前に

エージェントビルダーでエージェントの作成やカスタマイズを始める前に、要件と注意事項を確認してください。

• スーパー管理者は 、[AI設定]で以下のスイッチをオンに切り替える必要があります。

  • 生成AIツールや機能へのアクセス権をユーザーに付与

  • CRMデータ

  • 顧客へのコンバージョンデータ

  • ファイルデータ

  • ユーザーにBreezeアシスタントへのアクセス権を付与

エージェントビルダーでエージェントを作成する

指示を定義し、アクションを選択し、使用するデータや入力を設定して、カスタムエージェントを作成します。

1. HubSpotアカウントで、「」→「More」をクリックし、「」→「Agents」を経て、「」→「Agent Hub」に移動します。またはがアカウントに表示されない場合は、Agents > Agent Hubに直接アクセスしてください。

2. 「」の「Intro」タブで、右上の「Create」ドロップダウンメニューをクリックし、「Agents」を選択します。

3. エージェントビルダーで、エージェントの指示、アクション、ナレッジ、および入力を設定します。

指示

エージェントが何をすべきか、どのように振る舞うべきかを定義します。エージェントの役割、目標、アプローチ、および期待される成果を含めてください。

エージェントビルダーの「Instructions」フィールドに、「text」と入力してください。担当者の役割、目標、アプローチ、および期待される成果を明確に定義してください。

たとえば、次のような指示を追加することができます：

Role:
You’re a customer onboarding review agent responsible for preparing internal handoffs after a deal is closed.
Goal:
Analyze customer information and summarize key details needed for a successful onboarding process.
Approach: 
Review contact and company properties, deal details, and recent activity.
Identify important context such as customer goals, purchased products, timeline expectations, and risks.
Flag any missing or unclear information that may impact onboarding.
Output:
Section 1: Customer summary (3-5 bullet points).
Section 2: Key onboarding considerations.
Section 3: Missing information or risks.
Keep responses concise, structured, and actionable.

アクション

エージェントが実行できるアクションを選択してください。アクションは、指示に基づいてエージェントが実行できるタスクを決定します。

1. エージェントビルダーで、「」をクリックし、左側のパネルから「」アクションを追加します。

2. 右側のパネルで、「」、「HubSpot」、「Default」、または「MCP」のタブをクリックし、「」アクションを選択します。

   • HubSpot：さまざまな種類のアクションから選択します（例：データの取得、生成、アクションの実行）。アクションの種類を絞り込むには、「Types」のドロップダウンメニューをクリックし、「」タイプを選択します（例：Generate）。

   • デフォルト：などのデフォルトのアクションから選択します。ウェブの閲覧またはHubSpot CRM レコードの閲覧。

     • ウェブの閲覧：これにより、エージェントはウェブを閲覧できるようになります。

     • HubSpot CRMのレコードを閲覧する：これにより、エージェントはCRMレコードを閲覧できるようになります。

     • HubSpot CRMレコードへの書き込み権限を付与してください（）：これにより、エージェントはCRMレコードへの書き込みが可能になります。

   • MCP（）：Model Context Protocol（MCP）を使用して、エージェントを外部システムに接続します。がサポートするMCPサーバーの詳細については、をご覧ください。

ナレッジ

エージェントが出力を生成する際に参照できる、具体的なユースケースのコンテキスト（アップロードされたドキュメント、ブランドガイドライン、ナレッジベース、関連するCRMデータなど）を追加してください。

「ナレッジ」セクションを使用して、エージェントがデータの分析や回答の作成を行う際に参照できる補足情報を提供してください。入力とは異なり、このコンテキストは、エージェントが実行されるたびに再定義されることなく利用可能です。

たとえば、オンボーディング業務を主とするエージェントは、取引の詳細、関連する企業情報、および最近の活動状況などを参考にすることがある一方、コンテンツ業務を主とするエージェントは、アップロードされた文書やファイルを活用することがある。

1. エージェントビルダーで、「」をクリックします。「Knowledge」セクションに、「」というナレッジを追加します。

2. 右側のパネルで、「」「Custom」、「」「Default」、または「」「Integrations」をクリックし、のナレッジを選択します。

   • のカスタマイズ：ナレッジボルトを選択してください。におけるナレッジ・ヴォールトを活用した管理エージェントのコンテキスト管理について、詳しくはこちらをご覧ください：。

   • デフォルトの：のブランドキット（）や、のICP（）など、デフォルトのコンテキストから選択してください。

   • 連携機能：の連携機能をクリックして、連携対象を設定してください。

入力

エージェントが実行されるたびに使用する具体的なデータ（レコード、ユーザーが入力した値、あるいは別のツールやプロセスから渡された情報など）を定義します。

入力を使用して、特定の実行においてエージェントがどのような対象に対して行動すべきかを指定します。知識とは異なり、入力は実行時に提供され、コンテキストによって異なる場合があります。

たとえば、オンボーディングを専門とするエージェントは、案件名、成約日、顧客の目標などの情報を用いるのに対し、コンテンツを専門とするエージェントは、トピック、対象読者、またはキーメッセージなどの情報が必要となる場合があります。

1. エージェントビルダーで、「」をクリックします。「Inputs」の「」セクションに、「」という入力を追加します。

2. 「」をクリックし、「Input type」の「」ドロップダウンメニューから、「」オプションの「」（例：CRMオブジェクト）を選択します。

3. 「」ラベルの「」フィールドに、入力用の名「」を入力します。 

エージェントのアクセス権限を管理する

各エージェントにアクセスできるユーザーを管理します。デフォルトでは、のスーパー管理者（）はエージェントを編集でき、すべてのユーザーがエージェントを実行できます。

エージェントの設定が、ユーザーがアクセス権を持たない他のHubSpot機能（ブログやランディングページなど）に依存している場合、たとえそのユーザーがエージェントを編集または実行する権限を持っていたとしても、そのユーザーはエージェントを実行できません。

1. エージェントビルダーで、の3つの縦点アイコンをクリックし、左上の「」を選択して、「」へのアクセス権を割り当てます。

2. 右側のパネルで、「」のアクセスオプションを選択します。：

   • 所有者とスーパー管理者は、を編集および実行できます。エージェントを作成またはインストールしたユーザー、およびのスーパー管理者のみが、エージェントを編集および実行できます。

   • 所有者とスーパー管理者は編集が可能で、すべてのユーザーがを実行できます。エージェントの編集ができるのは、そのエージェントを作成またはインストールしたユーザー、およびのスーパー管理者のみです。すべてのユーザーがエージェントを実行できます。

   • は誰でも編集・実行できます：どのユーザーでもエージェントを編集・実行できます。

   • のチームおよびユーザーごとのアクセス権設定：選択されたユーザーおよびチームのみが、エージェントの編集や実行を行うことができます。このオプションを選択すると、追加のアクセスオプションが表示されます。

     • の実行と編集：指定されたユーザーまたはチームは、エージェントを実行および編集できます。

     • を実行：選択したユーザーまたはチームがエージェントを実行できます。

3. 完了したら、［更新］をクリックします。

エージェントビルダーでエージェントをテストする

エージェントをテストして、出力が期待どおりであることを確認してください。テストを行うことで、エージェントが正しい入力を使用し、正しいデータを参照し、期待通りの結果を返していることを確認できます。 

についてご注意ください：エージェントのテストにはクレジットは消費されません。エージェントビルダーでの推定エージェント費用の確認方法について、詳しくはこちらをご覧ください。

1. 右側のパネルに、に必要な入力値「」を入力してください。

2. 「」をクリックし、「」でエージェントをテストしてください。

3. ダイアログボックスで、「」をクリックし、「」を実行します。

4. 「」の「」タブで、以下の項目について出力を確認してください。

   • エージェントが所定の形式に従っていることを確認してください。

   • エージェントは、予想されるデータと文脈を利用します。

   • 不備、不正確な点、または不明確な回答があれば特定してください。

5. 必要に応じてエージェントの設定を更新してください：

   • 説明を洗練させ、明確さや具体性を高めてください。

   • 関連するデータが欠落している、または不正確な場合は、情報源を調整してください。

   • 必要な情報が確実に含まれるよう、入力内容を更新してください。

6. 出力が安定し、要件を満たすようになるまで、テストを繰り返してください。その後、与信コストの見積もりを確認し、実行限度額を設定してください。

クレジット費用の見積もりを確認し、利用限度額を設定する

エージェントのテストが完了したら、そのタスクに必要なHubSpotクレジットの推定量を確認してください。また、実行制限を設定して、エージェントが実行中に使用できるクレジットの上限を制御することもでき、アカウント全体のクレジット使用量を管理するのに役立ちます。

1. エージェントビルダーで、ページ上部の「」をクリックし、「」の実行履歴を表示します。

2. 左側のパネルで、「」エージェントの実行をクリックします。

3. 右側のパネルで、「」の推定クレジットを確認してください。

これらの見積もりは、あくまで参考情報として提供されるものです。実際の費用は異なる場合があります。詳細については、r 、エージェントの推定クレジットコストの確認および、月間実行制限の設定をご覧ください。

カスタムエージェントを公開する

エージェントをテストし、出力が期待どおりであることを確認したら、エージェントを保存して公開し、利用可能にしてください。 

1. エージェントビルダーで、[ ] をクリックし、変更を保存して公開します。。

2. エージェントを実行するには、右上の「」をクリックし、「」を実行してください。の動作や、エージェントの受信トレイでのエージェント出力の確認方法の詳細については、をご覧ください。

公開後は、そのエージェントをより広範なプロセスの一部として活用し、他の自動化プロセスにも組み込んでください。について、ワークフローへのエージェントの追加方法の詳細はこちらをご覧ください：。

次のステップ

• エージェントを実行し、エージェントの受信トレイで出力を確認する
• 代理店を利用する際は、推定されるクレジット費用を確認してください