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

РазработкаПервые шаги

Начало работы с 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. SDK устанавливает бета-заголовок автоматически.

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

Создание первой сессии

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

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?