Managed Agents 说明文档

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