Managed Agents 说明文档

# 托管智能体 (Managed Agents) — TypeScript > **此处未展示绑定：** 本 README 涵盖了 TypeScript 中最常见的托管智能体工作流。如果您需要此处未展示的类、方法、命名空间、字段或行为，请通过 `shared/live-sources.md` 获取 TypeScript SDK 仓库或相关文档页面，而不是进行猜测。请勿根据 cURL 格式或其他语言的 SDK 进行推断。 > **智能体是持久化的 — 创建一次，通过 ID 引用。** 请存储 `agents.create` 返回的智能体 ID，并将其传递给后续的每一个 `sessions.create`；请勿在请求路径中调用 `agents.create`。Anthropic CLI 是一种从版本控制的 YAML 创建智能体和环境的便捷方式 — 其 URL 位于 `shared/live-sources.md` 中。以下示例为了完整性展示了代码内创建方式；在生产环境中，创建调用应属于设置阶段，而非请求路径中。 ## 安装 bash npm install @anthropic-ai/sdk ## 客户端初始化 typescript import Anthropic from "@anthropic-ai/sdk"; // 默认（使用 ANTHROPIC_API_KEY 环境变量） const client = new Anthropic(); // 显式 API 密钥 const client = new Anthropic({ apiKey: "your-api-key" }); --- ## 创建环境 typescript const environment = await client.beta.environments.create( { name: "my-dev-env", config: { type: "cloud", networking: { type: "unrestricted" }, }, }, ); console.log(environment.id); // env_... --- ## 创建智能体（必需的第一步） > ⚠️ **没有内联智能体配置。** `model`/`system`/`tools` 存在于智能体对象上，而不是会话上。始终从 `agents.create()` 开始 — 会话仅接受 `agent: { type: "agent", id: agent.id }`。 ### 最小化示例 typescript // 1. 创建智能体（可重用，带版本） const agent = await client.beta.agents.create( { name: "Coding Assistant", model: "claude-opus-4-7", tools: [{ type: "agent_toolset_20260401", default_config: { enabled: true } }], }, ); // 2. 启动会话 const session = await client.beta.sessions.create( { agent: { type: "agent", id: agent.id, version: agent.version }, environment_id: environment.id, }, ); console.log(session.id, session.status); ### 带系统提示词和自定义工具 typescript const agent = await client.beta.agents.create( { name: "Code Reviewer", model: "claude-opus-4-7", system: "You are a senior code reviewer.", tools: [ { type: "agent_toolset_20260401", default_config: {