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