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

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

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

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

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

要件を理解する

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

• スーパー管理者は、AI設定で以下のスイッチをオンにする必要があります：
  • 生成AIツールや機能へのアクセス権をユーザーに付与
  • CRMデータ
  • 顧客へのコンバージョンデータ
  • ファイルデータ
  • ユーザーにBreezeアシスタントへのアクセス権を付与

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

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

1. HubSpotアカウントで、［その他］をクリックし、［エージェント］＞［Agent Hub］の順に進みます。アカウントに［その他］が表示されない場合は、［エージェント］＞［Agent Hub］に直接移動します。

2. [概要]タブで、右上の [ 作成 ] ドロップダウンメニューをクリックし、[エージェント ] を選択します。

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

指示

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

エージェント作成ツールの「指示」フィールドにテキストを入力します。担当者の役割、目標、アプローチ、および期待される成果を明確に定義する。

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

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」、「デフォルト」、または「MCP」タブをクリックし、実行したい操作を選択してください。

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

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

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

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

     • HubSpot CRMレコードへの書き込み：これにより、エージェントはCRMレコードに書き込みを行うことができます。

   • MCP：モデルコンテキストプロトコル（MCP）を使用して、エージェントを外部システムに接続します。サポート対象のMCPサーバーについて詳しくはこちらをご覧ください。

ナレッジ

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

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

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

1. エージェント作成ツールで「ナレッジを追加」をクリックします（「ナレッジ」セクション）。

2. 右側のパネルで、「カスタム」、「デフォルト」、または「連携」をクリックし、該当するナレッジを選択します。

   • カスタム：ナレッジ保管場所を選択してください。ナレッジ保管場所を使用したエージェント・コンテキストの管理について、詳しくはこちらをご覧ください。

   • デフォルト：ブランドキットやICPなどのデフォルトのコンテキストから選択します。

   • 連携機能：連携機能をクリックして、対象となる項目を設定してください。

入力

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

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

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

1. エージェント作成ツールで「入力の追加」をクリックします（「入力」セクション）。
2. [ 入力タイプ ] ドロップダウンメニューをクリックし、オプション（例：CRMオブジェクト）を選択します。
3. [ ラベル ] フィールドに、入力の名前を入力してください。 

エージェントへのアクセス管理

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

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

1. エージェント作成ツールの左上にある 縦に並んだ3つのドットのアイコンをクリックし、「アクセス権の割り当て」を選択します。
2. 右側のパネルで、アクセス方法を選択してください：
   • 所有者とスーパー管理者は、編集および実行が可能です：エージェントを作成またはインストールしたユーザーと、スーパー管理者のみが、エージェントの編集および実行を行うことができます。
   • 所有者とスーパー管理者は編集でき、全員が実行できます：エージェントを作成またはインストールしたユーザーとスーパー管理者のみが、そのエージェントを編集できます。すべてのユーザーがエージェントを実行できます。
   • 誰でも編集・実行可能：どのユーザーでもエージェントを編集・実行できます。
   • チームおよびユーザーのアクセス権のカスタマイズ：指定されたユーザーおよびチームのみが、エージェントを編集または実行できます。このオプションを選択すると、追加のアクセスオプションが表示されます。
     • 実行および編集：選択されたユーザーまたはチームは、エージェントを実行および編集できます。
     • 実行：選択されたユーザーまたはチームがエージェントを実行できます。
3. 完了したら、［更新］をクリックします。

エージェント作成ツールでエージェントをテストする

HubSpotクレジットを消費することなくエージェントをテストし、出力が期待通りであることを確認してください。エージェントが正しい入力を使用し、正しいデータを参照して、期待される出力を生成しているかどうかを確認してください。 

1. 右側のパネルに、必要な入力内容を入力してください。
2. [ テストエージェント ] をクリックします。
3. ダイアログボックスで、「実行」をクリックします。
4. [ 出力 ] タブで、以下の項目の出力を確認してください：
   • エージェントが所定の形式に従っていることを確認してください。
   • エージェントは、予想されるデータと文脈を利用します。
   • 不備、不正確な点、または不明確な回答があれば特定してください。
5. 必要に応じてエージェントの設定を更新してください：
   • 説明を洗練させ、明確さや具体性を高める。
   • 関連するデータが欠落している、または不正確な場合は、ナレッジ源を修正してください。
   • 必要な情報が確実に含まれるよう、入力内容を更新してください。
6. 出力が安定し、要件を満たすようになるまで、テストを繰り返してください。その後、与信コストの見積もりを確認し、実行限度額を設定します。

見積もりされた与信コストを確認し、実行上限を設定する

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

1. エージェント作成ツールで、「実行履歴」タブをクリックします。
2. 左側のパネルで、エージェントの実行をクリックします。
3. 右側のパネルで、見積もりクレジットを確認してください。

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

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

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

1. HubSpotアカウントで、［その他］をクリックし、［エージェント］＞［Agent Hub］の順に進みます。アカウントに［その他］が表示されない場合は、［エージェント］＞［Agent Hub］に直接移動します。
2. [ エージェント ] タブをクリックします。
3. 公開したいエージェントの「編集」をクリックします。

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

他のソースからエージェントを実行する

エージェントを公開した後、ワークフローやCRMカードなど、他のソースからエージェントのトリガーを起動して実行することができます。

1. HubSpotアカウントで、［その他］をクリックし、［エージェント］＞［Agent Hub］の順に進みます。アカウントに［その他］が表示されない場合は、［エージェント］＞［Agent Hub］に直接移動します。
2. [ エージェント ] タブをクリックします。
3. 公開したいエージェントの「編集」をクリックします。
4. ワークフローまたは自動化からエージェントを実行するには、「[実行元]」セクションで「自動実行」をクリックします。次に、ワークフローまたは自動化の設定を行います。 
   • 「Starter」アカウントをお持ちの場合は、オートメーションのサイドパネルにあるオートメーションからエージェントを実行してください。Agent Hub でオートメーションを作成する方法について学びましょう。
   • ProfessionalまたはEnterpriseアカウントをお持ちの場合は、Agent Hub のワークフロービルダー内のワークフローからエージェントを実行してください。Agent Hub でワークフローを作成する方法について学びましょう。

1. CRMレコード内のCRMカードから直接エージェントを実行するには。 
   • [「～から実行」] セクションで、[ CRMカード ] をクリックします。
   • 右側のパネルで、「CRMカードに追加」をクリックし、エージェントを実行したいオブジェクトタイプを選択します。エージェントを複数のオブジェクトタイプに追加することができます。
     
     

次のステップ

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