Управляемые агентыПервые шаги

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

Создайте своего первого автономного агента.

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

Предпочитаете интерактивное руководство? Выполните команду /claude-api managed-agents-onboard в последней версии Claude Code для пошаговой настройки и интерактивных ответов на вопросы.

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

Понятие	Описание
Агент	Модель, системная подсказка, инструменты, серверы MCP и навыки
Среда	Конфигурация места выполнения сессий: облачная песочница под управлением Anthropic или самостоятельно размещённая песочница на вашей собственной инфраструктуре
Сессия	Запущенный экземпляр агента внутри среды, выполняющий конкретную задачу и генерирующий выходные данные
События	Сообщения, которыми обмениваются ваше приложение и агент (ходы пользователя, результаты инструментов, обновления статуса)

Предварительные требования

Учётная запись в Console от Anthropic
Ключ 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-8}' \ --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:
    # Отправить сообщение пользователя после открытия потока
    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",
                    },
                ],
            },
        ],
    )

    # Обработка событий потоковой передачи
    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, когда ему больше нечего делать.

Дальнейшие шаги

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

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

Настройте окружения

Настройте параметры сети и песочницы

Инструменты агента

Включите определённые инструменты для вашего агента

Поток событий сессии

Обрабатывайте события и управляйте агентом в процессе выполнения

Запланированные развёртывания

Запускайте вашего агента по повторяющемуся расписанию cron

Was this page helpful?

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

Понятие	Описание
Агент	Модель, системная подсказка, инструменты, серверы MCP и навыки
Среда	Конфигурация места выполнения сессий: облачная песочница под управлением Anthropic или самостоятельно размещённая песочница на вашей собственной инфраструктуре
Сессия	Запущенный экземпляр агента внутри среды, выполняющий конкретную задачу и генерирующий выходные данные
События	Сообщения, которыми обмениваются ваше приложение и агент (ходы пользователя, результаты инструментов, обновления статуса)

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

Создайте агента
Создайте агента, который определяет модель, системную подсказку и доступные инструменты.
ant beta:agents create \ --name "Coding Assistant" \ --model '{id: claude-opus-4-8}' \ --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:
    # Отправить сообщение пользователя после открытия потока
    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",
                    },
                ],
            },
        ],
    )

    # Обработка событий потоковой передачи
    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, когда ему больше нечего делать.

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

Предварительные требования

Установка CLI

Установка SDK

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

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

Дальнейшие шаги

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

Предварительные требования

Установка CLI

Установка SDK

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

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

Дальнейшие шаги

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

Предварительные требования

Установка CLI

Установка SDK

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

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

Дальнейшие шаги

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

Предварительные требования

Установка CLI

Установка SDK

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

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

Дальнейшие шаги