Перейти к основному содержимому

Создание агентов на API

Продвинутый
What you'll learn
  • Определить, что на самом деле представляет собой агент: модель, работающая в цикле
  • Применить тест на выбор, чтобы определиться между одним вызовом, рабочим процессом и агентом
  • Спроектировать минимальный цикл агента с правильными защитными ограничениями
  • Понимать, когда стоит взять Claude Agent SDK вместо написания всего вручную
  • Сделать агента устойчивым: ограничьте его, обрабатывайте сбои, ограничьте привилегии, оценивайте его

Агент — это модель, работающая в цикле: она преследует цель, вызывая инструменты, наблюдая за результатами и принимая решение о следующем шаге, пока задача не будет выполнена. Прежде чем создавать его, выберите самое простое решение, которое работает.

Тест на выбор (не усложняйте)​

Не каждая задача требует агента. Сначала пройдите по этому дереву — большинство задач останавливается на самом верху.

Три варианта, от самого простого:

  • Один вызов — на запрос отвечает один промпт. Большинство задач. Самый дешёвый и надёжный вариант.
  • Рабочий процесс — вы оркестрируете фиксированную последовательность вызовов в коде (детерминированный поток управления). Используйте, когда шаги известны.
  • Агент — модель сама динамически определяет шаги. Используйте только тогда, когда путь действительно невозможно жёстко задать.
Watch out

Прибегайте к агенту, когда адаптивность — это суть, а не потому что это звучит впечатляюще. Контролируемый вами рабочий процесс легче тестировать и отлаживать.

Проектирование цикла​

Минимальный собственный агент — это всего четыре подвижных части. Создавайте их в таком порядке:

Guided walkthrough1 of 4
  1. Сформулируйте цель, ограничения и доступные инструменты. Именно на это модель опирается в рассуждениях на каждом шаге.

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

Pro tip

Прежде чем писать собственный цикл, задайтесь вопросом, не покрывает ли его уже Agent SDK. Он поставляется с циклом, разрешениями и обработкой контекста, чтобы вы могли сосредоточиться на инструментах и цели.

Сделайте его устойчивым​

Цикл, который может вызывать инструменты, также может вести себя некорректно. Четыре привычки помогают сохранить агента надёжным:

  • Ограничивайте всё: итерации, время, стоимость. Агенты могут зацикливаться.
  • Корректно обрабатывайте сбои инструментов (возвращайте ошибку как результат).
  • Минимум привилегий + человек в цикле для рискованных действий — см. Защита агентов.
  • Оценивайте его на реальных кейсах, прежде чем доверять ему — см. Оценки.
Key takeaways
  • Агент — это модель в цикле, вызывающая инструменты для достижения цели — используйте его только тогда, когда путь нельзя жёстко задать
  • Порядок выбора: один вызов → рабочий процесс → агент → управляемые агенты; предпочитайте самый простой работающий вариант
  • Минимальный цикл = системный промпт + цикл tool_use/tool_result + защитные ограничения + управление контекстом
  • Claude Agent SDK поставляется с циклом, инструментами, разрешениями и обработкой контекста за вас
  • Устойчивость = ограничение итераций/времени/стоимости, обработка сбоев инструментов, минимум привилегий + человек в цикле и оценка до того, как доверять

Проверьте себя​

Проверьте себя

0/5
  1. Что лучше всего описывает агента в данном контексте?
  2. У задачи фиксированные, известные шаги. Что стоит взять?
  3. Когда собственный агент действительно оправдан?
  4. Что происходит в цикле, когда модель отвечает с tool_use?
  5. Что НЕ является одним из защитных ограничений для устойчивости агента?

Далее​