快速入门

构建入门步骤

开始使用 Claude Managed Agents

创建您的第一个自主智能体。

本指南将引导您完成创建智能体、设置环境、启动会话以及流式传输智能体响应的全过程。

核心概念

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

前提条件

一个 Anthropic Console 账户
一个 API 密钥

安装 CLI

检查安装情况：

ant --version

安装 SDK

将您的 API 密钥设置为环境变量：

export ANTHROPIC_API_KEY="your-api-key-here"

创建您的第一个会话

所有 Managed Agents API 请求都需要 managed-agents-2026-04-01 beta 请求头。SDK 会自动设置该 beta 请求头。

创建智能体
创建一个定义模型、系统提示词和可用工具的智能体。
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-7}' \ --system "You are a helpful coding assistant. Write clean, well-documented code." \ --tool '{type: agent_toolset_20260401}'
agent_toolset_20260401 工具类型启用了完整的预构建智能体工具集（bash、文件操作、网络搜索等）。请参阅工具以获取完整列表和每个工具的配置选项。
保存返回的 agent.id。您将在创建的每个会话中引用它。
创建环境
环境定义了智能体运行所在的容器。
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
保存返回的 environment.id。您将在创建的每个会话中引用它。

启动会话

创建一个引用您的智能体和环境的会话。

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    title="Quickstart session",
)

print(f"Session ID: {session.id}")

发送消息并流式传输响应

打开流，发送用户事件，然后在事件到达时处理它们：

with client.beta.sessions.events.stream(session.id) as stream:
    # Send the user message after the stream opens
    client.beta.sessions.events.send(
        session.id,
        events=[
            {
                "type": "user.message",
                "content": [
                    {
                        "type": "text",
                        "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                    },
                ],
            },
        ],
    )

    # Process streaming events
    for event in stream:
        match event.type:
            case "agent.message":
                for block in event.content:
                    print(block.text, end="")
            case "agent.tool_use":
                print(f"\n[Using tool: {event.name}]")
            case "session.status_idle":
                print("\n\nAgent finished.")
                break

智能体将编写一个 Python 脚本，在容器中执行它，并验证输出文件是否已创建。您的输出将类似于以下内容：

I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
[Using tool: write]
[Using tool: bash]
The script ran successfully. Let me verify the output file.
[Using tool: bash]
fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).

Agent finished.

发生了什么

当您发送用户事件时，Claude Managed Agents 会：

配置容器： 您的环境配置决定了容器的构建方式。
运行智能体循环： Claude 根据您的消息决定使用哪些工具
执行工具： 文件写入、bash 命令和其他工具调用在容器内运行
流式传输事件： 您会在智能体工作时实时收到更新
进入空闲状态： 当智能体没有更多任务时，会发出 session.status_idle 事件

后续步骤

创建可复用的、版本化的智能体配置

自定义网络和容器设置

为您的智能体启用特定工具

处理事件并在执行过程中引导智能体

Was this page helpful?

构建入门步骤

开始使用 Claude Managed Agents

创建您的第一个自主智能体。

本指南将引导您完成创建智能体、设置环境、启动会话以及流式传输智能体响应的全过程。

核心概念

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

前提条件

一个 Anthropic Console 账户
一个 API 密钥

安装 CLI

检查安装情况：

ant --version

安装 SDK

将您的 API 密钥设置为环境变量：

export ANTHROPIC_API_KEY="your-api-key-here"

创建您的第一个会话

所有 Managed Agents API 请求都需要 managed-agents-2026-04-01 beta 请求头。SDK 会自动设置该 beta 请求头。

创建智能体
创建一个定义模型、系统提示词和可用工具的智能体。
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-7}' \ --system "You are a helpful coding assistant. Write clean, well-documented code." \ --tool '{type: agent_toolset_20260401}'
agent_toolset_20260401 工具类型启用了完整的预构建智能体工具集（bash、文件操作、网络搜索等）。请参阅工具以获取完整列表和每个工具的配置选项。
保存返回的 agent.id。您将在创建的每个会话中引用它。
创建环境
环境定义了智能体运行所在的容器。
ant beta:environments create \ --name "quickstart-env" \ --config '{type: cloud, networking: {type: unrestricted}}'
保存返回的 environment.id。您将在创建的每个会话中引用它。

启动会话

创建一个引用您的智能体和环境的会话。

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    title="Quickstart session",
)

print(f"Session ID: {session.id}")

发送消息并流式传输响应

打开流，发送用户事件，然后在事件到达时处理它们：

with client.beta.sessions.events.stream(session.id) as stream:
    # Send the user message after the stream opens
    client.beta.sessions.events.send(
        session.id,
        events=[
            {
                "type": "user.message",
                "content": [
                    {
                        "type": "text",
                        "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                    },
                ],
            },
        ],
    )

    # Process streaming events
    for event in stream:
        match event.type:
            case "agent.message":
                for block in event.content:
                    print(block.text, end="")
            case "agent.tool_use":
                print(f"\n[Using tool: {event.name}]")
            case "session.status_idle":
                print("\n\nAgent finished.")
                break

智能体将编写一个 Python 脚本，在容器中执行它，并验证输出文件是否已创建。您的输出将类似于以下内容：

I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
[Using tool: write]
[Using tool: bash]
The script ran successfully. Let me verify the output file.
[Using tool: bash]
fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).

Agent finished.

发生了什么

当您发送用户事件时，Claude Managed Agents 会：

配置容器： 您的环境配置决定了容器的构建方式。
运行智能体循环： Claude 根据您的消息决定使用哪些工具
执行工具： 文件写入、bash 命令和其他工具调用在容器内运行
流式传输事件： 您会在智能体工作时实时收到更新
进入空闲状态： 当智能体没有更多任务时，会发出 session.status_idle 事件

后续步骤

创建可复用的、版本化的智能体配置

自定义网络和容器设置

为您的智能体启用特定工具

处理事件并在执行过程中引导智能体

Was this page helpful?