Managed Agents 说明文档

# 托管智能体 (Managed Agents) — Java > **此处未显示绑定：** 本 README 涵盖了 Java 中最常见的托管智能体流程。如果您需要此处未显示的类、方法、命名空间、字段或行为，请查阅 Java SDK 仓库或 `shared/live-sources.md` 中的相关文档页面，而不是进行猜测。请勿根据 cURL 格式或其他语言的 SDK 进行推断。 > **智能体是持久化的 — 创建一次，通过 ID 引用。** 存储 `client.beta().agents().create` 返回的智能体 ID，并将其传递给后续的每一个 `client.beta().sessions().create`；不要在请求路径中调用 `agents().create`。Anthropic CLI 是从版本控制的 YAML 创建智能体和环境的一种便捷方式 — 其 URL 位于 `shared/live-sources.md` 中。以下示例为了完整性展示了代码内创建方式；在生产环境中，创建调用应属于设置阶段，而不是请求路径。 ## 安装 xml com.anthropic anthropic-java ## 客户端初始化 java import com.anthropic.client.okhttp.AnthropicOkHttpClient; // 默认（使用 ANTHROPIC_API_KEY 环境变量） var client = AnthropicOkHttpClient.fromEnv(); --- ## 创建环境 java import com.anthropic.models.beta.environments.BetaCloudConfigParams; import com.anthropic.models.beta.environments.EnvironmentCreateParams; import com.anthropic.models.beta.environments.UnrestrictedNetwork; var environment = client.beta().environments().create(EnvironmentCreateParams.builder() .name("my-dev-env") .config(BetaCloudConfigParams.builder() .networking(UnrestrictedNetwork.builder().build()) .build()) .build()); System.out.println("Environment ID: " + environment.id()); // env_... --- ## 创建智能体 (必需的第一步) > ⚠️ **没有内联智能体配置。** 模型、系统提示词和工具位于智能体对象上，而不是会话上。请务必从 `client.beta().agents().create()` 开始 — 会话接受 `.agent(agent.id())` 或类型化的 `BetaManagedAgentsAgentParams.builder()...build()`。 ### 最小化配置 java import com.anthropic.models.beta.agents.AgentCreateParams; import com.anthropic.models.beta.agents.BetaManagedAgentsAgentToolset20260401Params; import com.anthropic.models.beta.sessions.BetaManagedAgentsAgentParams; import com.anthropic.models.beta.sessions.SessionCreateParams; // 1. 创建智能体（可重用，带版本） var agent = client.beta().agents().create(AgentC