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

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

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

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

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

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

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

Создайте агента
Создайте агента, который определяет модель, системный промпт и доступные инструменты.
set -euo pipefail agent=$( curl -sS --fail-with-body https://api.anthropic.com/v1/agents \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: managed-agents-2026-04-01" \ -H "content-type: application/json" \ -d @- <<'EOF' { "name": "Coding Assistant", "model": "claude-sonnet-4-6", "system": "You are a helpful coding assistant. Write clean, well-documented code.", "tools": [ {"type": "agent_toolset_20260401"} ] } EOF ) AGENT_ID=$(jq -er '.id' <<<"$agent") AGENT_VERSION=$(jq -er '.version' <<<"$agent") echo "Agent ID: $AGENT_ID, version: $AGENT_VERSION"
Тип инструмента agent_toolset_20260401 включает полный набор предустановленных инструментов агента (bash, файловые операции, веб-поиск и другие). Полный список и параметры конфигурации для каждого инструмента см. в разделе Инструменты.
Сохраните возвращённый agent.id. Вы будете ссылаться на него в каждой создаваемой сессии.

Создайте среду

Среда определяет контейнер, в котором работает ваш агент.

environment=$(
  curl -sS --fail-with-body https://api.anthropic.com/v1/environments \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -H "anthropic-beta: managed-agents-2026-04-01" \
    -H "content-type: application/json" \
    -d @- <<'EOF'
{
  "name": "quickstart-env",
  "config": {
    "type": "cloud",
    "networking": {"type": "unrestricted"}
  }
}
EOF
)

ENVIRONMENT_ID=$(jq -er '.id' <<<"$environment")

echo "Environment ID: $ENVIRONMENT_ID"

Сохраните возвращённый environment.id. Вы будете ссылаться на него в каждой создаваемой сессии.

Запустите сессию

Создайте сессию, которая ссылается на вашего агента и среду.

session=$(
  curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -H "anthropic-beta: managed-agents-2026-04-01" \
    -H "content-type: application/json" \
    -d @- <<EOF
{
  "agent": "$AGENT_ID",
  "environment_id": "$ENVIRONMENT_ID",
  "title": "Quickstart session"
}
EOF
)

SESSION_ID=$(jq -er '.id' <<<"$session")

echo "Session ID: $SESSION_ID"

Отправьте сообщение и получите потоковый ответ

Откройте поток, отправьте пользовательское событие, затем обрабатывайте события по мере их поступления:

# Send the user message first; the API buffers events until the stream attaches
curl -sS --fail-with-body \
  "https://api.anthropic.com/v1/sessions/$SESSION_ID/events" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- >/dev/null <<'EOF'
{
  "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"
        }
      ]
    }
  ]
}
EOF

# Open the SSE stream and process events as they arrive
while IFS= read -r line; do
  [[ $line == data:* ]] || continue
  json=${line#data: }
  case $(jq -r '.type' <<<"$json") in
    agent.message)
      jq -j '.content[] | select(.type == "text") | .text' <<<"$json"
      ;;
    agent.tool_use)
      printf '\n[Using tool: %s]\n' "$(jq -r '.name' <<<"$json")"
      ;;
    session.status_idle)
      printf '\n\nAgent finished.\n'
      break
      ;;
  esac
done < <(
  curl -sS -N --fail-with-body \
    "https://api.anthropic.com/v1/sessions/$SESSION_ID/stream" \
    -H "x-api-key: $ANTHROPIC_API_KEY" \
    -H "anthropic-version: 2023-06-01" \
    -H "anthropic-beta: managed-agents-2026-04-01" \
    -H "Accept: text/event-stream"
)

Агент напишет скрипт на 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.