ベータBreeze Studioでのエージェントの管理

Breeze studio を使えば、HubSpot のデータやツールを活用して、構造化されたタスクを遂行するエージェントをカスタマイズできます。これらのエージェントは、定義された入力内容や指示に基づいて、反復可能なワークフローの自動化、コンテンツの作成、およびアカウント内でのアクション実行を行うことができます。

例えば、特定の基準に基づいて企業の調査を行ったり、アウトリーチ用コンテンツを作成したり、CRMレコードを更新したりするようにエージェントを設定することができます。

に関するご注意：2026年7月13日をもって、カスタムアシスタントの提供が終了しました。既存カスタムアシスタントは読み取り専用となっており、プロジェクトへ自動的に移行されます。カスタムアシスタントのウェルカムメッセージと会話のきっかけを、プロジェクトに移行します。の手順を参照してください。

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

始める前に

Breeze Studio でエージェントの操作を始める前に、を参照して、Breezeについて、これらのツールを使用するための要件、およびその制限事項や留意点を十分に理解しておいてください。

注:Breezeの機能には、人工知能と機械学習モデルが使用されます。AIやデータの利用、セキュリティーに対するHubSpotのアプローチについては、HubSpotのAIモデルカードとHubSpotのAIクラウドインフラストラクチャーに関するよくある質問をご覧ください。

要件を理解する

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

制限事項と考慮事項について

• AI機能用にアカウントを設定する方法の概要については、 AI機能を導入するためのHubSpotアカウントの設定方法をご確認ください。
• ユーザーのアクセス権がない他のHubSpot機能(ブログ、ランディングページなど)に依存している構成の場合、ユーザーがエージェントを編集または実行する権限を持っていても、そのユーザーはエージェントを実行することができません。

エージェントをインストールする

エージェントはBreeze Marketplaceで入手可能で、Breeze Studioでさらにカスタマイズすることができます。

1. HubSpotアカウントで、［その他］をクリックし、［Breeze］＞［マーケットプレイス］に移動します。アカウントに［その他］が表示されない場合は、［Breeze］＞［マーケットプレイス］に直接移動します。
2. ページの最下部に表示される[ 全て確認]をクリックします。
3. [マーケットプレイス ]ページで、[ フィルター]をクリックします。
4. 「」エージェントタイプのドロップダウンメニューをクリックし、「」エージェントを選択します。
5. のエージェントカードをクリックしてください（例：社のリサーチエージェント）。
6. 物件一覧ページで、仲介業者の情報を確認してください： 
   • 作成者：作成者（エージェント）。
   • 概要：エージェントの機能のサマリー。サマリー全体を表示するには、［さらに表示］をクリックします。
   • 機能：エージェントで利用できる個々の機能の説明。 
   • エージェントの機能：エージェントがデフォルトで使用するツール。
   • 価格:クレジットの使用状況の説明。HubSpotクレジットと請求についてもっと詳しく。
   • 詳細情報：エージェントの作成者にサポートを依頼するためのリンクを含む、エージェントに関する追加情報。
   • フィードバック：ユーザーはエージェントに関するフィードバックを送信し、そのパフォーマンスや機能の向上に貢献することができます。
7. ［追加］をクリックします。

エージェントの管理

Breezeスタジオでエージェントを管理し、出力をカスタマイズ、実行、レビューできます。エージェントは、あらかじめ定義された入力、手順、ツール、知識を使用して動作します。また、他のタスクに対応するためにカスタマイズまたは複製することも可能です。

エージェントのカスタマイズ

担当者の入力内容、手順、ツール、ナレッジソース、自動化の設定を調整し、エージェントをカスタマイズできます。これらの構成により、エージェントの動作方法と、タスクの実行時にエージェントが使用する情報が決定されます。

1. HubSpotアカウントで、［その他］をクリックし、［Breeze］＞［Breezeスタジオ］に移動します。アカウントに［その他］が表示されない場合は、［Breeze］＞［Breezeスタジオ］に直接移動します。
2. [エージェント ]タブをクリックします。
3. のエージェントカードにカーソルを合わせ、verticalMenuIconの縦に並んだ3つのドットをクリックし、Configureを選択します。
4. ［このエージェントがユーザーから必要とするもの］セクションで、セットアップ時に必要なフィールドに入力します。[ 入力の管理 ] をクリックして、エージェント情報を提供するカスタム入力を管理します。
   
   • 右側のパネルで、[ 入力を追加]ドロップダウンメニューをクリックし、新しいカスタム入力を追加する 入力形式 を選択します。
   • 入力カードに、入力の名前と説明 を入力します。
   • エージェントの実行に入力が必要な場合は、［必須］チェックボックスをオンにします。
   • カスタム入力を再配置するには、入力カードの dragHandle ドラッグ&ドロップアイコン をクリックし、入力を新しい場所にドラッグします。
   • カスタム入力を削除するには、入力カードの[X]をクリックします。
