Service
通过 Console 和 HTTP API 为用户与应用运行 agent 的自托管平台。
Service 管理工作空间、访问权限、agent 及其修订版本，以及对话；客户端断开连接后，运行仍会继续。从入门指南开始本地部署并试用第一个 agent。
从这里开始
概念
- 组织与工作空间： 组织管理成员；每个工作空间包含自己的 agent、资源和对话。
- Agent 与修订版本： 每次保存 agent 都会创建一个不可变的修订版本；运行使用 agent 的默认修订版本，除非消息固定了另一个修订版本。
- 会话、线程与运行： 会话（在 Console 中即一次对话）组织多个线程；线程保存一段历史及其收件箱；每次运行推进该线程。
- Provider 与环境： provider 是为模型、环境、connector、Web 工具和记忆配置的账号；线程可以挂载环境来操作文件和终端。
核心概念通过一次对话介绍这些组件。
组件如何协作
- 客户端发送消息。Service 将其加入线程收件箱；线程上没有进行中或等待中的运行时，启动一次运行。
- Worker 使用 Harness 执行运行，保存进度，并将实时输出流式传给客户端。
- 运行以结果完成、失败、被取消，或等待审批、客户端工具结果或回答。等待需要显式恢复；普通消息仍留在收件箱中。继续对话的方法请参阅 Agent、线程与运行。
Control 和 worker 是同一个可执行程序的运行角色，单个进程可以同时承担两种角色。请参阅运维 Service。
指南
- 快速入门：部署、连接模型并发送第一条消息；在已有部署上使用 Console。
- 身份与访问：工作空间、成员、API 密钥和服务账号。
- Agent、线程与运行：配置 agent，然后开始、跟踪和恢复运行；Agent Composer可以协助构建 agent。
- 资源：了解模型、工具与连接、skill、环境、记忆以及文件与 webhook。
- HTTP 约定、API 参考和 SDK 与 CLI：构建集成。
- 配置、运维、监控和设置参考：运行部署。
接口
Console 和 API 使用同一个源；API 操作位于 /api/v1。a13n-service 可执行程序用于运行服务器和运维命令。已接受的约定请参阅 Service 规范。