Начало работы с Claude Managed Agents

Быстрый старт

Это руководство проведёт вас через создание агента, настройку среды, запуск сессии и потоковую передачу ответов агента.

Основные концепции

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
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. SDK устанавливает бета-заголовок автоматически.

Что происходит

Когда вы отправляете пользовательское событие, Claude Managed Agents:

Подготавливает контейнер: Конфигурация вашей среды определяет, как он строится.
Запускает цикл агента: Claude решает, какие инструменты использовать, на основе вашего сообщения
Выполняет инструменты: Запись файлов, команды bash и другие вызовы инструментов выполняются внутри контейнера
Передаёт события потоком: Вы получаете обновления в реальном времени по мере работы агента
Переходит в режим ожидания: Агент генерирует событие session.status_idle, когда ему больше нечего делать

Следующие шаги

Определите своего агента

Создавайте многократно используемые версионированные конфигурации агентов

Создайте агента
Создайте агента, который определяет модель, системный промпт и доступные инструменты.
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.