> ## 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 概览

> 构建以您的业务大脑和资料库为依据的专用 AI 智能体，仅执行您选定的操作，并在 Ask、定时任务和工作流中使用。

在 Agent Studio 中，您可以构建\*\*针对特定工作配置的专用智能体——以您的业务大脑为依据，遵守您的规则。\*\*Ask Hive 是通用助手。智能体则是已保存且具有版本记录的专用助手，例如使用您的语气撰写催款内容的助手、熟悉您模板的提案撰写助手，或负责某个共享收件箱的分类助手。

在侧边栏中，选择**Agent Studio**（`/agents`），它位于**工作流**的正上方。页面标题为**智能体**。您也可以通过命令面板（<kbd>⌘</kbd> <kbd>K</kbd>）访问。

## 什么是智能体

智能体由五个部分组成，它们一同保存为一个**修订版本**：

| 部分 | 控制内容 |
| - | - |
| **指令** | 用自然语言描述的智能体职责、角色设定和目标。 |
| **输入** | 用户启动智能体的方式：自由文本**提示词**（默认）、**由Hive选择**，或包含指定类型字段的结构化**表单**。 |
| **知识** | 智能体可以读取的资料库文件和文件夹。所有拥有运行权限的人，在智能体运行页面、Ask或“在聊天中继续”中运行它时，都可以使用这些文件，即使某个文件原本只有您能打开。请参阅[谁可以读取智能体的文件](#who-can-read-an-agents-files)。文件总量不超过约50,000个词元时，会完整传给模型。超过该数量时，智能体会获得一个列表（名称、日期、开头几行），并逐一打开所需文件。这适用于智能体运行、用户在Ask中向它提问、其他智能体向它委派任务、将其用作工作流步骤、草稿测试，以及通过其[公开链接](https://docs.get-hive.ai/agents/publish-and-evaluate.md#public-agent-links)运行的情况，其中公开链接每次打开文件时读取的内容更少。[完整测试](https://docs.get-hive.ai/agents/build-an-agent.md)仍会完整读取文件。对于绑定的电子表格（CSV、TSV或Excel），求和、平均值或计数等汇总结果会基于每一行精确计算，而非由模型估算。请参阅[Hive如何读取您选择的文件](https://docs.get-hive.ai/zh-hans/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/zh-hans/library/library.md#pages-and-text)，单击**文本**即可切换。预览使用您自己的资料库访问权限，因此，如果您无法在资料库中打开某个文件，此处也不会显示打开操作，只会显示用于移除文件的\*\*×\*\*。打开文件不会更改智能体。

### 来自 Google Drive、OneDrive 和 SharePoint 的文件

从 Google Drive、OneDrive 或 SharePoint 添加的文件会先**复制**到您的资料库，再像上传的文件一样附加到智能体（**已附加 · 保存以保留**）。智能体读取的是副本，而非实时的原始文件，因此运行不会等待原始文件，也不会因原始文件而失败。您需要具备操作员或更高级别的角色，且该账户必须是您本人在[集成](https://docs.get-hive.ai/zh-hans/integrations/overview.md)中连接的账户；如果尚未连接任何账户，选择器会提示您。

在**文件**行中，副本会显示其来源以及 Hive 上次检查的时间，例如**复制自 Google Drive · 2 小时前检查**。只有添加该文件的人才能刷新它：

* 在文件上选择**刷新**，立即检查原始文件。
* 当您在 Agent Studio 中打开智能体时，Hive 会检查您距上次检查已超过一小时的副本。
* 当您部署智能体时，Hive 会再次检查您的副本。

Hive 不会在后台进行检查，其他人打开智能体也不会触发检查。当原始文件发生变化时，Hive 会重新复制，并将之前的内容保留在文件的版本历史记录中。智能体会立即使用新内容，已部署的版本也不例外，这与编辑资料库文件后的行为一致。如果检查时无法访问原始文件，副本仍可正常使用，**文件**行会说明原因，例如**无法刷新：请重新连接 Google Drive**。请参阅[从 Google Drive、OneDrive 和 SharePoint
复制的文件](https://docs.get-hive.ai/zh-hans/library/library.md#files-copied-from-google-drive-onedrive-and-sharepoint)。

### 谁可以读取智能体的文件

附加到智能体的文件和文件夹属于智能体的一部分。共享智能体后，所有拥有运行权限的人在其运行页面、Ask和“在聊天中继续”中运行它时，都可以使用这些文件，即使这些文件在资料库中只有您能打开：

* **运行时。**智能体会在其运行页面、有人选用它的Ask聊天以及**在聊天中继续**中读取附加文件。Hive使用保存智能体最新版本的人员的资料库访问权限来读取这些文件。
* **图片。**如果智能体的模型支持读取图像（视觉模型），则在其运行页面、Ask和编辑器的**测试**中，附加的JPEG、PNG、GIF或WebP图片会以图像本身的形式传给模型。不支持读取图像的模型则会收到Hive对图片的描述（请参阅[Hive如何读取您选择的文件](https://docs.get-hive.ai/zh-hans/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客户端无法运行智能体或打开其聊天，因此绝不会通过这种方式读取智能体的文件。

用户为单次运行选择的文件（运行来源或表单字段中的文件）仍使用该用户自己的访问权限读取。对于由其他智能体委派任务的智能体，以及通过**立即运行**、定时计划或信号移交启动的运行，其文件也遵循此规则。工作流步骤以工作流运行身份所对应的成员的权限读取智能体文件，[公共链接](https://docs.get-hive.ai/agents/publish-and-evaluate.md)则以发布者的权限读取这些文件。

## 智能体在哪里运行

每个已部署的智能体都可在Ask、[自己的运行页面](#run-an-agent-directly)和工作流中使用。您无需选择它出现的位置。公开链接是独立的：您可以在编辑器的**公开链接**中启用。

> [card] [Ask Hive](https://docs.get-hive.ai/zh-hans/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)，以及您选择的运行来源、以您的身份读取的其在**个人自己的数据**下声明的成员数据和已附加且已连接的应用中的数据；如果允许，还可访问网络。 | 从您自己的账户执行智能体选定的操作，遵循各账户允许的权限级别，并受工作区权限上限约束：**执行**级别会立即执行，**草稿**级别需经您审批后执行，**读取**级别则完全不执行。操作会记录在运行中，每次运行最多执行5项。在**执行**级别下，如果某项操作的收件人、渠道、号码或链接并非来自智能体的指令或您为该次运行输入的内容，仍需等待您的审批。使用Word或Excel文件模板时，最多可[在您的资料库中新建3个文件](#files-a-run-writes-to-your-library)。 |
| 工作流步骤 | 智能体的知识和运行来源，以及以工作流运行身份所对应的成员身份读取的其在**个人自己的数据**下声明的成员数据和已附加且已连接的应用中的数据；如果允许，还可访问网络。网络搜索可能包含该步骤读取的任何内容，Hive的搜索服务提供商会收到这些内容。 | 从该成员的账户执行智能体选定的操作，遵循各账户允许的权限级别，并受工作区权限上限约束：**执行**级别会立即执行，**草稿**级别需经审批后执行，**读取**级别则完全不执行。每个步骤最多执行5项。在**执行**级别下，如果某项操作的收件人、渠道、号码或链接并非来自智能体的指令或在步骤中输入的固定值，仍需等待审批。 |
| 公开链接 | 仅限智能体自身的知识和访客的消息。 | 无。 |

除公开链接外，在上述每种场景中，工作区的[必用技能](https://docs.get-hive.ai/skills/skills.md#how-hive-uses-skills)都会与智能体的指令一同使用。

### 在工作流中使用智能体

部署智能体后，其已部署的修订版本就会显示在工作流构建器的**智能体库**、**添加步骤**菜单下的**智能体**中，以及**添加步骤**侧栏中。工作流步骤会固定使用添加时的修订版本；当您部署更新的版本后，该步骤会提供**更新至修订版本N**选项。

工作流步骤只会将资料库文件和文件夹或Google Docs链接作为知识和运行来源读取。因此，如果智能体包含其他知识、技能、子智能体、执行写入的连接器操作或其他来源，智能体库就会将其置灰，并说明需要修改的内容。步骤支持网络访问、**个人数据**（包括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/zh-hans/library/library.md)支持的类型。与其他上传文件一样，该文件会存入资料库根目录，并遵循资料库的共享规则。
* \*\*账户：\*\*智能体使用已连接的应用时，要使用您的哪些已连接账户。
* \*\*运行指令（可选）：\*\*针对本次运行的备注。
* \*\*对话快捷提问：**智能体的快捷提问，列在**运行指令（可选）\*\*下。选择其中一条即可将其填入运行指令，但不会启动运行。

在推出运行设置之前保存的旧版智能体会显示一个更简单的表单：包含其字段、**运行指令（可选）**和**立即运行**，不提供上传或“在聊天中继续”功能。

选择**运行**。回答会显示在表单下方，回答内容在前，来源和生成的文件折叠显示在其下。如果运行指令要求生成图表，例如“按地区绘制收入图表”，智能体会根据附加给它或它读取的电子表格，或您输入的数字绘制图表。图表会与回答一同显示和保存，其下方会注明来源，与[数据可视化](https://docs.get-hive.ai/ask/tools-and-modes.md)中的方式相同。从Agent Studio启动的运行——通过**立即运行**、定时计划、应用事件、信号或其他智能体启动——也会保留绘制的图表，最多4张；打开运行记录时，这些图表会显示在回答下方。根据示例数字绘制的图表会标注为示例数据，回答也会说明这一点。图表的显示或隐藏与运行回答完全一致。如果智能体允许后续提问，**在聊天中继续**会将该次运行作为Ask聊天打开，让您基于最多50条先前回答继续对话；超过此数量后，Hive会请您开始新会话。如果不允许后续提问，每次运行只会给出一个回答：要提出新问题，请再次运行。

选择**运行**后，运行会立即开始。智能体生成回答时，Hive会根据您当前的访问权限读取一次来源：如果您已无法打开某个来源，运行会失败并说明原因。工作流中使用已保存智能体的步骤也采用相同方式。如果某些操作因其发送目标而被暂缓，回答会说明有多少项操作正在**信号**页面的**审核决策**下等待您审批。

### 运行写入资料库的文件

当您亲自在智能体的运行页面运行它时，附有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两者都不知道，则会在文件中保留占位符，供您填写。
* \*\*仅创建新文件。\*\*运行绝不会更改、替换、移动或删除资料库中的现有文件。每次运行最多写入三个文件，每个文件都是供您检查的草稿。
* **在结果中查看。**每个文件都会列在运行结果的**产物**下，并提供**打开**按钮，可在资料库中打开该文件；回答中也会包含文件链接。
* \*\*留有记录。\*\*运行写入的每个文件都会在[审计日志](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/zh-hans/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/zh-hans/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无法加载服务器的工具，则会说明无法加载）；如果运行者有两个到该服务器的连接，系统会提示其断开其中一个。如果服务器上的工具在勾选后发生了更改，系统会拒绝使用该工具，并提示作者在Agent Studio中重新勾选。对于勾选的仅适用于作者自己连接的工具，回答也会予以说明。只能新勾选编辑者已连接服务器上的工具。
* \*\*预算。\*\*运行时间、模型调用次数、操作步骤数、外部写入次数和词元数均有硬性限制。每次运行的轮数不超过其模型调用预算，且最多为16轮。新智能体采用Hive的默认值（8次模型调用）；通过串联多个工具的模板创建的智能体，其初始预算更高；为智能体选择首项操作后，每次运行可进行一次外部写入；较早构建的智能体则保留保存时的预算。超出写入预算后，Hive会拒绝后续操作。因发送目标而等待审批的操作不占用写入预算，但会计为本次运行的一个操作步骤。此外，您的套餐对单次运行的词元上限也同样适用，包括在Ask中的运行。
* \*\*工作区限制。\*\*每小时操作次数上限和支出上限仍适用于操作。触及这些限制的操作会被拒绝，智能体会说明原因。
* **积分。**智能体的模型处理会消耗AI积分，无论是在此处运行、按计划运行，还是有人在Ask中向其提问。在Business套餐中，消耗的是运行该智能体的成员的积分（定时运行消耗定时计划所有者的积分；公开链接消耗发布者的积分），除该成员自己的积分和充值上限外，每个智能体没有月度限额；在[旧版套餐](https://docs.get-hive.ai/admin/earlier-plans.md)中，消耗的是工作区共享积分池，每个智能体的月度限额在Starter和Team中为2,000积分，在Business和Enterprise中为10,000积分。如果您将智能体的词元预算调高至默认值以上，而Hive估算某次运行的费用超过£5（旧版套餐中为500积分），则会在开始前要求您确认；使用默认预算的智能体不会要求确认。智能体上线前，**部署**对话框会显示每次运行的预计最高费用：Business套餐以英镑显示，旧版套餐以积分显示。如果定时或事件触发的运行所需积分已耗尽，该运行会等待积分补充，最长等待72小时；Agent Studio中的智能体卡片会显示**1次运行正在等待积分**（或实际次数），某次运行等待满72小时后则会显示**积分恢复后运行？**（请参阅[等待积分](https://docs.get-hive.ai/workflows/runs-and-errors.md#waiting-for-credits)）。
* \*\*反复失败。\*\*如果某项操作在同一账户上一小时内失败三次，该操作仅在该账户上暂停，智能体会说明暂停至何时。重新连接账户即可解除暂停。请参阅[操作持续失败时](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条 |
| 单次运行中的模型调用次数（轮数） | 智能体的模型调用预算（默认为8次），最多16次 |
| 单次运行写入资料库的新文件数 | 3个 |
| 委派给其他智能体 | 20次，最多深入5层 |
| 每个工作区的智能体数（所有成员未归档的智能体） | Business和Team无限制；Starter为3个 |
| 每次运行的词元数，包括定时、事件触发和公开运行（输入／输出） | 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.