managed-agents-core

# 托管智能体 — 核心概念 ## 架构 托管智能体围绕四个核心概念构建： | 概念 | 端点 | 说明 | |---|---|---| | **智能体 (Agent)** | `/v1/agents` | 一个持久化、带版本的对象，定义了智能体的能力和角色：模型、系统提示词、工具、MCP 服务器、技能。**必须在启动会话前创建。** 见下文“智能体”部分。 | | **会话 (Session)** | `/v1/sessions` | 与智能体的有状态交互。引用一个预先创建的智能体 ID + 环境 + 初始指令。产生一个事件流。 | | **环境 (Environment)** | `/v1/environments` | 定义容器配置的模板。 | | **容器 (Container)** | N/A | 一个隔离的计算实例，智能体的**工具**在此执行（bash、文件操作、代码）。智能体循环不在此运行 — 它在 Anthropic 的编排层运行，并通过工具调用作用于容器。 | ┌─────────────────────────────────────┐ │ Anthropic 编排层 │ 智能体 (配置) ───────▶│ (智能体循环：Claude + 工具调用) │ └──────────────┬──────────────────────┘ │ 工具调用 ▼ 环境 (模板) ──▶ 容器 (工具执行工作区) │ 会话 ─┤ ├── 资源 (文件、仓库、记忆存储 — 启动时挂载) ├── 存储库 ID (MCP 凭据引用) └── 对话 (输入/输出事件流) > **创建智能体是先决条件。** 会话通过 ID 引用预先创建的智能体 — `model`（模型）/`system`（系统提示词）/`tools`（工具）存在于智能体对象上，而非会话上。每个流程都以 `POST /v1/agents` 开始。 --- ## 会话生命周期 rescheduling（重新调度） → running（运行中） ↔ idle（空闲） → terminated（已终止） | 状态 | 说明 | | -------------- | ------------------------------------------------------------------ | | `idle` | 智能体已完成当前任务，正在等待输入。它要么在等待输入以通过 `user.message` 继续工作，要么被阻塞以等待 `user.custom_tool_result` 或 `user.tool_confirmation`。附加的 `stop_reason` 包含了关于智能体停止工作原因的更多信息。 | | `running` | 会话已开始运行，智能体正在积极执行工作。 |