1. 概览

官方文档

AgentScope Service 作为面向智能体应用的运行、管理与编排平台，能够把独立 Agent 或是多 Agent 协作的业务流程，打包成可供外部调用、全程可追踪的标准化服务。

你可在控制台零代码创建云端智能体，也可接入基于 AgentScope 开发的自定义应用，或直接使用 Codex 等代码智能体执行各类工作任务。

平台提供统一的对话交互、任务调度、多智能体协作与 API 调用入口，统一管理 Agent 运行状态与任务交付结果，让不同运行形态、不同能力类型的智能体，在同一套工作体系中高效协同作业。

主要组件与职责的概览：

AgentScope 是开发底座（造智能体的工具），AgentScope Service 是运行平台（把智能体变成可交付的服务）；Service 构建在 AgentScope 内核之上，两者是框架 → 平台的演进关系。

2. 智能体与任务管理

2.1 注册或者创建 Agent

按运行方式接入：

• Managed Agent：控制台直接创建云端 Agent，配置模型与资源
• AgentScope 框架：自研应用注册为 External Agent，应用需适配任务执行逻辑
• Hosted：连接 Runtime 主机，选用已部署登录的 Coding Agent 服务

控制台新建 New agent：

2.2 给 Agent 分派任务

两种分派方式：

• Endpoint 与 SSE：给代码 / 业务系统调用（程序对接）
• 控制台 Issue + Chat：人在网页控制台操作（人工发起任务）

Endpoint 是平台对外开放的 API 接口。把 Agent、Agent 团队、工作流打包成一个接口，带上权限校验、入参出参规范，外部系统直接请求这个接口，不用管里面是好几个 Agent 怎么互相协作。

支持登录网页控制台，手动安排任务，跟踪、评审结果，适合需要人工验收的工作：

2.3 处理任务反馈

针对两种分派方式进行任务反馈：

• Endpoint 与 SSE：业务程序订阅SSE获取实时进度，通过statusUrl查询任务终态、拉取结果文件；支持断线续传，由程序处理反馈。
• 控制台 Issue + Chat：网页实时查看对话与执行事件；任务完成后验收通知进入Inbox，人工确认通过或退回，适合人工评审。

Inbox 页面预览：

2.4 多 Agent 编排

支持两种编排方式：

• Team：创建与派发协作任务
• Workflow：多 Agent 流程编排

Team 实现多智能体协作：由 Leader Agent 拆分任务、委派成员执行，并汇总输出。建议先单独验证每个 Agent 能力，再组建团队。

Workflow 适合步骤固定、有依赖关系、带人工审批关口的流水线。

2.5 事件驱动与自动化任务

Automation 用于定义可复用触发规则，配置触发条件 + 执行任务，多用于定时任务或外部事件触发 Agent/Team。

• 定时计划（Cron）：设置 Cron 表达式与时区，定时启动任务；支持跳过/排队两种并发策略，可配置队列、执行超时，先测试再启用。
• Webhook 触发：生成 Webhook 地址与密钥，外部系统推送事件；携带密钥与幂等键，事件数据作为任务上下文，支持事件过滤，可重放投递。

Channels 用来对接外部消息平台，负责消息连接与路由；Agent 负责实际业务执行。应用系统 HTTP 调用请用 Endpoint 。

1. 建立渠道：准备第三方平台凭据，新建 Channel，配置回调地址（必须公网HTTPS）。
2. 路由配置：设置消息匹配规则，绑定目标 Agent；测试消息收发、会话与文件处理。
3. 消息转工单：外部消息可关联生成 Issue，用于长期跟踪。
4. 故障排查：依次检查事件订阅、回调连通性、密钥、Agent 状态、消息回传权限。

3. 基础概念

3.1 Managed Agent

由 AgentScope Service 统一托管执行 Harness、会话、模型调用。仅需在控制台配置角色指令、模型、资源，无需独立部署 Agent 应用。适合知识问答、资料处理等场景。

• 支持绑定 Workspace、Environment、Memory、Vault
• 可加入 Team，支持 Workflow / Automation / Channel 调用，可发布为 Endpoint 对外提供服务
• 工具执行依托 Environment，密钥存放于 Vault，业务文档存入 Memory，复用技能定义存放于 Workspace

3.2 External Agent

保留用户原有应用进程、开发框架与部署方式，注册接入 AgentScope Service。Service 不启动该 Agent，仅提供统一目录、会话诊断、任务协作派发能力。

• 通过 Java / Python SDK 做适配桥接，支持 HTTP 合约或 ASDP gRPC 两种接入方式
• 模型、工具、凭据由外部应用自身管理，不使用平台 Environment、Vault
• 可作为 Team 成员，接收 Issue 任务派发，上报任务状态与产物

3.3 Hosted Agent

在用户自有服务器/本机运行 Coding Agent（Claude Code、Qoder 等）。AgentScope Service 负责任务调度、协作记录；Runtime Host 在本地拉起 Provider 执行任务。

• 模型、工具、账号由用户在主机侧维护
• 本地主机作为执行载体，不使用平台 Environment
• 常作为 Team 的代码实施角色，可接收 Issue 任务，产物上传为 Artifact

3.4 Team

将多个 Agent 组织成协作团队。Leader 负责理解目标、挑选成员、拆分委派任务并汇总最终结果；成员承担专项能力。

• Team 无固定执行步骤，由 Leader 动态决定协作流程；固定步骤场景优先选用 Workflow
• 成员可以是 Managed / External / Hosted 任意类型 Agent
• 可绑定 Issue 工单、Automation 自动触发，发布为 Job 类型 Endpoint 对外调用

3.5 资源配置

3.5.1 Workspaces

共享能力定义资源仓库，存放 AGENTS.md、技能、MCP 工具配置、子 Agent 定义，支持多 Agent 复用。

• 仅为能力定义，不会自动安装系统依赖、创建文件目录

3.5.2 Environments

Managed Agent 专用，定义文件、Shell 工具的执行位置。

• 类型包含 local、sandbox 云沙箱、remote、self-hosted 自托管 Worker
• 仅用于 Managed Agent，不等同于 Hosted Agent 的 Runtime Host

3.5.3 Memory

共享知识存储，保存长期静态文档、术语、业务资料。Agent 按需读取，不会一次性全量塞入 prompt。

• 和会话临时记忆、Issue 评论相互独立

3.5.4 Vault

凭据安全仓库，存放 MCP、第三方工具密钥，存储后不展示明文，供 Managed Agent 工具连接引用。

• 密钥通过变量占位符在 MCP 配置引用，禁止将 Secret 写入指令或 Workspace 文档