← Создание агентов на Cloudflare / agents / tools

Code Mode

Code Mode: паттерн использования инструментов, при котором модель пишет код вместо того, чтобы запрашивать каждую операцию по отдельности. Модель получает один инструмент для выполнения кода. Её код становится компактным планом, который вызывает инструменты, обрабатывает результаты и возвращает информацию, необходимую для ответа.

Code Mode предоставляет настроенные инструменты в виде типизированных методов. Модели используют эти методы, чтобы выражать многошаговую работу с помощью привычных программных конструкций. В зависимости от интеграции определения инструментов можно предоставить заранее или обнаруживать по мере необходимости.

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

Code Mode переносит эту промежуточную логику в исполняемый код. Один план может:

• Комбинируйте несколько зависимых вызовов инструментов.
• Перебирайте коллекции результатов.
• Фильтруйте и преобразуйте возвращённые данные.
• Ветвитесь на основе более ранних результатов.
• Формируйте итоговое возвращаемое значение.

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

Большие каталоги инструментов могут занимать значительную часть контекста модели, если загружать все определения заранее. Среды выполнения Code Mode на основе коннекторов поддерживают постепенное обнаружение через codemode.search() и codemode.describe().

Search находит релевантные коннекторы, методы и сохранённые фрагменты кода. Describe возвращает подробную информацию о типе для выбранной цели. Эти результаты попадают в выполняемый код, поэтому модель может получать только нужные ей определения, а не весь каталог целиком при каждом запросе.

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

Code Mode выполняет всю эту работу в рамках одного запуска в песочнице. Сгенерированный код может передавать результаты между инструментами, фильтровать промежуточные данные и возвращать только конечное значение, нужное модели. Благодаря этому задачи с несколькими инструментами становятся эффективнее и их проще обобщать или повторять.

Используйте прямые вызовы инструментов для простых задач с небольшим фиксированным набором инструментов. Используйте Code Mode, если задаче нужна композиция, зависимые вызовы, постепенное обнаружение, переиспользуемая логика или управление потоком выполнения:

Code Mode предоставляет поверхности для runtime агентов, ИИ-фреймворков, браузеров и систем Model Context Protocol (MCP).