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

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

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

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

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

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

Установка CLI

brew install anthropics/tap/ant

Проверьте установку:

ant --version

Установка SDK

pip install anthropic

Задайте ваш ключ API как переменную окружения:

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

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

Создайте агента
Создайте агента, который определяет модель, системную подсказку и доступные инструменты.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml) echo "Agent ID: $AGENT_ID"
coding-assistant.agent.yaml
name: Coding Assistant model: id: claude-opus-5 system: You are a helpful coding assistant. Write clean, well-documented code. tools: - type: agent_toolset_20260401
Тип инструмента agent_toolset_20260401 включает полный набор предустановленных инструментов агента (bash, файловые операции, веб-поиск и другие). Полный список и параметры настройки для каждого инструмента см. в разделе Инструменты.
Сохраните возвращённый agent.id. Вы будете ссылаться на него в каждой создаваемой сессии.
Создайте окружение
Окружение определяет песочницу, в которой выполняется ваш агент.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml) echo "Environment ID: $ENVIRONMENT_ID"
quickstart.environment.yaml
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, когда ему больше нечего делать.

Создание полноценного приложения

Каждое из этих кратких руководств сочетает Claude Managed Agents с популярным чат-фреймворком для создания полноценного работающего приложения. В каждом из них фреймворк отрисовывает интерфейс чата, а управляемая сессия выполняет цикл агента на стороне сервера: сессия хранит историю переписки, запускает инструменты в песочнице и передаёт в потоковом режиме события, которые отрисовывает фронтенд.

Chat SDK

Аналитик-исследователь в браузерном чате, созданном с помощью Chat SDK от Vercel. Каждый разговор — это одна постоянная сессия, которая передаёт свой ответ в потоковом режиме, пока живая лента показывает вызовы инструментов. Замена адаптера Chat SDK переносит тот же обработчик в Slack, Teams, Discord или WhatsApp.

assistant-ui

Аналитик электронных таблиц в чате, построенном из примитивов assistant-ui. Сессии представлены списком тредов, один редьюсер превращает журнал событий сессии в сообщения и карточки инструментов, а каждая команда bash отображает встроенный переключатель «Разрешить/Запретить» перед выполнением.

CopilotKit (AG-UI)

Ассистент по личным финансам в чате CopilotKit. Адаптер AG-UI для Claude Managed Agents сопоставляет каждый тред чата с управляемой сессией и передаёт ответы токен за токеном в потоковом режиме, а пользовательские инструменты отрисовывают интерактивные диаграммы прямо в разговоре.

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

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

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

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

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

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

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

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

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

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

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

Краткое руководство по вики знаний

Однократно преобразуйте корпус документов в вики знаний, а затем отвечайте на повторяющиеся вопросы из неё за малую долю стоимости

Was this page helpful?

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

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

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

Создайте агента
Создайте агента, который определяет модель, системную подсказку и доступные инструменты.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml) echo "Agent ID: $AGENT_ID"
coding-assistant.agent.yaml
name: Coding Assistant model: id: claude-opus-5 system: You are a helpful coding assistant. Write clean, well-documented code. tools: - type: agent_toolset_20260401
Тип инструмента agent_toolset_20260401 включает полный набор предустановленных инструментов агента (bash, файловые операции, веб-поиск и другие). Полный список и параметры настройки для каждого инструмента см. в разделе Инструменты.
Сохраните возвращённый agent.id. Вы будете ссылаться на него в каждой создаваемой сессии.
Создайте окружение
Окружение определяет песочницу, в которой выполняется ваш агент.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml) echo "Environment ID: $ENVIRONMENT_ID"
quickstart.environment.yaml
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, когда ему больше нечего делать.

Создание полноценного приложения

Chat SDK

assistant-ui

CopilotKit (AG-UI)

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

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

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

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

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

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

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

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

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

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

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

Краткое руководство по вики знаний

Was this page helpful?

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

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

Установка CLI

Установка SDK

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

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

Создание полноценного приложения

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

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

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

Установка CLI

Установка SDK

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

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

Создание полноценного приложения

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

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

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

Установка CLI

Установка SDK

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

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

Создание полноценного приложения

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

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

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

Установка CLI

Установка SDK

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

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

Создание полноценного приложения

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