/agents)を選択します。ページの見出しはエージェントです。コマンドパレット(⌘ K)からもアクセスできます。
エージェントとは
エージェントは5つの要素を組み合わせたもので、すべてが1つのリビジョンとして保存されます:
エージェントは、実行する人全員に対して、自身に添付されたファイルを読み取ります。それ以外は、実行に使用するメンバーの権限で閲覧できるものだけを読み取ります。アクションも、選択されたものだけを実行します。Hiveはペルソナとタスクのテキストを信頼できないものとして扱うため、エージェントの指示に何を書いても、権限の拡大やアクションの追加はできません。
ナレッジとしてファイルを添付する
エージェントエディタのステップ2、ナレッジとツールのファイル行には、エージェントが読み取るライブラリのファイルが表示されます(エディタの構成をご覧ください)。ファイルを追加するには、次のいずれかの方法を使用します。- + ファイルを追加を選択してライブラリ内の既存のファイルを選ぶか、同じ選択画面でファイルをアップロードを開いて新しいファイルをアップロードします。
- 同じ選択画面でGoogle Drive、OneDrive、SharePointを開き、自分で接続したアカウントからファイルを追加します。DriveとOneDriveのファイルは、最近変更されたものから名前で検索できます。また、SharePointのサイト、ドキュメントライブラリ、そのフォルダを参照できます。Google Drive、OneDrive、SharePointのファイルをご覧ください。
- コンピュータからファイル行または構築の入力欄にファイルをドラッグします。破線のファイルをドロップしてこのエージェントに追加という枠が、ドロップ先を示します。
Google Drive、OneDrive、SharePointのファイル
Google Drive、OneDrive、SharePointから追加したファイルは、ライブラリにコピーされ、アップロードしたファイルと同様に添付されます(添付済み・保持するには保存)。エージェントが読み取るのはコピーであり、元のファイルを直接読み取ることはありません。そのため、実行時に元のファイルを待ったり、元のファイルが原因で失敗したりすることはありません。オペレーター以上のロールが必要で、連携で自分自身が接続したアカウントを使用する必要があります。接続済みのアカウントがない場合は、選択画面にその旨が表示されます。 ファイル行のコピーには、コピー元とHiveが最後に確認した時刻が表示されます。たとえば、Google Driveからコピー・2時間前に確認と表示されます。更新できるのは、追加した本人だけです。- ファイルの更新を選択すると、その時点で元のファイルを確認します。
- Agent Studioでエージェントを開くと、Hiveは自分が追加したコピーのうち、最後の確認から1時間以上経過したものを確認します。
- エージェントをデプロイすると、Hiveは自分が追加したコピーを再度確認します。
エージェントのファイルを読み取れるユーザー
エージェントに添付されたファイルやフォルダは、エージェントの一部です。エージェントを共有すると、実行できるすべてのユーザーが、実行ページ、Ask、チャットで続けるでの実行時に、それらのファイルを利用できます。ライブラリでは自分しか開けないファイルも含まれます:- 実行時。 エージェントは、実行ページ、ユーザーがそのエージェントを選択したAskのチャット、チャットで続けるで、添付ファイルを読み取ります。Hiveは、エージェントの最新バージョンを保存したユーザーのライブラリへのアクセス権で読み取ります。
- 画像。 エージェントのモデルが画像を読み取れる場合(視覚モデル)、添付されたJPEG、PNG、GIF、WebPの画像は、実行ページ、Ask、エディターのテストで、画像そのものとしてモデルに渡されます。画像を読み取れないモデルには、代わりにHiveによる画像の説明が渡されます(選択したファイルをHiveが読み取る仕組みを参照)。
- チャット内。 エージェントを実行するユーザーは、そのチャットから、エージェントが使用したファイルを読み取り専用で開けます。参照元の下にあるファイル名を選択してください。PDFや画像は新しいタブで開き、それ以外のファイルはダウンロードされます。
- それ以外の場所では利用できません。 ファイルは実行者のライブラリ、その検索、Driveには追加されず、エージェントとのチャット以外の場所では開けません。Google Drive、OneDrive、SharePointで元のファイルを開けるのは、そのサービスでアクセスが許可されている場合のみです。
- エージェントからファイルを削除して保存すると、そのファイルは直ちに利用できなくなります。新しい実行では読み取られなくなり、エージェントのチャットからも開けなくなります。また、チャット内の過去の回答のうち、そのファイルを使用した回答は非表示になります。実行ページにある実行自体の結果は、実行したユーザーに引き続き表示されます。
- エージェントの最新バージョンを保存したユーザーがワークスペースを離れた場合、またはファイルのいずれかを自分で開けなくなった場合、すべてのファイルを開けるユーザーがエージェントを再び保存するまで、エージェントのファイルは、自身のライブラリでそのファイルを開けるユーザーに対してのみ読み取られます。
- ワークスペースでライブラリへのアクセスを禁止されているユーザーは、これまでどおりエージェントのファイルを利用できません。HiveのMCPサーバーに接続したAIクライアントは、エージェントの実行やチャットの閲覧ができないため、この方法でエージェントのファイルを読み取ることはありません。
エージェントを実行できる場所
デプロイ済みのエージェントはすべて、Ask、専用の実行ページ、ワークフローで利用できます。表示先を選択する必要はありません。公開リンクは別で、エディタの公開リンクから有効にします。Ask Hive
Askの入力欄にあるエージェントセレクターで、デフォルトのHiveの代わりにエージェントを選択します。
専用の実行ページ
エージェントのフォームに入力して実行し、回答を読み、過去の実行を確認します。
スケジュール
固定のプロンプトとタイムゾーンを使用して、エージェントを定期的なスケジュールで実行します。
ワークフロー
ビルダーのエージェントライブラリから、デプロイ済みのエージェントをワークフローに追加します。
公開リンク
ワークスペースでこの機能が有効になっている場合、ワークスペース外にエージェントを共有できます。
実行場所ごとにエージェントが利用できるもの
公開リンクを除くすべての実行場所で、ワークスペースの必須スキルがエージェントの指示に加わります。
ワークフローでエージェントを使用する
エージェントをデプロイしてください。デプロイ済みのリビジョンは、ワークフロービルダーのエージェントライブラリ、ステップを追加メニューのエージェント、ステップを追加パネルに表示されます。ワークフローステップは、追加時のリビジョンに固定されます。新しいリビジョンをデプロイすると、ステップにリビジョンNに更新が表示されます。 ワークフローステップがナレッジや実行の参照元として読み取れるのは、ライブラリのファイルとフォルダ、またはGoogleドキュメントのリンクのみです。そのため、エージェントライブラリでは、それ以外のナレッジ、スキル、サブエージェント、書き込みを行うコネクタ操作、またはそれ以外の参照元を持つエージェントはグレー表示され、変更が必要な箇所が示されます。ウェブアクセス、ユーザー自身のデータ(Hiveデータを含む)、読み取り専用の接続済みアプリは、ステップで利用できます。ウェブ、Hiveデータ、接続済みアプリを参照してください。選択されたアクションはステップ内で実行されます。ワークフローステップの導入前に作成されたエージェントは、再利用可能なテンプレートから再作成する必要があります。エージェントライブラリのステップを参照してください。エージェントを直接実行する
デプロイ済みのエージェントには、それぞれ/agents/<agent id>/runに専用の実行ページがあります。エージェントカードの**⋯メニューにある実行**、またはエディターのテストペインにあるこのエージェントを実行して実行履歴を表示から開けます。オペレーター以上のロールを持ち、そのエージェントの実行権限があれば利用できます。エージェントの編集権限は不要で、このページに下書きバージョンが表示されることはありません。
ページにはエージェントの名前と説明が表示され、その下にフォームが表示されます。
- フィールド: エージェントが求める入力です。
- 参照元: 今回の実行でエージェントが読み取るライブラリのファイルやフォルダ、その他の参照元です。ライブラリのファイルを指定する参照元では、選択画面のライブラリにアップロードから、まだライブラリにないファイルを追加できます。アップロードが完了すると、Hiveがそのファイルを選択します。オペレーター以上のロールが必要です。各ファイルは最大25 MBで、ライブラリが対応する種類である必要があります。ファイルはライブラリのルートに保存され、他のアップロードと同様にライブラリの共有設定に従います。
- アカウント: 接続済みアプリを操作する際に、エージェントが使用するあなたの接続済みアカウントです。
- 実行時の指示(任意): 今回の実行に関するメモです。
- 会話のきっかけ: エージェントの会話のきっかけが、**実行時の指示(任意)**の下に表示されます。選択すると実行時の指示に入力されますが、実行は開始されません。
実行によってライブラリに書き込まれるファイル
WordまたはExcelのファイルテンプレートを持つエージェントを、その実行ページから自分で実行すると、業務委託契約書や提案書など、作成対象のドキュメントやブックをライブラリ内の新しいファイルとして書き込むことができます。- あなたのファイルです。 ファイルはあなたの所有物となり、あなたとして書き込まれます。保存先はライブラリの最上位、またはエージェントに追加されたフォルダのうち、あなただけがアクセスでき、ファイルを追加できるフォルダです。他の人と共有しているフォルダやナレッジベースのフォルダは使用されないため、エージェントがあなたのために読み取った内容が、エージェントの作成者や同僚に開かれる場所に保存されることはありません。
- エージェントのテンプレートを使用します。 テンプレートを開く権限がある場合、WordファイルはエージェントのWordテンプレート、ブックはExcelテンプレートを基に作成されます。非公開のテンプレートは、作成するファイルもあなただけに公開される場合にのみ使用され、それ以外の場合はワークスペース独自のデザインが適用されます。Hiveのスターターテンプレートを使用する場合、ヘッダーとフッターの「[Company name]」と「[Firm name]」は事務所名に置き換えられます。事務所の登録情報にある名前が使われ、それがなければワークスペース名が使われます。Hiveがどちらの名前も把握していない場合、プレースホルダーはファイル内に残るため、ご自身で入力してください。
- 新しいファイルのみを作成します。 実行によって、ライブラリ内の既存ファイルが変更、置換、移動、削除されることはありません。書き込まれるファイルは最大3つで、いずれも確認用の下書きです。
- 結果に表示されます。 各ファイルは実行結果の成果物に表示され、開くからライブラリ内のファイルを開くことができます。回答にもファイルへのリンクが含まれます。
- 記録されます。 実行によって書き込まれた各ファイルは、監査ログに「エージェントの実行によりライブラリにファイルが作成されました」と記録され、エージェント、実行、ファイルの情報が含まれます。
実行履歴
フォームの下の実行履歴には、エージェントの実行が新しい順に表示されます。- 自分の実行を確認できます。ワークスペースの管理者は全員の実行を確認でき、実行者で絞り込めます。
- 各実行には開始者が表示されます。自分の実行にはあなた、他のメンバーの実行にはそのメンバーの名前、ワークスペースに所属しなくなった人の実行にはワークスペースのメンバーと表示されます。Agent Studioのエージェントページにある最近の実行リストでも、各行と、実行を開いたときの開始者に同じ情報が表示されます。
- ステータスで絞り込めます。さらに読み込むで過去の実行を表示できます。
- このページ、Ask、スケジュール、ワークフローから開始された実行と、過去に今すぐ実行で開始された実行が含まれます。
- 各実行には専用のリンクがあり、実行に関する通知からはこのページでその実行が開きます。
- 制限により停止された実行は、理由とともにブロック済みとして表示されます。理由には、ワークスペースのクレジット不足、メンバーまたはエージェントの月間上限への到達、ワークスペースが読み取り専用であることや支払いの遅延、モデルポリシーでエージェントのモデルが許可されていないことがあります。クレジットと使用状況をご覧ください。
- 質問内容と回答の冒頭が表示されるのは、自分の実行のみです。他の人の実行では、管理者が確認できるのは実行者、実行日時、開始方法、ステータスであり、質問内容、回答、グラフ、ステップは表示されません。これは実行ページ、実行履歴、エージェントページの最近の実行に適用されます。Askチャットでのエージェントの回答はそのチャットの一部なので、メンバーのチャットを閲覧できる管理者を含め、そのチャットを開ける人であれば誰でも確認できます。
- Askチャットが削除された実行は読み取り専用になります。開いて回答を読むことはできますが、続行はできません。
エージェントの閲覧と整理
一覧には、自分が所有するエージェントと自分に共有されたエージェントが表示されます。管理者はワークスペース全体のエージェントも確認できます。- 並べ替えでは、人気順、更新日時順、A – Zを選択できます。
- 各カードには、過去30日間の実行回数と最終実行日時が表示されます。今すぐ実行、スケジュールとトリガー、エージェント自身のページ、Ask、ワークフローのステップなど、どの方法による実行も集計対象です。一般のメンバーには自分が開始した実行が、管理者には全員の実行が集計されます。人気順も同じ実行回数に基づいて並べ替えます。
- 各カードには、エージェントのオーナーとして自分、または作成したメンバーの名前が表示されます。Hiveがワークスペースに設定したエージェント(ワークスペースへのおすすめを参照)では、オーナーは常にHiveと表示され、個人名は表示されません。
- ステータスで絞り込み: 稼働中、下書き、一時停止中、アーカイブ済みから選択できます。
- エージェントを検索では、名前と説明で検索できます。よく使うエージェントをピン留めすると、ピン留めしたエージェントに表示されます。
- エージェントをインポートでは、エクスポートしたエージェントを新しい下書きとして取り込めます。テンプレートを閲覧では、Hiveが作成した既成のエージェントを使って始められます(Hiveのテンプレートを参照)。+ エージェントを作成ではビルダーが開き、エージェントに実行させたい内容を文字または音声で入力できます(新しいエージェントの作成を開始を参照)。
- タブにまだエージェントがない場合は、その旨が表示されます。エージェントを作成できるロールであれば、エージェントを作成も表示されます。検索や絞り込みで該当するエージェントがない場合は、代わりに検索条件や絞り込みを解除するよう案内されます。
エージェントカードのクイック操作
各エージェントカードには**⋯**メニューがあり、エージェントを開かずに操作できます。エージェントのステータス
ロールごとにできること
Agent Studioはワークスペースのロールに従います(ロールと権限を参照):- エージェントを作成: 部門リード、管理者、オーナーが作成できます。それ以外のメンバーには「エージェントを作成できるのはリード、管理者、オーナーのみです」と表示されます。Starterでは、全メンバーのエージェントを合算して、アーカイブされていないエージェントをワークスペース内に3つまで保持できます。Team以上には固定の上限はありません。上限に達すると、それ以上の作成やコピーは拒否されます。また、ダウングレードなどでプランの上限を超えたワークスペースでは、一部をアーカイブするまでエージェントをデプロイできません。
- エージェントを実行: オペレーター以上のロールに加え、そのエージェントの実行権限が必要です。
- エージェントを削除: 部門リード以上のロールが必要です。
- ワークスペースのエージェント設定を管理: 管理者以上のロールが必要です。
- 共有: エージェントは、オーナーが指定した共同作業者と共有するまで、オーナーだけが利用できます。エージェントを共有しても、オーナーの接続済みアカウントが共有されることはありません。ただし、実行権限を持つ全員が、実行ページ、Ask、「チャットで続ける」でエージェントを実行する際に、そのエージェントに添付されたファイルを利用できます。また、ライブラリに追加しなくても、エージェントのチャットからそれらのファイルを開けます。エージェントのファイルを閲覧できるユーザーを参照してください。Askのチャットでエージェントが返した回答には、そのチャットの共有相手全員に対して、引き続きエージェントの名前とアイコンが表示されます。Askでエージェントを使うを参照してください。
組み込みの安全対策
エージェントのアクションには、次のルールが適用されます:- 選択されたアクションはアカウントのレベルに従います。 エージェントで選択されたアクションは、メンバー自身のアカウントから実行されます。ワークスペースの上限を適用したうえで、そのアカウントのレベルによって動作が決まります。実行では即座に実行され、下書きでは承認カードで承認を待ち、読み取りではアクションを実行せず、その旨を回答に記載します。メンバー、スケジュール、アプリのイベント、シグナルのいずれによって開始された実行でも同じです。エージェントとワークフローが自律的に行うことを参照してください。
- アクションの送信先。 宛先、チャンネル、電話番号、リンクが、エージェントの指示や、その実行のためにメンバーがHiveに入力した内容に由来しないアクションは、実行されず、そのメンバーの承認をカードで待ちます。たとえば、エージェントが読み取ったメール内で見つけたアドレスが該当します。カードはチャット内、またはそのメンバーのシグナルページの判断を確認に表示されます。スケジュールに保存された入力は、誰かが自分で入力した言葉とはみなされません。エージェントに使用を許可するアドレス、チャンネル、リンクは、自分で指示に記載してください。内容を記述と作成チャットは、あなたが保存したものや説明に入力したもの以外を追加せず、代わりにその旨を伝えます(エージェントを作成を参照)。アクションの送信先を参照してください。
- アクションの有効・無効。 ステップ3の入力と出力で、詳細設定の許可する操作を読み取りと回答のみに設定すると、エージェントはアクションを一切実行しません。
- 選択されたアクションのみ。 エージェントが実行するのは、追加されたアプリで選択されているアクションだけです。それ以外のアクションは、アカウントに到達する前にHiveが拒否します。アプリごとにアクションを選択する仕組みが導入される前に設定されたエージェントは、アクションを選択するまで何も実行しません。
- すべての実行者が利用するMCPツール。 選択されたMCPツールは、実行者自身の同じサーバーへの接続で実行されます。その接続がない実行者には、サーバーへの接続を求める案内が表示されます(Hiveがそのツールを読み込めなかった場合は、読み込めなかった旨が表示されます)。同じサーバーへの接続が2つある実行者には、一方の接続を解除するよう案内されます。選択後にサーバー側で変更されたツールは拒否され、作成者にAgent Studioで再選択を求めるメッセージが表示されます。また、作成者自身の接続でのみ選択されているツールがあれば、回答にその旨が記載されます。新たに選択できるのは、編集者が接続しているサーバーのツールだけです。
- 予算。 実行時間、モデル呼び出し、アクションステップ、外部への書き込み、トークンには厳格な上限があります。1回の実行のターン数はモデル呼び出し予算以下で、16回を超えることはありません。新しいエージェントにはHiveの既定値(モデル呼び出し8回)が適用されます。複数のツールを連鎖させるテンプレートから作成したエージェントには、それより多い回数が設定されます。エージェントの最初のアクションを選択すると、1回の実行につき外部への書き込みが1回許可されます。以前に作成されたエージェントは、保存時の予算を維持します。書き込み予算を超えると、Hiveはそれ以降のアクションを拒否します。送信先を理由に承認を待つアクションは、書き込み予算を消費しませんが、その実行のアクションステップ1回分として数えられます。さらに、プランで定められた1回の実行あたりのトークン上限が、Askでも適用されます。
- ワークスペースの制限。 アクションには、1時間あたりのアクション上限と支出上限も引き続き適用されます。これらの制限に達したアクションは拒否され、エージェントが理由を伝えます。
- クレジット。 エージェントによるモデルの処理は、ここで実行する場合も、スケジュールで実行する場合も、Askで誰かが質問する場合も、AIクレジットを消費します。Businessでは、実行するメンバーのクレジットを使用します(スケジュール実行ではスケジュールのオーナー、公開リンクでは公開者)。そのメンバー自身のクレジットと追加購入の上限を除き、エージェントごとの月間上限はありません。旧プランでは、ワークスペースの共有枠を使用し、エージェントごとの月間上限はStarterとTeamで2,000クレジット、BusinessとEnterpriseで10,000クレジットです。エージェントのトークン予算を既定値より増やした場合、Hiveが£5(旧プランでは500クレジット)を超えると見積もった実行には、開始前に確認を求めます。既定の予算のエージェントでは、確認を求めることはありません。デプロイダイアログには、エージェントの稼働開始前に、1回の実行にかかる推定最大費用が表示されます。Businessではポンド、旧プランではクレジットで表示されます。クレジットが不足したスケジュール実行やイベント起点の実行は、クレジットが利用可能になるまで最大72時間待機します。Agent Studioのエージェントのカードには、1件の実行がクレジット待ち(または該当件数)と表示され、72時間待機した実行がある場合は**クレジットが回復したら実行しますか?**と表示されます(クレジット待ちを参照)。
- 繰り返しの失敗。 同じアカウントで1時間以内に3回失敗したアクションは、そのアカウントでのみ一時停止され、エージェントが停止期限を伝えます。アカウントを再接続すると、一時停止が解除されます。アクションの失敗が続く場合を参照してください。
- 外部のコンテンツ。 アプリのイベント(新着メール、新規案件)で開始されたエージェントは、ワークスペース外の人が書いた内容を読み取ったうえで、アクションを実行します。その内容から取得したアドレス、チャンネル、リンクに送信するアクションは承認を待ちますが、ヘルプデスクのチケットへの返信、請求書の送信や無効化、連絡先の削除など、既存のレコードに対するアクションは、この仕組みでは保留されません。こうした内容に基づいて実行してもよいアクションだけを選択し、書き込み予算は少なく設定してください。
- 緊急停止スイッチ。 管理者が緊急停止スイッチを有効にすると、エージェントも他のすべての機能と同様にアクションを停止します。すでに進行中の実行やテストは、アクションの実行、Hive外部へのアクセス(ウェブ検索や接続済みアプリ)、回答の保存のいずれかを行う前に停止します。それまでは追加のモデル呼び出しが行われ、通常どおり課金される場合がありますが、生成された内容は保存も配信もされません。エージェントの一時停止、アーカイブ、デプロイの解除、または実行を開始した人の削除(もしくはオペレーター未満のロールへの変更)でも、進行中の実行は同じタイミングで停止します。
- 実行記録。 完了したアクションは監査ログに記録されます。
再利用可能なメンバーエージェントは既定で無効です。Hiveがワークスペースで有効にした場合にのみ表示されます。公開エージェントリンクは、すべてのワークスペースで利用できます。公開エージェントリンクを参照してください。
制限の一覧
すべての制限については、制限リファレンスをご覧ください。
関連情報
エージェントを作成
最初のエージェントの内容を記述し、設定、テスト、デプロイを行います。
公開と評価
分析、フィードバック、スケジュール、公開リンク。