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

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

Основные понятия

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

• Учётная запись Claude Console
• Ключ API

Установка CLI

brew install anthropics/tap/ant

VERSION=1.38.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

go install github.com/anthropics/anthropic-cli/cmd/ant@latest

export PATH="$PATH:$(go env GOPATH)/bin"

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

ant --version

Установка SDK

pip install anthropic

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

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

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

1. 1

   Создайте агента

   Создайте агента, который определяет модель, «system prompt» (системную подсказку) и доступные инструменты.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply coding-assistant.md

   coding-assistant.md

   

   ---
   name: Coding Assistant
   model: claude-opus-5-5
   tools:
     - type: agent_toolset_20260401
   ---
   
   You are a helpful coding assistant. Write clean, well-documented code.

   ant apply выводит ID агента и записывает его в claude-lock.json. Вы будете ссылаться на него в каждой создаваемой сессии.

   Тип инструмента agent_toolset_20260401 включает полный набор готовых инструментов агента (bash, файловые операции, веб-поиск и другие). Полный список и параметры настройки для каждого инструмента см. в разделе Инструменты.

2. 2

   Создайте окружение

   Окружение определяет «sandbox» (песочницу), в которой работает ваш агент.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply environment.yaml

   environment.yaml

   

   # yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
   name: quickstart-env
   config:
     type: cloud
     networking:
       type: limited
       allow_package_managers: true

   ant apply также записывает ID среды в claude-lock.json. Чтобы создать агента и среду одной командой, передайте оба файла: ant apply coding-assistant.md environment.yaml.

3. 3

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

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

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   session = client.beta.sessions.create(
       agent=agent.id,
       environment_id=environment.id,
       title="Quickstart session",
   )
   
   print(f"Session ID: {session.id}")

4. 4

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

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

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   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:
                       if block.type == "text":
                           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:

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

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

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

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