Рекомендации по использованию средств для службы агента Foundry Microsoft

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

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

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

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

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

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

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

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

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

Дополнительные сведения смtool_choice. в разделе REST проекта Foundry (предварительная версия).

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

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

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

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

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

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

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

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

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

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

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

• Агент не вызывает средство:
  • Убедитесь, что средство подключено к агенту.
  • Подтвердите, что модель поддерживает средство.
  • Если требуется детерминированное поведение, установите значение tool_choicerequired.
  • Проверьте трассировки выполнения, чтобы убедиться, что модель вызвала средство.
• Вызовы инструментов возвращают пустые или неуместные результаты:
  • Улучшение описаний инструментов и инструкций агента.
  • Для средств получения убедитесь, что данные будут приемны и доступны для поиска.
• Сбой вызовов инструментов:
  • Проверка конфигурации и проверки подлинности средства.
  • Для средств MCP и OpenAPI убедитесь, что конечная точка недоступна и возвращает ожидаемые ответы.

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

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

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

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

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

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

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

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

Средства получения и поиска

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

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

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

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

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