Каковы инструменты в службе агента Foundry?

Чтобы наделить вашего агента ИИ привязкой данных или возможностью выполнять действия и автоматизировать рабочие процессы, служба агента Foundry предоставляет широкий спектр встроенных инструментов, таких как привязка данных с помощью поиска Bing, поиск ИИ Azure, Azure Logic Apps, а также инструменты от сторонних партнеров, таких как Tripadvisor. Эта страница предназначена для предоставления обзора инструментов, предоставляемых в службе агента Foundry.

Средства знаний

Чтобы агент ИИ был информирован с более богатым контекстом из различных источников данных. Служба агентства Foundry охватывает широкий спектр типов данных.

• частные данные: поиск в Azure AI, поиск файлов, Microsoft Fabric и многое другое
• общедоступные веб-данные: приземление с помощью поиска Bing
• лицензированные данные: Tripadvisor, Morningstar
• неструктурированные данные: поиск в Azure AI, поиск файлов
• структурированные данные: Microsoft Fabric и многое другое

Средства действий

Чтобы упростить рабочие процессы с помощью агента ИИ с возможностями выполнения действий, служба агента Foundry предоставляет различные средства действий для вас с различным уровнем гибкости, контроля и простоты интеграции:

• Средство глубокого исследования: веб-интегрированный конвейер глубокого исследования с моделью o3-deep-research и заземлением с помощью Bing Search.
• Azure Logic Apps: решение с низким кодом или без кода для добавления рабочего процесса в агент ИИ
• Средство Спецификации OpenAPI: добавьте существующую спецификацию OpenAPI API службы, которую вы хотите добавить в агент ИИ, без каких-либо незначительных изменений.
• Средство MCP: интегрируйте существующую конечную точку протокола модельного контекста (MCP) в ваш агент ИИ.
• Вызов функции: напишите собственные пользовательские функции без отслеживания состояния, чтобы определить ожидаемое поведение.
• Функции Azure. Создание и управление собственными пользовательскими функциями с отслеживанием состояния.
• Автоматизация браузера: выполнение реальных задач браузера с помощью запросов естественного языка.

Как работает инструмент внутри службы агента Foundry?

Инструменты — это необязательные возможности, которые можно добавить в агент ИИ, чтобы модели ИИ могли принимать решения и выбирать на основе пользовательского запроса и контекста. Когда пользователь отправляет запрос, модель ИИ определяет намерение с контекстом и потенциально перезаписывает запрос пользователя. Затем модель ИИ решает, какие средства следует вызывать для каждого запуска. Например, если вы добавите инструмент связи Bing Search и инструмент Azure AI Search в вашего агента и спросите "какая сегодня погода в Сиэтле?", модель определит ваше намерение узнать информацию о текущей ситуации и, вероятнее всего, применит инструмент Bing Search для связи.

Вы можете добавить инструменты на уровне агента, потока или выполнения. При предоставлении инструментов на более узком уровне, ресурсы этих инструментов будут переопределять ресурсы инструментов на более широком уровне. Например, ресурсы инструмента на уровне выполнения переопределяют ресурсы инструмента на уровне потока. В настоящее время можно добавить несколько инструментов, но вы можете добавить один экземпляр каждого из следующих средств: поиск файлов, поиск ИИ Azure, приземление с помощью службы "Поиск Bing", "Приземление" с помощью пользовательского поиска Bing, Microsoft Fabric и других средств в разделе.knowledge

Когда пользователь отправляет запрос агенту, он создаст поток, запуск и сообщение. Для каждого запуска модель ИИ решает, какие средства следует вызывать на основе намерения пользователя и доступных ресурсов инструментов. На основе выходных данных средства модель ИИ может решить вызвать другое средство или снова вызвать то же средство, чтобы получить больше контекста. Например, при использовании средства "Поиск Bing" при трассировке потока может появиться несколько запросов поиска Bing. Это означает, что модель ИИ фактически вызывает заземление с помощью средства поиска Bing несколько раз с различными запросами, чтобы получить дополнительные сведения. Если вы хотите узнать больше о том, какие средства вызываются и как модель ИИ вызывает их, проверьте сведения о шаге выполнения.

Существуют различные способы влияния на то, как агент ИИ вызывает инструменты.

• Параметр tool_choice : наиболее детерминированный способ управления, который (если таковой) вызывается моделью. По умолчанию оно имеет значение auto, что означает, что модель искусственного интеллекта решит. Если вы хотите принудительно вызвать определенное средство, можно указать спецификацию этого средства, например

  run = project_client.agents.runs.create_and_process(
        thread_id=thread.id, 
        agent_id=agent.id,
        tool_choice={"type": "bing_grounding"}  # specify the tool to use
        )
  

• Параметр instructions : недетерминированный. Используйте инструкции, помогающие модели ИИ понять вариант использования и цели каждого средства. Вы хотите сообщить модели ИИ, какие сведения или действия могут выполнять каждый инструмент. Например, "используйте средство поиска ИИ для информации, связанной с продуктом, а средство Fabric <tool_name><tool_name> – для сведений, связанных с продажами". Иногда на запрос пользователя можно ответить базовыми знаниями модели или инструментами, и важно предоставить такие инструкции, как "используйте выходные данные инструмента для создания ответа, не полагайтесь на собственные знания."

Предпосылки

• Созданный агент
• Убедитесь, что вашей модели ИИ выделено достаточно токеновPer-Minute (TPM). Рекомендуем иметь минимум 30 тысяч транзакций в минуту. Вы можете изменить выделение TPM, перейдя к моделям и конечным точкам на портале Foundry и отредактировав свою модель.

Встроенные средства

Служба агента Foundry предоставляет следующие встроенные инструменты. Их можно использовать с помощью REST API, пакета SDK и портала Microsoft Foundry.

Средства сторонних корпораций

Следующие средства создаются сторонними партнерами. Чтобы просмотреть примеры документации и кода, воспользуйтесь приведенными ниже ссылками.

Лучшие практики

Используйте системную инструкцию, чтобы помочь модели вызвать правильное средство

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

• Основная цель: какова цель этого агента? какова цель связанных задач? Каковы ожидаемые результаты?
• Ваши обязанности: какие задачи вы ожидаете от агента. Например, чтобы получить последние сведения о локальных событиях, вызовите средство "Заземление" с помощью средства поиска Bing.
• Возможные входные данные: какие входные данные вы ожидаете, что агент получит?
• Для каждого инструмента:
  • Название инструмента
  • Описание средства
  • Триггеры: когда вы ожидаете, что этот инструмент будет вызываться? Какой тип информации будет искать? Что будет содержать запросы?
  • Пример запроса

Например, вы можете предоставить инструкции по использованию инструмента, как для средства Grounding с поиском Bing:

Приземление с помощью средства поиска Bing

• Использование: сбор внешних тенденций или новостей для обогащения публикации с помощью аналитических сведений в режиме реального времени.
• Активируйте это, когда:
  • Пользователь просит ссылаться на последние данные или конкурентный контекст.
  • Пример: "Можно ли ссылаться на последние тенденции отрасли?" или "Что делают конкуренты?".