Какие инструменты доступны в службе агента Foundry? (классическая)

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

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

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

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

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

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

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

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

Средства — это необязательные возможности, которые можно добавить в агент ИИ, чтобы модели ИИ могли принимать решения и выбирать в зависимости от пользовательского запроса и контекста. Когда пользователь отправляет запрос, модель ИИ определяет намерение с контекстом и потенциально перезаписывает запрос пользователя. Затем модель ИИ решает, какие средства следует вызывать для каждого запуска. Например, если вы добавите в агент средство поиска Grounding with Bing и средство Поиск с использованием ИИ Azure, а затем спросите: "какая сегодня погода в Сиэтле?", модель определит ваше намерение спросить о погоде в режиме реального времени и, скорее всего, запустит средство поиска Grounding with Bing.

Вы можете добавить инструменты на уровне агента, потока или запуска. Предоставляя средства на более узком уровне, ресурсы инструментов переопределяют ресурсы инструментов на более широком уровне. Например, ресурсы инструментов на уровне исполнения переопределяют ресурсы инструментов на уровне потока.

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

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

Существует два основных способа повлиять на то, как агент ИИ вызывает инструменты:

Используя tool_choice

Параметр 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

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

• Маршрут к конкретным инструментам: "Использовать инструмент поиска ИИ <tool_name> для сведений, связанных с продуктом, используйте инструмент Fabric <tool_name> для сведений, связанных с продажами.".
• Предпочитайте инструменты по сравнению с базовыми знаниями: "Используйте выходные данные средства для создания ответа, не используйте собственные знания".
• Описание возможностей инструментов: "Средство поиска Bing имеет доступ к информации в режиме реального времени, включая текущую погоду, новости и цены на акции".

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

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

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

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

Средства, отличные от Microsoft

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

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

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

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

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

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

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

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