1. 登录企业账号：使用分配了企业坐席的个人账号登录企业后台。
2. 创建 Agent：点击右上角企业智能体进入企业后台，填写基础配置后点击发布。
3. 接入渠道：在渠道接入中配置企微 AIBot、QQ 机器人、飞书或钉钉，即可开始使用。
说明：
创建 Agent 后，建议在左侧对话框切换 Test Run 模式测试 Agent 的响应效果，确认配置无误后再发布。
创建 Agent
基础配置
完成以下配置：
Agent 名称
Agent 标题
欢迎语
选择模型：支持采用 Auto 模式自动选择或选择模型管理 > 模型列表中的内置模型。
System Prompt：在输入框中定义 Agent 的角色、行为规范和约束条件。
追问：预设引导问题
技能/专家/MCP/连接器
可以为 Agent 添加技能/专家/MCP/连接器，这些配置项会自动同步到 Agent 的 Manifest 中。
技能： 为 Agent 挂载技能包，扩充特定领域能力。
专家： 为 Agent 绑定专家，扩展领域能力。
连接器：为 Agent 接入第三方平台（腾讯文档、QQ 邮箱等），运行时通过统一网关访问 MCP 工具。
MCP： 填写 MCP Server 配置，发布时与连接器合并生效。
高级配置
记忆： 开启后 Agent 会记住多轮对话中的重要信息，跨轮次保持上下文。
知识库： 关联官方知识库和企业在后台配置的自定义知识库，Agent 可通过 RAG 检索获取知识库中的相关信息。
Manifest
Manifest 是 Agent 的声明式配置，在创建 Agent 时传入，可在企业后台编辑管理。
最小配置
{"id": "my-agent","name": "My Agent","manifestVersion": "1.0"}
配置项说明
基础配置
字段 | 类型 | 必需 | 说明 |
id | string | 是 | Agent 唯一标识符 |
name | string | 是 | Agent 显示名称 |
manifestVersion | string | 是 | Manifest 版本（当前 1.0） |
system_prompt | string | 否 | 系统提示词（与 system_prompt_file 互斥） |
system_prompt_file | string | 否 | 系统提示词文件 URL |
useWorkspaceRoot | boolean | 否 | 是否直接以工作空间根目录作为 Agent 的工作目录。为 true 时，Agent 直接在工作空间根目录读写文件，无需再声明 workspaces[]；缺省或 false 时，需通过 workspaces[] 显式声明工作空间。适用于文档/办公型 Agent。 |
能力配置
字段 | 类型 | 必需 | 说明 |
rules | Rule[] | 否 | 行为规则文件列表 |
skills | Skill[] | 否 | 预定义技能（pdf, xlsx 等） |
plugins | Plugin[] | 否 | 扩展插件 |
mcp | MCPConfig[] | 否 | MCP 服务配置 |
subagents | Subagent[] | 否 | 可调用的子 Agent |
工作空间配置
字段 | 类型 | 必需 | 说明 |
workspaces[].name | string | 是 | 工作空间名（映射到 /workspace/<name>/） |
workspaces[].repository | string | 否 | Git 仓库 URL |
workspaces[].downloadUrl | string | 否 | 源码包 URL |
workspaces[].ref | string | 否 | Git 分支 / 标签 / Commit SHA |
workspaces[].initShellCommand | string | 否 | 初始化 Shell 命令 |
workspaces[].initCommand | string | 否 | CodeBuddy 初始化命令 |
环境配置
字段 | 类型 | 必需 | 说明 |
secrets | Secret[] | 否 | 敏感信息（通过安全通道注入，不写入沙箱文件） |
envs | EnvVar[] | 否 | 环境变量（写入 manifest 并同步到运行环境） |
注意：
secrets 支持
${VAR_NAME} 引用环境变量，避免硬编码密钥。系统会自动注入 AGENTOS_RUNTIME_ID 环境变量。Test Run
在左侧对话框切换 Test Run 模式，使用当前配置对话测试 Agent 的响应效果。
渠道接入
支持接入企微 AIBot、QQ 机器人、飞书和钉钉接收和回复 Agent 消息。在企业后台可以管理 Agent 的即时通讯渠道，每条接入记录对应一个 Bot → Session 的绑定关系。
1. 选择类型
例如选择企微 AIBot 接入：
2. 填写配置
在创建的企微 AIBot 中选择使用 URL 回调的连接方式，点击 Token 和 EncodingAESKey 输入框右侧的随机获取。将获取到的 Token 和 EncodingAESKey 填入对应位置：
3. 绑定 Session
选择一个 Session 与此渠道绑定，消息将路由到该 Session：
4. 完成
复制 Webhook 地址填入企微 AIBot 连接方式中的 URL 位置：
说明：
凭据管理
凭据管理为 Agent 提供安全的凭据存储和代理注入能力。当 Agent 调用 MCP 服务、Skill 技能或外部 API 时，系统会自动将对应的认证凭据注入请求中，无需在代码或配置中明文暴露密钥。
说明：
凭据以加密方式存储，仅在 Agent 运行时由代理层解密并注入请求头，确保凭据在传输和存储过程中的安全性。
添加凭据
进入企业后台，在企业智能体 > 凭据管理右上角点击添加凭据，填写以下信息后点击下一步完成凭据添加。
Agent 管理
Agent
进入企业后台的企业智能体 > Agent 板块可以查看已创建的 Agent 信息，对 Agent 进行接入、版本管理、编辑、克隆、删除等操作。
说明：
「Session 数」表示当前基于该 Agent 运行的 Session 总数，包含用户通过分享链接创建的和通过 API 创建的。
团队成员接入
将 Agent 通过接入操作，复制链接分享给团队成员后，每个人打开链接都会自动获得一个专属的独立 Session。
接入链接：团队成员打开链接可见的独立 Session。
开发集成 > API 集成：通过企业 API Key 调用，可将 Agent 能力集成到企业自有系统中。
版本管理
点击对应 Agent 的版本发布操作，进入版本管理页面，查看和编辑版本历史。
Runtime
Runtime 页面面向运维管理，展示沙箱的真实运行状态。
创建中：正在创建沙箱。
运行中：沙箱正在活跃服务。
休眠：空闲超时后自动暂停（再次访问自动唤醒）。
已停止：沙箱停止运行。
失败：沙箱创建或启动异常。
当 Session 出现问题时，可在此排查沙箱模板、状态和错误原因。
说明：
通常 Session 与 Runtime 一一对应。如果 Runtime 没有关联的 Session，可能是 Session 已删除但沙箱资源未回收，建议及时清理以释放资源。
Session
当用户通过分享链接打开 Agent 或通过 API 调用时，系统会自动创建一个专属 Session，承载该用户的所有对话记录和产出文件。
对话历史独立：每个 Session 拥有独立的对话历史和文件存储，用户下次打开可以继续上次的工作。
自动休眠机制：Session 超过 10 分钟无访问会自动休眠以节省资源，再次访问时自动唤醒。
列表字段说明
名称：该 Session 名称，创建时填入。
Agent：该 Session 中运行的 Agent。
Runtime ID: 该 Session 对应的 Runtime ID。
创建者：标识该 Session 由谁发起。
Agent 评测
通过标准化的评测任务衡量 Agent 的回答质量。选择目标 Agent 和评测数据集，系统会自动逐条运行测试用例并按照指定的评分方式计算得分，帮助你量化 Agent 的能力表现。
说明：
启动评测将消耗你的个人积分。
