Рекомендации по использованию инструментов для Microsoft Foundry Agent Service

При создании агентов в службе агента Foundry Microsoft средства расширяют возможности агента— получение сведений, вызов API и подключение к внешним службам. Эта статья поможет вам эффективно настроить инструменты, контролировать, когда агент их вызывает, и защитить ваши данные.

Необходимые условия

• Доступ к проекту Foundry в портале Foundry с ролью Azure AI Developer или эквивалентными разрешениями.
• Модель, развернутая в том же проекте.
• Все необходимые подключения, настроенные для инструментов, которые вы планируете использовать (например, Поиск с использованием ИИ Azure, SharePoint или Bing Grounding).

Настройка и проверка использования средства

• Настройте средства и подключения в каталоге инструментов Foundry. См. статью "Обнаружение и управление средствами" в каталоге инструментов Foundry (предварительная версия).
• Просмотрите трассировки выполнения, чтобы подтвердить, когда агент вызывает средства и проверяет входные и выходные данные средства. Сведения о сквозной настройке трассировки см. в разделе "Трассировка приложения".

Повысьте надежность вызова инструментов

Вызов средства управления с помощью tool_choice

Используйте tool_choice для наиболее детерминированного управления вызовом инструментов.

• auto: Эта модель решает, следует ли вызывать инструменты.
• required: модель должна вызывать один или несколько инструментов.
• none: Эта модель не вызывает инструменты.

Дополнительные сведения см. в tool_choiceREST Foundry project (предварительная версия).

Написание эффективных инструкций по инструменту

• Инструкции должны быть конкретными и согласованными с конфигурацией вашего инструмента.
• Расскажите модели о том, для чего предназначено каждое средство.
• Если у вас несколько инструментов, перекрывающихся, добавьте правило принятия решений (например, "Использовать поиск файлов перед поиском в Интернете для внутреннего содержимого".)

Безопасное использование инструмента

Средства отправляют и получают данные за пределами модели. Уменьшите риски безопасности и конфиденциальности с помощью следующих методик:

• Считайте выходные данные инструмента ненадёжными входными данными и проверяйте критически важные значения, прежде чем их использовать.
• Отправьте только сведения, необходимые для выполнения задачи.
• Не включайте ключи, токены или другие учетные данные в запросы.
• Не записывайте секретные данные в трассировке или журналах приложений.
• Если вы подключаетесь к службам, не принадлежащим Microsoft (например, к сторонним серверам MCP), ознакомьтесь с рекомендациями, приведёнными в разделе Обнаружение инструментов и управление ими в каталоге инструментов Foundry (предварительная версия).
• Если вам нужна централизованная маршрутизация и применение политик для средств MCP, см. статью "Управление средствами с помощью шлюза искусственного интеллекта (предварительная версия)".

Поддержка инструментов по регионам и моделям

Регион и модель определяют, какие средства доступны агенту.

В следующей таблице показана доступность инструментов по регионам.

Средства поддерживаются следующими моделями.

Устранение неполадок

Используйте эти проверки для устранения распространенных проблем:

• Агент не вызывает инструмент:
  • Убедитесь, что инструмент подключён к агенту.
  • Подтвердите, что модель поддерживает средство.
  • Если требуется детерминированное поведение, установите значение tool_choicerequired.
  • Проверьте трассировки выполнения, чтобы подтвердить, сгенерировала ли модель вызов инструмента.
• Вызовы инструментов возвращают пустые или неуместные результаты:
  • Улучшение описаний инструментов и инструкций агента.
  • Для инструментов поиска убедитесь, что ваши данные загружены и доступны для поиска.
• Сбой вызовов инструментов:
  • Проверка конфигурации и проверки подлинности средства.
  • Для инструментов MCP и OpenAPI убедитесь, что конечная точка доступна и возвращает ожидаемые ответы.
• Foundry возвращает ошибку "средство не поддерживается", даже если таблицы показывают поддержку:
  • Для доступности инструментов требуется поддержка как модели, так и региона. Проверьте таблицу доступности региона для региона и таблицу поддержки модели для модели. Если в любом из них отображается No, инструмент не может быть запущен, даже если в другом отображается Yes.
  • Убедитесь, что модель фактически развернута в проекте и регионе, на который вы нацелены. Модель, которая поддерживает средство в целом, не может быть развернута в каждом регионе.
  • Попробуйте другой регион или другое развертывание модели, которое поддерживает этот инструмент. Например, интерпретатор кода не работает в регионах, где для Интерпретатора кода отображается no (например, southcentralus и spaincentral), независимо от того, какую модель вы используете.

Вопросы и ответы

Как проверить, был ли вызван инструмент?

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

Как сделать использование инструментов более надежным?

Начните с четких инструкций по инструменту. Если вам нужен детерминированный вызов средства, используйте tool_choice. Дополнительные сведения см. в разделе Управление вызовом инструментов с помощью tool_choice.

Связанное содержимое

Управление инструментами

• Обнаружение средств и управление ими в каталоге инструментов Foundry (предварительная версия)
• Управление средствами с помощью шлюза ИИ (предварительная версия)

Инструменты извлечения и поиска

• Поиск с использованием ИИ Azure
• Поиск по файлам
• Поиск в Интернете
• Приземление с помощью инструментов Bing
• SharePoint (предварительная версия)

Средства обработки данных и интеграции

• Агент данных Fabric (предварительная версия)
• Протокол контекста модели (MCP) (предварительная версия)
• Средство OpenAPI
• Вызов функции

Инструменты автоматизации и генерации

• Интерпретатор кода
• Автоматизация браузера (предварительная версия)
• Использование компьютера (предварительная версия)
• Создание изображений (предварительная версия)
• Средство Agent2Agent (A2A) (предварительная версия)