Собираем первого управляемого агента

О чём урок

Создание вашего первого управляемого агента Если вы когда-либо создавали цикл агента вручную, то знаете, что это такое: циклы while, переключатели условий остановки, выполнение инструментов. Это работает, и для многих функций такой подход вполне уместен. Но иногда такой цикл может выполняться очень долго — минуты, а то и часы — задействуя множество инструментов, с необходимостью сохранять состояние, записывать файлы и возобновлять работу после сбоя сети. В такой ситуации вы не захотите запускать этот цикл на своём сервере. Вы захотите делегировать его. Именно для этого и нужны управляемые агенты. Управляемый агент — это цикл агента, который выполняется на инфраструктуре Anthropic, а не на вашей. Вы описываете агента один раз, предоставляете ему среду для работы и запускаете сессию. Anthropic выполняет цикл, а вы просто получаете поток событий по мере его работы. Управляемые агенты включены по умолчанию для каждой учётной записи API — специальный доступ не требуется. Существует четыре примитива, и они следуют в определённом порядке: Агент — персона: model, системный prompt и toolset. Он многократно используется в разных запусках. Среда — место выполнения агента: cloud или self-hosted, networking config и так далее. Сессия — единичный запуск агента в определённой среде. Сессия является единицей работы. События — сообщения, поступающие и исходящие: действия агента, вызовы инструментов, результаты, ответы. Вот как эти части взаимодействуют: ваше приложение общается с сессией, сессия управляет работой внутри среды, и всё происходящее передаётся обратно через поток событий: Обратите внимание на изменение подхода: вы не запускаете цикл while. Вы отправляете события и читаете события. Давайте создадим самый простой управляемый агент, который выполняет полезную задачу: создаёт файл во временном каталоге, подсчитывает количество строк в нём и сообщает результат. В качестве инструментов мы будем использовать agent toolset — встроенные файловые, bash- и веб-инструменты Anthropic. Они отлично подходят для этой задачи, поэтому нам не нужно определять какие-либо инструменты самостоятельно. Сначала мы создаём агента.

План урока

1. Что такое управляемый агент?
2. Четыре примитива
3. Самый простой управляемый агент
4. Шаг 1: Создание агента
5. Шаг 2: Создание среды
6. Шаг 3: Создание сессии
7. Шаг 4: Открытие потока, затем отправка стартового сообщения
8. Шаг 5: Обработка потока