5. [ このエージェントの動作ガイド ]セクションで、エージェントのデフォルトの手順を確認します。このフィールドは編集できません。 
6. 指示を追加するには、エージェントのトーン、構造、出力形式に関するコンテキストを[ 追加指示 ]フィールドに入力します。
7. [このエージェントでできること ]セクションでは、このエージェントがタスクを実行するために使用できるデフォルトのツールを確認します。これらのツールはHubSpotの事前構築済みエージェントから削除できません。
   • Webを参照:これにより、エージェントがWebを参照するためのアクセス権が付与されます。
   • HubSpot CRMレコードにアクセス:これにより、エージェントがCRMレコードを読み取るためのアクセス権が付与されます。
   • HubSpot CRMレコードに書き込む:これにより、エージェントがCRMレコードに書き込むためのアクセス権が付与されます。承認 approveDraftIcon アイコンをクリックして 、[ このツールを実行する前に確認 ]スイッチをオンに切り替えます。[ このツールを実行する前に確認 ]スイッチがオンになっている場合、ワークフローにCRMの更新の承認が必要になります。

9. ツールをさらに追加するには、［ツールを追加］をクリックします。Breezeスタジオのツールの使用について詳細をご確認ください。
10. [このエージェントのデータ ]セクションで、[ナレッジを追加]をクリックして、追加のコンテキストとともにナレッジボールトを追加します。Breezeスタジオでのナレッジボールトの使用について詳細をご確認ください。
11. [ このエージェントを自動化 ]セクションで、一部のエージェントは自動化をサポートしています。[このエージェントを自動化]セクションの[ トリガーを選択]をクリックして、自動化を実行するタイミングのトリガーを設定します。 

注: 自動化には、1日あたり1,000回の実行という制限があります。この制限は12:00 AM UTCにリセットされます。

12. 自動エージェント実行通知の受信者を設定するには、[ 受信者の管理]をクリックします。自動エージェント実行通知受信者の管理について詳細をご確認ください。
13. エージェントをテストするには、右側の必須フィールドに 値 を入力します。必須フィールドにはアスタリスク*が付いています。
    • ［エージェントを実行］をクリックして、エージェントの現在の設定をテストします。
    • 追加のテストを実行するには、右上の［新しいテスト］をクリックします。
14. エージェントの以前のバージョンを復元するには、左上の recentlySelectedIcon エージェント履歴 アイコンをクリックします。ポップアップボックスで、前の バージョンをクリックします。次に、右上の [復元]をクリックします。
15. 完了したら、右上の [公開 ]をクリックします。

エージェントの実行

Breezeスタジオでエージェントを実行して、設定したワークフローを実行できます。エージェントを実行すると、そのエージェントに定義された命令、入力、およびツールに基づいて出力が生成されます。

1. HubSpotアカウントで、［その他］をクリックし、［Breeze］＞［Breezeスタジオ］に移動します。アカウントに［その他］が表示されない場合は、［Breeze］＞［Breezeスタジオ］に直接移動します。
2. [エージェント ]タブをクリックします。
3. エージェントカード上で、[ ] をクリックします。を開きます。
4. エージェントの受信トレイで、エージェントの実行ごとに使用される各フィールドに、の値「」を入力してください。必須フィールドにはアスタリスク*が付いています。
5. [エージェントを実行]をクリックしてエージェントを起動します。エージェントの実行にかかる時間は、必要なタスクの複雑さによって異なります。

エージェントの出力を確認

エージェントの実行が完了したら、エージェントの実行出力とソースを確認します。また、出力をエクスポートしたり、共有したりすることも可能です。エージェントの出力を確認する方法をご覧ください。

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

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

1. HubSpotアカウントで、［その他］をクリックし、［Breeze］＞［Breezeスタジオ］に移動します。アカウントに［その他］が表示されない場合は、［Breeze］＞［Breezeスタジオ］に直接移動します。
2. [エージェント ]タブをクリックします。
3. エージェントの「」カードにカーソルを合わせ、次に「verticalMenu」の縦に並んだ3つのドットをクリックし、「Configure」を選択します。
4. エージェントビルダーで、左上の「」→「アクセス管理」をクリックします。
5. 右側のパネルで、 アクセスオプションを選択します。
   • 所有者とスーパー管理者は、を編集および実行できます。エージェントを作成またはインストールしたユーザーとスーパー管理者のみが、そのエージェントを編集および実行できます。
   • 担当者とスーパー管理者は編集が可能で、全員が担当者を編集できます:エージェントを作成またはインストールしたユーザー、およびスーパー管理者のみが編集できます。すべてのユーザーがエージェントを実行できます。
   • は誰でも編集・実行できます：どのユーザーでもエージェントを編集・実行できます。
   • のチームおよびユーザーごとのアクセス権設定：指定されたユーザーおよびチームのみが、エージェントの編集や実行を行うことができます。このオプションを選択すると、追加のアクセスオプションが表示されます。
     • の実行と編集：指定されたユーザーまたはチームは、エージェントを実行および編集できます。
     • を実行：選択したユーザーまたはチームがエージェントを実行できます。
6. 完了したら、右上の [公開]をクリックします。