> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Agent Studioの概要

> Business Brainとライブラリを参照し、選択した操作だけを行う専門AIエージェントを作成して、Ask、スケジュール、ワークフローで使用できます。

Agent Studioでは、**ビジネスブレインに基づき、設定したルールに従う、特定の業務向けに構成した専門エージェント**を作成できます。Ask Hiveは汎用アシスタントです。一方、エージェントは、保存され、バージョン管理された専門アシスタントです。たとえば、あなたの文体で支払いを督促する担当、テンプレートを把握している提案書作成担当、特定の共有受信トレイの仕分けを行うアシスタントなどがあります。

サイドバーで、**ワークフロー**のすぐ上にある**Agent Studio**（`/agents`）を選択します。ページの見出しは**エージェント**です。コマンドパレット（<kbd>⌘</kbd> <kbd>K</kbd>）からもアクセスできます。

## エージェントとは

エージェントは5つの要素を組み合わせたもので、すべてが1つの**リビジョン**として保存されます：

| 要素 | 制御する内容 |
| - | - |
| **指示** | 普段使う言葉で記述した、エージェントの仕事、ペルソナ、目標です。 |
| **入力** | エージェントの開始方法です。自由記述の**プロンプト**（デフォルト）、**Hiveが選択**、または型付きフィールドを備えた構造化された**フォーム**から選べます。 |
| **ナレッジ** | 読み取りを許可するライブラリのファイルとフォルダです。エージェントを実行できる人は全員、実行ページ、Ask、または「チャットで続行」で実行する際に、これらのファイルを利用できます。自分しか開けないファイルも対象です。[エージェントのファイルを読み取れる人](#who-can-read-an-agents-files)を参照してください。合計約50,000トークンまでは、ファイル全体がモデルに渡されます。それを超えると、エージェントは一覧（名前、日付、冒頭の数行）を受け取り、必要なファイルを1つずつ開きます。これは、エージェントの実行、Askでの質問への応答、他のエージェントからのタスクの引き継ぎ、ワークフローのステップ、下書きのテスト、および[公開リンク](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links)で適用されます。公開リンクでは、1回に開く内容の量がさらに少なくなります。[フルテスト](https://docs.get-hive.ai/agents/build-an-agent.md)では、引き続きファイル全体を読み取ります。紐付けられたスプレッドシート（CSV、TSV、Excel）の合計、平均、件数などの集計値は、モデルによる推定ではなく、すべての行を対象に正確に計算されます。[選択したファイルをHiveが読み取る仕組み](https://docs.get-hive.ai/ja/library/library.md#how-hive-reads-the-files-you-choose)を参照してください。 |
| **連携** | エージェントが使用する接続済みアプリです。接続したアプリの読み取りは常に可能で、アクションは、Gmailの**メールを送信**やHubSpotの**案件を作成**など、有効にしたものだけを実行します。有効な各アクションには、\*\*このエージェントを実行すると自動的に実行されます。\*\*と表示されます。 |
| **エージェントの動作** | **許可する操作**（**読み取りと回答のみ**または**アプリで操作を実行可能**）、実行者自身のどのデータを読み取れるか（**実行者自身のデータ**）、**ウェブを検索**、**画像を作成**、**創造性**（**正確**、**バランス**、**創造的**）、および**クレジットまたは上限に達した場合**の動作です。 |

エージェントは、実行する人全員に対して、自身に添付されたファイルを読み取ります。それ以外は、実行に使用するメンバーの権限で閲覧できるものだけを読み取ります。アクションも、選択されたものだけを実行します。Hiveはペルソナとタスクのテキストを信頼できないものとして扱うため、エージェントの指示に何を書いても、権限の拡大やアクションの追加はできません。

### ナレッジとしてファイルを添付する

エージェントエディタのステップ2、**ナレッジとツール**の**ファイル**行には、エージェントが読み取るライブラリのファイルが表示されます（[エディタの構成](https://docs.get-hive.ai/agents/build-an-agent.md#how-the-editor-is-laid-out)をご覧ください）。ファイルを追加するには、次のいずれかの方法を使用します。

* **+ ファイルを追加**を選択してライブラリ内の既存のファイルを選ぶか、同じ選択画面で**ファイルをアップロード**を開いて新しいファイルをアップロードします。
* 同じ選択画面で**Google Drive、OneDrive、SharePoint**を開き、自分で接続したアカウントからファイルを追加します。DriveとOneDriveのファイルは、最近変更されたものから名前で検索できます。また、SharePointのサイト、ドキュメントライブラリ、そのフォルダを参照できます。[Google Drive、OneDrive、SharePointのファイル](#files-from-google-drive-onedrive-and-sharepoint)をご覧ください。
* コンピュータから**ファイル**行または**構築**の入力欄にファイルをドラッグします。破線の**ファイルをドロップしてこのエージェントに追加**という枠が、ドロップ先を示します。

アップロードしたファイルはライブラリに非公開ファイルとして保存され、通常のチェックが行われます。一度にアップロードできるのは10ファイルまでで、それぞれ対応する形式で、サイズが25 MB以下である必要があります。アップロードにはオペレーター以上のロールが必要です。

各アップロードはすぐに**ファイル**行に表示されます。Hiveが内容を読み取っている間は**処理中…**、エージェントで利用可能になると**添付済み・保持するには保存**と表示されます。エージェントを保存（**下書きを保存**、公開中のエージェントの場合は**変更を公開**）すると、新しいリビジョンの一部として添付が保持されます。それまでは、**変更を破棄**すると添付が解除されますが、ファイル自体はライブラリに残ります。アップロードに失敗した場合、ファイルのチップに理由とともに**再試行**と**削除**が表示されます。10分経っても処理が完了しない場合や、Hiveがファイルの状態を10回連続で確認できなかった場合も同様です。

**ファイル**行でファイル名を選択すると、ライブラリと同じプレビューで開きます。WordやPowerPointのファイルは[ページ](https://docs.get-hive.ai/ja/library/library.md#pages-and-text)表示で開き、ワンクリックで**テキスト**に切り替えられます。プレビューには自分のライブラリのアクセス権が適用されるため、ライブラリで開けないファイルには、ここでも開く操作は表示されず、添付を解除する\*\*×\*\*だけが表示されます。ファイルを開いてもエージェントは変更されません。

### Google Drive、OneDrive、SharePointのファイル

Google Drive、OneDrive、SharePointから追加したファイルは、ライブラリに**コピー**され、アップロードしたファイルと同様に添付されます（**添付済み・保持するには保存**）。エージェントが読み取るのはコピーであり、元のファイルを直接読み取ることはありません。そのため、実行時に元のファイルを待ったり、元のファイルが原因で失敗したりすることはありません。オペレーター以上のロールが必要で、[連携](https://docs.get-hive.ai/ja/integrations/overview.md)で自分自身が接続したアカウントを使用する必要があります。接続済みのアカウントがない場合は、選択画面にその旨が表示されます。

**ファイル**行のコピーには、コピー元とHiveが最後に確認した時刻が表示されます。たとえば、**Google Driveからコピー・2時間前に確認**と表示されます。更新できるのは、追加した本人だけです。

* ファイルの**更新**を選択すると、その時点で元のファイルを確認します。
* Agent Studioでエージェントを開くと、Hiveは自分が追加したコピーのうち、最後の確認から1時間以上経過したものを確認します。
* エージェントをデプロイすると、Hiveは自分が追加したコピーを再度確認します。

バックグラウンドでの確認は行われず、他の人がエージェントを開いても確認は開始されません。元のファイルが変更されている場合、Hiveは再度コピーし、以前の内容をファイルのバージョン履歴に保存します。ライブラリのファイルを編集した場合と同様に、デプロイ済みのバージョンを含め、エージェントは新しい内容をすぐに使用します。確認時に元のファイルにアクセスできなくても、コピーは引き続き使用でき、**ファイル**行に**更新できませんでした：Google Driveを再接続してください**などの理由が表示されます。[Google Drive、OneDrive、SharePointからコピーしたファイル](https://docs.get-hive.ai/ja/library/library.md#files-copied-from-google-drive-onedrive-and-sharepoint)をご覧ください。

### エージェントのファイルを読み取れるユーザー

エージェントに添付されたファイルやフォルダは、エージェントの一部です。エージェントを共有すると、実行できるすべてのユーザーが、実行ページ、Ask、**チャットで続ける**での実行時に、それらのファイルを利用できます。ライブラリでは自分しか開けないファイルも含まれます：

* **実行時。** エージェントは、実行ページ、ユーザーがそのエージェントを選択したAskのチャット、**チャットで続ける**で、添付ファイルを読み取ります。Hiveは、エージェントの最新バージョンを保存したユーザーのライブラリへのアクセス権で読み取ります。
* **画像。** エージェントのモデルが画像を読み取れる場合（視覚モデル）、添付されたJPEG、PNG、GIF、WebPの画像は、実行ページ、Ask、エディターの**テスト**で、画像そのものとしてモデルに渡されます。画像を読み取れないモデルには、代わりにHiveによる画像の説明が渡されます（[選択したファイルをHiveが読み取る仕組み](https://docs.get-hive.ai/ja/library/library.md#how-hive-reads-the-files-you-choose)を参照）。
* **チャット内。** エージェントを実行するユーザーは、そのチャットから、エージェントが使用したファイルを読み取り専用で開けます。**参照元**の下にあるファイル名を選択してください。PDFや画像は新しいタブで開き、それ以外のファイルはダウンロードされます。
* **それ以外の場所では利用できません。** ファイルは実行者のライブラリ、その検索、Driveには追加されず、エージェントとのチャット以外の場所では開けません。Google Drive、OneDrive、SharePointで元のファイルを開けるのは、そのサービスでアクセスが許可されている場合のみです。
* エージェントから**ファイルを削除**して保存すると、そのファイルは直ちに利用できなくなります。新しい実行では読み取られなくなり、エージェントのチャットからも開けなくなります。また、チャット内の過去の回答のうち、そのファイルを使用した回答は非表示になります。実行ページにある実行自体の結果は、実行したユーザーに引き続き表示されます。
* エージェントの最新バージョンを保存したユーザーがワークスペースを離れた場合、またはファイルのいずれかを自分で開けなくなった場合、すべてのファイルを開けるユーザーがエージェントを再び保存するまで、エージェントのファイルは、自身のライブラリでそのファイルを開けるユーザーに対してのみ読み取られます。
* ワークスペースでライブラリへのアクセスを禁止されているユーザーは、これまでどおりエージェントのファイルを利用できません。[HiveのMCPサーバー](https://docs.get-hive.ai/developers/mcp-server.md)に接続したAIクライアントは、エージェントの実行やチャットの閲覧ができないため、この方法でエージェントのファイルを読み取ることはありません。

ユーザーが1回の実行用に選択したファイル（実行の参照元、またはフォームフィールド内のファイル）は、引き続きそのユーザー自身のアクセス権で読み取られます。別のエージェントからタスクを引き渡されたエージェントのファイルや、**今すぐ実行**、スケジュール、シグナルからの引き継ぎによって開始された実行のファイルも同様です。ワークフローのステップでは、ワークフローの実行主体となるメンバーの権限でエージェントのファイルを読み取り、[公開リンク](https://docs.get-hive.ai/agents/publish-and-evaluate.md)では、公開したユーザーの権限で読み取ります。

## エージェントを実行できる場所

デプロイ済みのエージェントはすべて、Ask、[専用の実行ページ](#run-an-agent-directly)、ワークフローで利用できます。表示先を選択する必要はありません。公開リンクは別で、エディタの**公開リンク**から有効にします。

> [card] [Ask Hive](https://docs.get-hive.ai/ja/ask/ask-hive.md)
>
> Askの入力欄にあるエージェントセレクターで、デフォルトのHiveの代わりにエージェントを選択します。

> [card] [専用の実行ページ](#run-an-agent-directly)
>
> エージェントのフォームに入力して実行し、回答を読み、過去の実行を確認します。

> [card] [スケジュール](https://docs.get-hive.ai/admin/scheduled-tasks.md)
>
> 固定のプロンプトとタイムゾーンを使用して、エージェントを定期的なスケジュールで実行します。

> [card] [ワークフロー](https://docs.get-hive.ai/workflows/workflow-steps.md)
>
> ビルダーのエージェントライブラリから、デプロイ済みのエージェントをワークフローに追加します。

> [card] [公開リンク](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> ワークスペースでこの機能が有効になっている場合、ワークスペース外にエージェントを共有できます。

### 実行場所ごとにエージェントが利用できるもの

| 実行場所 | 読み取れるもの | アクション |
| - | - | - |
| Askのチャット | エージェントの[添付ファイル](#who-can-read-an-agents-files)に加え、**本人のデータ**で宣言されているメンバーデータと追加されたアプリを、あなたの権限で読み取れます。許可されている場合はウェブも利用できます。**ビジネスブレイン**、**グラフ**、**画像**ツールと、開いているファイルも、その範囲内で利用できます。 | 選択されたアクションを、あなた自身のアカウントから、各アカウントのレベルで許可される範囲で実行します。ワークスペースの上限も適用されます。**実行**では即座に、**下書き**ではあなたの承認後に実行し、**読み取り**では実行しません（承認カードはチャットに表示されます）。**実行**でも、宛先、チャンネル、番号、リンクがエージェントの指示やあなた自身のメッセージに由来しないアクションは、チャットであなたの承認を待ちます。実行した内容は回答に記載されます。 |
| 実行のセットアップ（専用のAskチャット、または専用ページのフォーム） | エージェントの[添付ファイル](#who-can-read-an-agents-files)に加え、あなたが選択した実行の参照元、**本人のデータ**で宣言されているメンバーデータ、追加され接続されたアプリを、あなたの権限で読み取れます。許可されている場合はウェブも利用できます。 | 選択されたアクションを、あなた自身のアカウントから、各アカウントのレベルで許可される範囲で実行します。ワークスペースの上限も適用されます。**実行**では即座に、**下書き**ではあなたの承認後に実行し、**読み取り**では実行しません。アクションは実行に記録され、1回の実行につき最大5件です。**実行**でも、宛先、チャンネル、番号、リンクがエージェントの指示や実行用にあなたが入力した内容に由来しないアクションは、あなたの承認を待ちます。WordまたはExcelのファイルテンプレートを使用する場合は、[ライブラリに新しいファイル](#files-a-run-writes-to-your-library)を最大3つ作成できます。 |
| ワークフローのステップ | エージェントのナレッジと実行の参照元、**本人のデータ**で宣言されているメンバーデータ、追加され接続されたアプリを、ワークフローの実行主体となるメンバーの権限で読み取れます。許可されている場合はウェブも利用できます。ウェブ検索には、ステップが読み取ったあらゆる情報が含まれる可能性があり、その情報はHiveの検索プロバイダーに送信されます。 | 選択されたアクションを、そのメンバーのアカウントから、各アカウントのレベルで許可される範囲で実行します。ワークスペースの上限も適用されます。**実行**では即座に、**下書き**では承認後に実行し、**読み取り**では実行しません。1ステップにつき最大5件です。**実行**でも、宛先、チャンネル、番号、リンクがエージェントの指示やステップに入力された固定値に由来しないアクションは、承認を待ちます。 |
| 公開リンク | エージェント自身のナレッジと訪問者のメッセージのみです。 | ありません。 |

公開リンクを除くすべての実行場所で、ワークスペースの[必須スキル](https://docs.get-hive.ai/skills/skills.md#how-hive-uses-skills)がエージェントの指示に加わります。

### ワークフローでエージェントを使用する

エージェントをデプロイしてください。デプロイ済みのリビジョンは、ワークフロービルダーの**エージェントライブラリ**、**ステップを追加**メニューの**エージェント**、**ステップを追加**パネルに表示されます。ワークフローステップは、追加時のリビジョンに固定されます。新しいリビジョンをデプロイすると、ステップに**リビジョンNに更新**が表示されます。

ワークフローステップがナレッジや実行の参照元として読み取れるのは、ライブラリのファイルとフォルダ、またはGoogleドキュメントのリンクのみです。そのため、エージェントライブラリでは、それ以外のナレッジ、スキル、サブエージェント、書き込みを行うコネクタ操作、またはそれ以外の参照元を持つエージェントはグレー表示され、変更が必要な箇所が示されます。ウェブアクセス、**ユーザー自身のデータ**（Hiveデータを含む）、読み取り専用の接続済みアプリは、ステップで利用できます。[ウェブ、Hiveデータ、接続済みアプリ](https://docs.get-hive.ai/workflows/workflow-steps.md#web-hive-data-and-connected-apps-in-an-agent-library-step)を参照してください。選択されたアクションはステップ内で実行されます。ワークフローステップの導入前に作成されたエージェントは、再利用可能なテンプレートから再作成する必要があります。[エージェントライブラリのステップ](https://docs.get-hive.ai/workflows/workflow-steps.md#agent-library)を参照してください。

## エージェントを直接実行する

デプロイ済みのエージェントには、それぞれ`/agents/<agent id>/run`に専用の実行ページがあります。エージェントカードの\*\*⋯**メニューにある**実行\*\*、またはエディターの**テスト**ペインにある**このエージェントを実行して実行履歴を表示**から開けます。オペレーター以上のロールを持ち、そのエージェントの実行権限があれば利用できます。エージェントの編集権限は不要で、このページに下書きバージョンが表示されることはありません。

ページにはエージェントの名前と説明が表示され、その下にフォームが表示されます。

* **フィールド：** エージェントが求める入力です。
* **参照元：** 今回の実行でエージェントが読み取るライブラリのファイルやフォルダ、その他の参照元です。ライブラリのファイルを指定する参照元では、選択画面の**ライブラリにアップロード**から、まだライブラリにないファイルを追加できます。アップロードが完了すると、Hiveがそのファイルを選択します。オペレーター以上のロールが必要です。各ファイルは最大25 MBで、[ライブラリ](https://docs.get-hive.ai/ja/library/library.md)が対応する種類である必要があります。ファイルはライブラリのルートに保存され、他のアップロードと同様にライブラリの共有設定に従います。
* **アカウント：** 接続済みアプリを操作する際に、エージェントが使用するあなたの接続済みアカウントです。
* **実行時の指示（任意）：** 今回の実行に関するメモです。
* **会話のきっかけ：** エージェントの会話のきっかけが、\*\*実行時の指示（任意）\*\*の下に表示されます。選択すると実行時の指示に入力されますが、実行は開始されません。

実行セットアップの導入前に保存された古いエージェントには、代わりに簡略化されたフォームが表示されます。フィールド、**実行時の指示（任意）**、**今すぐ実行**のみが表示され、アップロードや「チャットで続ける」はありません。

**実行**を選択します。フォームの下に回答が最初に表示され、参照元と作成されたファイルはその下に折りたたまれて表示されます。実行時の指示で「地域別の売上をグラフにする」などとグラフを求めると、エージェントは添付されたスプレッドシート、読み取ったスプレッドシート、またはあなたが入力した数値からグラフを作成します。[データを視覚化する](https://docs.get-hive.ai/ask/tools-and-modes.md)と同様に、グラフは回答とともに表示・保存され、その下に参照元の名前が表示されます。Agent Studioから開始された実行（**今すぐ実行**、スケジュール、アプリのイベント、シグナル、別のエージェントによる実行）でも、作成されたグラフが最大4つ保持され、実行を開くと回答の下に表示されます。サンプルの数値から作成されたグラフにはサンプルデータであることが明記され、回答にもその旨が記載されます。グラフの表示や非表示は、実行の回答とまったく同じ扱いになります。エージェントが追加のやり取りを許可している場合、**チャットで続ける**を選択すると実行がAskチャットとして開き、過去の回答を最大50件踏まえて会話を続けられます。それ以降は、新しいセッションを開始するようHiveから案内されます。許可していない場合は、1回の実行につき1つの回答が返されます。新しい質問をするには、再度実行してください。

**実行**を選択すると、すぐに実行が開始されます。Hiveは、エージェントが回答を作成する時点のあなたのアクセス権で、参照元を1回読み取ります。参照元を開けなくなっている場合、実行は失敗し、その旨が表示されます。ワークフローで保存済みエージェントを使用するステップも同じように動作します。送信先を理由に保留されたアクションがある場合は、**シグナル**ページの**判断を確認**であなたの承認を待っている件数が、回答に記載されます。

### 実行によってライブラリに書き込まれるファイル

WordまたはExcelの[ファイルテンプレート](https://docs.get-hive.ai/agents/build-an-agent.md#ground-it-in-your-knowledge)を持つエージェントを、その実行ページから自分で実行すると、業務委託契約書や提案書など、作成対象のドキュメントやブックを**ライブラリ内の新しいファイル**として書き込むことができます。

* **あなたのファイルです。** ファイルはあなたの所有物となり、あなたとして書き込まれます。保存先はライブラリの最上位、またはエージェントに追加されたフォルダのうち、あなただけがアクセスでき、ファイルを追加できるフォルダです。他の人と共有しているフォルダやナレッジベースのフォルダは使用されないため、エージェントがあなたのために読み取った内容が、エージェントの作成者や同僚に開かれる場所に保存されることはありません。
* **エージェントのテンプレートを使用します。** テンプレートを開く権限がある場合、WordファイルはエージェントのWordテンプレート、ブックはExcelテンプレートを基に作成されます。非公開のテンプレートは、作成するファイルもあなただけに公開される場合にのみ使用され、それ以外の場合はワークスペース独自のデザインが適用されます。Hiveのスターターテンプレートを使用する場合、ヘッダーとフッターの「\[Company name]」と「\[Firm name]」は事務所名に置き換えられます。事務所の登録情報にある名前が使われ、それがなければワークスペース名が使われます。Hiveがどちらの名前も把握していない場合、プレースホルダーはファイル内に残るため、ご自身で入力してください。
* **新しいファイルのみを作成します。** 実行によって、ライブラリ内の既存ファイルが変更、置換、移動、削除されることはありません。書き込まれるファイルは最大3つで、いずれも確認用の下書きです。
* **結果に表示されます。** 各ファイルは実行結果の**成果物**に表示され、**開く**からライブラリ内のファイルを開くことができます。回答にもファイルへのリンクが含まれます。
* **記録されます。** 実行によって書き込まれた各ファイルは、[監査ログ](https://docs.get-hive.ai/approvals/audit-log.md)に「エージェントの実行によりライブラリにファイルが作成されました」と記録され、エージェント、実行、ファイルの情報が含まれます。

ワークフローのステップの実行（スケジュール実行やアプリのイベントによる実行を含む）、作成者による**テスト**、[公開リンク](https://docs.get-hive.ai/agents/publish-and-evaluate.md)では、ファイルは書き込まれません。ワークフローからPDFを保存するには、ワークフローの[PDFを作成](https://docs.get-hive.ai/workflows/workflow-steps.md#create-pdf)ステップを使用してください。他のファイルを追加する場合と同様に、オペレーターロール以上とライブラリへのアクセス権が必要です。

エージェントのAIモデルが実行の途中で失敗した場合、実行には、失敗したモデル、AIプロバイダーから報告された内容（リクエストが拒否されたこと、HTTPステータス、プロバイダーのエラーコードなど）、次に行うべき対応が表示されます。プロバイダーが混雑している場合は時間をおいて再試行し、安全性フィルターによってブロックされた場合はリクエストを変更します。プロバイダーによる拒否が続く場合は再試行し、その後エージェントの設定で別のモデルを選択します。同じメッセージがAgent Studio、Ask、ワークフローの保存済みエージェントのステップに表示されます。

### 実行履歴

フォームの下の**実行履歴**には、エージェントの実行が新しい順に表示されます。

* 自分の実行を確認できます。ワークスペースの管理者は全員の実行を確認でき、実行者で絞り込めます。
* 各実行には開始者が表示されます。自分の実行には**あなた**、他のメンバーの実行にはそのメンバーの名前、ワークスペースに所属しなくなった人の実行には**ワークスペースのメンバー**と表示されます。Agent Studioのエージェントページにある**最近の実行**リストでも、各行と、実行を開いたときの**開始者**に同じ情報が表示されます。
* ステータスで絞り込めます。**さらに読み込む**で過去の実行を表示できます。
* このページ、Ask、スケジュール、ワークフローから開始された実行と、過去に**今すぐ実行**で開始された実行が含まれます。
* 各実行には専用のリンクがあり、実行に関する通知からはこのページでその実行が開きます。
* 制限により停止された実行は、理由とともにブロック済みとして表示されます。理由には、ワークスペースのクレジット不足、メンバーまたはエージェントの月間上限への到達、ワークスペースが読み取り専用であることや支払いの遅延、モデルポリシーでエージェントのモデルが許可されていないことがあります。[クレジットと使用状況](https://docs.get-hive.ai/admin/credits-and-usage.md)をご覧ください。
* 質問内容と回答の冒頭が表示されるのは、自分の実行のみです。他の人の実行では、管理者が確認できるのは実行者、実行日時、開始方法、ステータスであり、質問内容、回答、グラフ、ステップは表示されません。これは実行ページ、実行履歴、エージェントページの最近の実行に適用されます。Askチャットでのエージェントの回答はそのチャットの一部なので、メンバーのチャットを閲覧できる管理者を含め、そのチャットを開ける人であれば誰でも確認できます。
* Askチャットが削除された実行は読み取り専用になります。開いて回答を読むことはできますが、続行はできません。

## エージェントの閲覧と整理

一覧には、自分が所有するエージェントと自分に共有されたエージェントが表示されます。管理者はワークスペース全体のエージェントも確認できます。

* **並べ替え**では、**人気順**、**更新日時順**、**A – Z**を選択できます。
* 各カードには、過去30日間の実行回数と最終実行日時が表示されます。**今すぐ実行**、スケジュールとトリガー、エージェント自身のページ、Ask、ワークフローのステップなど、どの方法による実行も集計対象です。一般のメンバーには自分が開始した実行が、管理者には全員の実行が集計されます。**人気順**も同じ実行回数に基づいて並べ替えます。
* 各カードには、エージェントのオーナーとして**自分**、または作成したメンバーの名前が表示されます。Hiveがワークスペースに設定したエージェント（[ワークスペースへのおすすめ](https://docs.get-hive.ai/ja/get-started/inbox.md#suggested-for-your-workspace)を参照）では、オーナーは常に**Hive**と表示され、個人名は表示されません。
* **ステータスで絞り込み：** **稼働中**、**下書き**、**一時停止中**、**アーカイブ済み**から選択できます。
* **エージェントを検索**では、名前と説明で検索できます。よく使うエージェントをピン留めすると、**ピン留めしたエージェント**に表示されます。
* **エージェントをインポート**では、エクスポートしたエージェントを新しい下書きとして取り込めます。**テンプレートを閲覧**では、Hiveが作成した既成のエージェントを使って始められます（[Hiveのテンプレート](https://docs.get-hive.ai/agents/build-an-agent.md#templates-by-hive)を参照）。**+ エージェントを作成**ではビルダーが開き、エージェントに実行させたい内容を文字または音声で入力できます（[新しいエージェントの作成を開始](https://docs.get-hive.ai/agents/build-an-agent.md#start-a-new-agent)を参照）。
* タブにまだエージェントがない場合は、その旨が表示されます。エージェントを作成できるロールであれば、**エージェントを作成**も表示されます。検索や絞り込みで該当するエージェントがない場合は、代わりに検索条件や絞り込みを解除するよう案内されます。

### エージェントカードのクイック操作

各エージェントカードには\*\*⋯\*\*メニューがあり、エージェントを開かずに操作できます。

| 操作 | 内容 | 表示される対象者 |
| - | - | - |
| **編集** / **開く** | エージェントを開きます。編集権限のあるオーナーと管理者には**編集**、それ以外の人には**開く**が表示されます。 | エージェントを閲覧できる全員 |
| **実行** | フォームと実行履歴を含む、エージェントの[実行ページ](#run-an-agent-directly)を開きます。実行権限のある**稼働中**のエージェントでのみ利用できます。 | エージェントを実行できるメンバー |
| **Askで使用** | エージェントを選択した状態で新しいAskチャットを開始します。実行権限のある**稼働中**のエージェントでのみ利用できます。 | エージェントを実行できるメンバー |
| **ピン留め** / **ピン留めを解除** | **ピン留めしたエージェント**にエージェントを追加、またはそこから削除します。 | 全員 |
| **リンクをコピー** | Agent Studioでエージェントを開くリンクをコピーします。エージェントを閲覧できる人だけが開けます。 | 全員 |
| **複製** | 名前を付けた後、エージェントを新しい非公開の下書きにコピーします。 | エージェントを編集でき、エージェントの作成権限もあるメンバー |
| **共有** | エージェントの共有設定を開きます。 | エージェントのアクセス権限を管理できるオーナーと管理者 |
| **公開リンク** | エージェントの公開リンク画面を開き、リンクの有効化や取り消しを行えます。[エージェントの公開リンク](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links)をご覧ください。 | 自分が所有するエージェントのオーナーと管理者 |
| **アーカイブ** | 確認後にエージェントをアーカイブします。エージェントは読み取り専用になり、履歴は保持されます。その時点でエージェントが処理中の場合（実行の開始中など）、Hiveは数秒待機します。それでも処理中の場合は「Hiveはこのエージェントを処理中です。少し待ってからもう一度お試しください。」と表示されます。変更は行われていないので、再度お試しください。一時停止も同じように動作します。 | オーナーと管理者 |
| **完全に削除** | 確認のため名前を入力すると、アーカイブ済みのエージェントを削除します。この操作は取り消せません。過去の実行とその使用量はワークスペースの記録に残り、引き続きプランの使用量に計上されます。以前に公開リンクで共有したエージェントも同様です。リンクは無効のままとなり、訪問者がそこで行った会話とその使用量は記録に残ります。エージェントを使用したチャットは通常のチャットとして残り、エージェントを使用したワークフローの実行も引き続き開けます。該当するステップには**エージェントは削除されました**と表示され、そのステップとそれ以降のステップの結果は表示されなくなります。ただし、すべてのステップのステータス、時間、コストは表示されます。エージェントの実行が進行中の場合は、そのエージェントを削除できません。 | オーナーと管理者 |

### エージェントのステータス

| ステータス | 意味 |
| - | - |
| `draft`（**下書き**） | 作成中です。プレビューはできますが、スケジュール設定や公開はできません。 |
| `deployed`（**稼働中**） | 保存済みのリビジョンが稼働しており、Ask、スケジュール、ワークフローで使用できます。 |
| `paused`（**一時停止中**） | 一時的に停止しています。**再開**すると、同じリビジョンで稼働を再開します。 |
| `archived`（**アーカイブ済み**） | 使用を終了し、通常の利用画面には表示されません。 |

## ロールごとにできること

Agent Studioはワークスペースのロールに従います（[ロールと権限](https://docs.get-hive.ai/admin/roles-and-permissions.md)を参照）：

* **エージェントを作成：** 部門リード、管理者、オーナーが作成できます。それ以外のメンバーには「エージェントを作成できるのはリード、管理者、オーナーのみです」と表示されます。Starterでは、全メンバーのエージェントを合算して、アーカイブされていないエージェントをワークスペース内に3つまで保持できます。Team以上には固定の上限はありません。上限に達すると、それ以上の作成やコピーは拒否されます。また、ダウングレードなどでプランの上限を超えたワークスペースでは、一部をアーカイブするまでエージェントをデプロイできません。
* **エージェントを実行：** オペレーター以上のロールに加え、そのエージェントの実行権限が必要です。
* **エージェントを削除：** 部門リード以上のロールが必要です。
* **ワークスペースのエージェント設定を管理：** 管理者以上のロールが必要です。
* **共有：** エージェントは、オーナーが指定した共同作業者と共有するまで、オーナーだけが利用できます。エージェントを共有しても、オーナーの接続済みアカウントが共有されることはありません。ただし、実行権限を持つ全員が、実行ページ、Ask、「チャットで続ける」でエージェントを実行する際に、そのエージェントに添付されたファイルを利用できます。また、ライブラリに追加しなくても、エージェントのチャットからそれらのファイルを開けます。[エージェントのファイルを閲覧できるユーザー](#who-can-read-an-agents-files)を参照してください。Askのチャットでエージェントが返した回答には、そのチャットの共有相手全員に対して、引き続きエージェントの名前とアイコンが表示されます。[Askでエージェントを使う](https://docs.get-hive.ai/ja/ask/ask-hive.md#use-an-agent-in-ask)を参照してください。

管理者は[ワークスペース設定](https://docs.get-hive.ai/admin/workspace-settings.md)で、ワークスペースのAgent Studioを無効にしたり、利用できるメンバーやグループを限定したりできます。

## 組み込みの安全対策

エージェントのアクションには、次のルールが適用されます：

* **選択されたアクションはアカウントのレベルに従います。** エージェントで選択されたアクションは、メンバー自身のアカウントから実行されます。ワークスペースの上限を適用したうえで、そのアカウントのレベルによって動作が決まります。**実行**では即座に実行され、**下書き**では承認カードで承認を待ち、**読み取り**ではアクションを実行せず、その旨を回答に記載します。メンバー、スケジュール、アプリのイベント、シグナルのいずれによって開始された実行でも同じです。[エージェントとワークフローが自律的に行うこと](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#what-agents-and-workflows-do)を参照してください。
* **アクションの送信先。** 宛先、チャンネル、電話番号、リンクが、エージェントの指示や、その実行のためにメンバーがHiveに入力した内容に由来しないアクションは、実行されず、そのメンバーの承認をカードで待ちます。たとえば、エージェントが読み取ったメール内で見つけたアドレスが該当します。カードはチャット内、またはそのメンバーの**シグナル**ページの**判断を確認**に表示されます。スケジュールに保存された入力は、誰かが自分で入力した言葉とはみなされません。エージェントに使用を許可するアドレス、チャンネル、リンクは、自分で指示に記載してください。**内容を記述**と**作成**チャットは、あなたが保存したものや説明に入力したもの以外を追加せず、代わりにその旨を伝えます（[エージェントを作成](https://docs.get-hive.ai/agents/build-an-agent.md)を参照）。[アクションの送信先](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#where-an-action-sends)を参照してください。
* **アクションの有効・無効。** ステップ3の**入力と出力**で、**詳細設定**の**許可する操作**を**読み取りと回答のみ**に設定すると、エージェントはアクションを一切実行しません。
* **選択されたアクションのみ。** エージェントが実行するのは、追加されたアプリで選択されているアクションだけです。それ以外のアクションは、アカウントに到達する前にHiveが拒否します。アプリごとにアクションを選択する仕組みが導入される前に設定されたエージェントは、アクションを選択するまで何も実行しません。
* **すべての実行者が利用するMCPツール。** 選択されたMCPツールは、実行者自身の同じサーバーへの接続で実行されます。その接続がない実行者には、サーバーへの接続を求める案内が表示されます（Hiveがそのツールを読み込めなかった場合は、読み込めなかった旨が表示されます）。同じサーバーへの接続が2つある実行者には、一方の接続を解除するよう案内されます。選択後にサーバー側で変更されたツールは拒否され、作成者にAgent Studioで再選択を求めるメッセージが表示されます。また、作成者自身の接続でのみ選択されているツールがあれば、回答にその旨が記載されます。新たに選択できるのは、編集者が接続しているサーバーのツールだけです。
* **予算。** 実行時間、モデル呼び出し、アクションステップ、外部への書き込み、トークンには厳格な上限があります。1回の実行のターン数はモデル呼び出し予算以下で、16回を超えることはありません。新しいエージェントにはHiveの既定値（モデル呼び出し8回）が適用されます。複数のツールを連鎖させるテンプレートから作成したエージェントには、それより多い回数が設定されます。エージェントの最初のアクションを選択すると、1回の実行につき外部への書き込みが1回許可されます。以前に作成されたエージェントは、保存時の予算を維持します。書き込み予算を超えると、Hiveはそれ以降のアクションを拒否します。送信先を理由に承認を待つアクションは、書き込み予算を消費しませんが、その実行のアクションステップ1回分として数えられます。さらに、プランで定められた1回の実行あたりのトークン上限が、Askでも適用されます。
* **ワークスペースの制限。** アクションには、1時間あたりのアクション上限と支出上限も引き続き適用されます。これらの制限に達したアクションは拒否され、エージェントが理由を伝えます。
* **クレジット。** エージェントによるモデルの処理は、ここで実行する場合も、スケジュールで実行する場合も、Askで誰かが質問する場合も、AIクレジットを消費します。Businessでは、実行するメンバーのクレジットを使用します（スケジュール実行ではスケジュールのオーナー、公開リンクでは公開者）。そのメンバー自身のクレジットと追加購入の上限を除き、エージェントごとの月間上限はありません。[旧プラン](https://docs.get-hive.ai/admin/earlier-plans.md)では、ワークスペースの共有枠を使用し、エージェントごとの月間上限はStarterとTeamで2,000クレジット、BusinessとEnterpriseで10,000クレジットです。エージェントのトークン予算を既定値より増やした場合、Hiveが£5（旧プランでは500クレジット）を超えると見積もった実行には、開始前に確認を求めます。既定の予算のエージェントでは、確認を求めることはありません。**デプロイ**ダイアログには、エージェントの稼働開始前に、1回の実行にかかる推定最大費用が表示されます。Businessではポンド、旧プランではクレジットで表示されます。クレジットが不足したスケジュール実行やイベント起点の実行は、クレジットが利用可能になるまで最大72時間待機します。Agent Studioのエージェントのカードには、**1件の実行がクレジット待ち**（または該当件数）と表示され、72時間待機した実行がある場合は\*\*クレジットが回復したら実行しますか？\*\*と表示されます（[クレジット待ち](https://docs.get-hive.ai/workflows/runs-and-errors.md#waiting-for-credits)を参照）。
* **繰り返しの失敗。** 同じアカウントで1時間以内に3回失敗したアクションは、そのアカウントでのみ一時停止され、エージェントが停止期限を伝えます。アカウントを再接続すると、一時停止が解除されます。[アクションの失敗が続く場合](https://docs.get-hive.ai/integrations/accounts-and-autonomy.md#when-an-action-keeps-failing)を参照してください。
* **外部のコンテンツ。** アプリのイベント（新着メール、新規案件）で開始されたエージェントは、ワークスペース外の人が書いた内容を読み取ったうえで、アクションを実行します。その内容から取得したアドレス、チャンネル、リンクに送信するアクションは承認を待ちますが、ヘルプデスクのチケットへの返信、請求書の送信や無効化、連絡先の削除など、既存のレコードに対するアクションは、この仕組みでは保留されません。こうした内容に基づいて実行してもよいアクションだけを選択し、書き込み予算は少なく設定してください。
* **緊急停止スイッチ。** 管理者が[緊急停止スイッチ](https://docs.get-hive.ai/admin/safety-and-control.md)を有効にすると、エージェントも他のすべての機能と同様にアクションを停止します。すでに進行中の実行やテストは、アクションの実行、Hive外部へのアクセス（ウェブ検索や接続済みアプリ）、回答の保存のいずれかを行う前に停止します。それまでは追加のモデル呼び出しが行われ、通常どおり課金される場合がありますが、生成された内容は保存も配信もされません。エージェントの一時停止、アーカイブ、デプロイの解除、または実行を開始した人の削除（もしくはオペレーター未満のロールへの変更）でも、進行中の実行は同じタイミングで停止します。
* **実行記録。** 完了したアクションは[監査ログ](https://docs.get-hive.ai/approvals/audit-log.md)に記録されます。

ライブラリの参照元が利用できなくなっても、保存済みの実行のステータスを確認したり、未完了の実行を停止したりできます。完了した実行の回答は保持されます。実行時に読み取った参照元へのアクセス権をその後失っても、後から回答を開けます。アクセス権の喪失は次の実行や質問から適用され、その参照元の読み取りや引用は行われなくなります。

> [!NOTE]
>
> 再利用可能なメンバーエージェントは**既定で無効**です。Hiveがワークスペースで有効にした場合にのみ表示されます。公開エージェントリンクは、すべてのワークスペースで利用できます。[公開エージェントリンク](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links)を参照してください。

## 制限の一覧

| 項目 | 上限 |
| - | - |
| 基本プロンプト | 16,000文字 |
| ペルソナ、目的 | 各4,000文字 |
| 入力 | 50 |
| ナレッジの紐付け | 100 |
| 追加されたアプリ | 20、各アプリで最大50のアクションを選択可能 |
| スキル | 10 |
| 会話のきっかけ | 12 |
| 1回の実行でのモデル呼び出し（ターン） | エージェントのモデル呼び出し予算（既定は8回）、最大16回 |
| 1回の実行で新規に書き込むライブラリのファイル | 3 |
| 他のエージェントへの委任 | 20、最大5階層 |
| ワークスペースあたりのエージェント（全メンバーのアーカイブされていないエージェント） | BusinessとTeamは無制限、Starterは3 |
| 1回の実行あたりのトークン数、スケジュール実行、イベント起点の実行、公開実行を含むすべての実行（入力／出力） | Business、Team、Enterpriseは3,000,000／300,000（Enterpriseは契約により変更可能）、Starterは300,000／30,000 |
| スケジュール、アプリのイベント、シグナルによって開始される実行のモデル | EfficientまたはBalanced。組織独自のキーを使用していない場合、Frontierは拒否されます |

すべての制限については、[制限リファレンス](https://docs.get-hive.ai/developers/limits-reference.md#agent-studio)をご覧ください。

## 関連情報

> [card] [エージェントを作成](https://docs.get-hive.ai/agents/build-an-agent.md)
>
> 最初のエージェントの内容を記述し、設定、テスト、デプロイを行います。

> [card] [公開と評価](https://docs.get-hive.ai/agents/publish-and-evaluate.md)
>
> 分析、フィードバック、スケジュール、公開リンク。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.