Agents：定义可重复使用的能力

English DESIGN → Agents 管理 Agent 的身份、行为和执行方式。Agent 定义可以被 Chat、Issue、Team 和 Endpoint 复用；保存定义本身不会执行任务。

​

选择运行方式

三种方式共享工作入口，但模型、工具、会话恢复和配置投影能力不同。不要把“目录中可见”当成“具备所有会话和派发能力”。接入细节见 Managed、Hosted 和 External。

​

创建一个 Agent

1. 点击创建按钮，填写 Name、用途和 Instructions。
2. 按需要关联 Workspace，复用其中的操作说明、技能、工具和子 Agent 定义。
3. 在 Execution 中明确选择 Runtime。存在在线 Host 时页面可能优先选择 Hosted provider；体验托管 Agent 时请主动选择 AgentScope Managed。
4. Model 留空使用运行时默认值，或填写该 provider 接受的模型标识。
5. Managed Agent 在 Advanced settings 中选择 Environment；只有管理员允许 Local 时才使用自动本地默认环境。
6. 点击 Create & open agent，进入详情检查配置。

Agent key 是稳定身份，用于区分同一空间中的 Agent；显示名称用于让同事理解用途。

​

按详情菜单配置

​

一次只扩展一种能力

先验证纯对话，再加文件读取、一个外部工具和一个专项技能。将需要的凭据放入 Vault，共享知识放入 Memory。添加配置文件不会给运行时自动安装二进制工具，也不会授予外部系统权限。 修改共享 Workspace 可能影响多个 Agent。保存前查看消费者，保存后使用新 Chat 或 Issue 验证；正在运行的任务不应被假定会即时切换到新定义。 下一步：Teams · Workspaces。