Как устроен цикл работы агента

О чём урок

Видео: «Принцип работы agent»

Вы уже делали вызовы API, но один вызов возвращает лишь один ответ. Если вы хотите автоматизировать workflow, Claude должен действовать, анализировать результат, решать, что делать дальше, и продолжать работу. Именно этот шаблон имеют в виду, когда говорят об agentic workflows.

Agent — это автономная версия Claude, которая управляет обеими сторонами цикла обмена сообщениями без участия человека. Agent получает задачу, выбирает tool и выполняет код в цикле до тех пор, пока Claude не решит, что задача выполнена.

Самый простой способ реализовать agent loop выглядит так:

1. Отправьте сообщение Claude с доступными tools.
2. Claude отвечает либо окончательным ответом, либо запросом на использование определенного вами tool.
3. Ваш код выполняет этот tool.
4. Вы отправляете результат обратно Claude.
5. Повторяйте, пока stop reason не станет end_turn.

Представьте это как разговор, где ходы чередуются: пользователь начинает, agent вызывает tool, tool возвращает результат, и agent продолжает работу, пока не получит ответ.

Чтобы увидеть этот loop в действии от начала до конца, не прибегая к базе данных или UI, мы подключим фиктивный tool под названием get_weather и спросим Claude, что надеть сегодня в Остине. Claude не может узнать погоду самостоятельно, поэтому ему придется вызвать tool, прочитать результат, а затем дать вам ответ.

Вот весь скрипт:

Три важных момента:

• Массив tools сообщает Claude, что доступно: имя, описание и JSON-схема для входных данных.
• run_tool — это просто жестко закодированный поиск. В реальном приложении это обратилось бы к вашей базе данных, API или чему-либо еще.
• Loop — это agent loop. Каждая итерация отправляет сообщения Claude и реагирует в зависимости от stop reason ответа. При end_turn Claude завершает работу — выведите окончательный текст и прервите выполнение. При tool_use найдите блоки tool use, выполните каждый из них, добавьте ответ ассистента и результаты ваших tools обратно в messages, и снова запустите loop, чтобы Claude мог ответить.

Когда вы запустите скрипт, вы…

План урока

1. Что такое agent на самом деле
2. Минимальный рабочий пример
3. Запуск
4. Тот же loop в production
5. Итоги