Работа со службой агента Azure AI Foundry в Visual Studio Code (предварительная версия)

После начала работы с расширением AI Foundry vs Code вы можете работать со службой агента Azure AI Foundry. Агенты — это "умные" микрослужбы, которые:

• Ответы на вопросы с использованием их обучающих данных или поиска других источников с использованием технологии Retrieval Augmented Generation (RAG)
• Выполнение определенных действий
• Автоматизация завершенных рабочих процессов

Агенты объединяют модели ИИ с инструментами для доступа к данным и взаимодействия с ними.

Разработчики Azure AI Foundry могут работать эффективно, разрабатывая, тестируя и развертывая агенты в знакомой и мощной среде VS Code.

Это важно

Элементы, обозначенные в этой статье как (предварительная версия), сейчас предлагаются в общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания, и мы не рекомендуем ее для рабочих нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Для получения дополнительной информации см. Дополнительные условия использования для предварительных версий Microsoft Azure.

Создание и изменение агентов ИИ Azure в представлении конструктора

Выполните следующие действия, чтобы создать агент ИИ Azure:

1. Сначала заполните раздел "Начало работы ", чтобы войти в ресурсы Azure и задать проект по умолчанию.

2. Разверните модель для использования с агентом.

3. В представлении расширения Azure AI Foundry найдите раздел "Ресурсы ".

4. Щелкните значок (плюс) рядом + с подразделом "Агенты ", чтобы создать новый агент ИИ.

   

5. В диалоговом окне "Сохранить как" выберите каталог и введите имя нового файла агента ИИ .yaml.

6. Нажмите кнопку "Сохранить файл агента" , чтобы сохранить файл агента ИИ.

   

Взаимодействуйте с агентом в конструкторе

После выбора места сохранения откроются файл агента .yaml и режим конструктора для редактирования вашего агента ИИ.

1. Выполните следующие задачи в конструкторе агентов:

   1. Введите имя агента в запросе.

   2. Введите имя развертывания модели. Имя развертывания, выбранное при развертывании существующей модели.

      Подсказка

      Имя развертывания модели должно быть точным именем, выбранным для модели, развернутой в проекте Azure AI Foundry. На следующем рисунке представлено имя развертывания модели, gpt-4o-1 выбранное при развертывании. gpt-4o — имя модели.

   3. Настройте следующие поля. Идентификатор создается расширением:

      • Добавление описания агента
      • Настройка системных инструкций
      • Настройка инструментов для использования агентами

      

   4. Чтобы сохранить YAML-файл, выберите "Сохранить файл>" в строке меню VS Code.

Изучение определения YAML агента ИИ Azure

Файл .yaml вашего агента ИИ был открыт одновременно с дизайнерским программным обеспечением. Этот файл содержит сведения и сведения о настройке агента, аналогичные следующему примеру yaml-файла:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Добавление средств в агент ИИ Azure

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

Доступные средства для агентов ИИ Azure

Доступны следующие средства:

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

  • Ориентирование с помощью поиска Bing
  • Поиск по файлам
  • Поиск по искусственному интеллекту Azure
  • Microsoft Fabric

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

• Вызов функций агента искусственного интеллекта Azure

Служба агента Azure AI Foundry содержит набор знаний и средств действий, которые можно использовать для взаимодействия с источниками данных, например:

• Ориентирование с помощью поиска Bing
• Поиск по искусственному интеллекту Azure
• Функции Azure
• Поиск по файлам
• Интерпретатор кода
• Указанные средства OpenAPI
• SharePoint

Настройте YAML-файл инструментов

Конструктор агентов добавляет средства в агент ИИ через yaml-файлы.

Создайте yaml-файл конфигурации средства, выполнив следующие действия.

1. Выберите средство из доступных средств для агентов ИИ Azure. Выполните все действия по настройке, которые могут потребоваться. Например, приземление с помощью поиска Bing.

2. После завершения установки создайте файл кода yaml, указывающий конфигурацию средства. Например, этот формат для приземления с помощью Bing Search:

   type: bing_grounding
   options:
     tool_connections:
       - >-
         /subscriptions/<Azure Subscription ID>/resourceGroups/<Azure Resource Group name>/providers/Microsoft.MachineLearningServices/workspaces/<Azure AI Foundry Project name>/connections/<Bing connection name>
   

3. Замените заполнители в строке tool_connections подключения в разделе сведениями:

   • Идентификатор подписки Azure
   • Имя группы ресурсов Azure
   • Имя проекта Azure AI Foundry
   • Имя подключения Bing

4. Чтобы сохранить YAML-файл, выберите "Сохранить файл>" в строке меню VS Code.

Подключение файла средств к агенту ИИ

Добавьте средство в агент ИИ, выполнив следующие действия.

1. Выберите + пиктограмму (плюс) рядом с разделом TOOL в конструкторе.

   

2. В появившемся проводнике выберите файл средства yaml для использования. Нажмите кнопку "Выбрать файл средства", чтобы добавить средство в агент.

   

3. Инструмент отображается в разделе TOOL.

   

4. Чтобы сохранить YAML-файл, выберите "Сохранить файл>" в строке меню VS Code.

Развертывание агентов ИИ Azure в Azure AI Foundry Studio

Разверните агент непосредственно в Azure AI Foundry, выполнив следующие действия.

1. Нажмите кнопку Развернуть в Azure AI Foundry в нижнем левом углу дизайнера.

   

2. На панели навигации VS Code обновите представление ресурсов Azure . Развернутый агент отображается в подразделе "Агенты ".

   

Просмотр сведений о развернутом агенте ИИ

При выборе развернутого агента откроется страница "Параметры агента " в режиме только для просмотра.

• Выберите файл Open Yaml, чтобы просмотреть определение yaml агента.

• Нажмите кнопку "Открыть игровую площадку" , чтобы открыть игровую площадку агента.

  

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

Откройте игровую площадку агентов , выполнив следующие действия.

1. Щелкните правой кнопкой мыши развернутый агент и выберите параметр Open Playground . Это действие запускает поток с агентом и позволяет отправлять сообщения.

2. Кроме того, выберите ссылку Agent Playground в подразделе Инструменты и выберите вашего агента в списке в верхней центральной части.

3. Отображается страница "Детская площадка ".

   

4. Введите запрос и просмотрите выходные данные. Инструмент "Grounding с поиском Bing" используется для поиска информации в Интернете. Агент использует модель и средства, настроенные в конструкторе агентов. Источник информации отображается в разделе "Заметки агента ", выделенный на следующем рисунке.

   

Изучение потоков

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

Просмотр сведений о теме

Выберите поток, чтобы просмотреть страницу сведений о потоке .

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

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

• Запуск — это одно выполнение агента. Каждый запуск может иметь несколько потоков, и каждый поток может содержать несколько сообщений. Агент использует свою конфигурацию и сообщения потока для выполнения задач путем вызова моделей и инструментов. В рамках запуска агент добавляет сообщения в нить.

Просмотр сведений о запуске

Нажмите кнопку "Просмотр сведений о выполнении" на странице " Сведения о потоке ", чтобы просмотреть сведения о выполнении в JSON-файле.

Очистка ресурсов

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

Удалите ваших агентов

Подсказка

Так как вы можете настроить левую панель на портале Azure AI Foundry, вы можете увидеть различные элементы, отличные от указанных в этих шагах. Если вы не видите, что вы ищете, выберите ... Подробнее в нижней части левой панели.

Удалите развернутого агента на онлайн-портале AI Foundry. Выберите агенты в меню навигации слева, выберите агент, а затем нажмите кнопку "Удалить ".

Удалите ваши модели

1. На панели навигации VS Code обновите представление ресурсов Azure . Разверните подраздел "Модели" , чтобы отобразить список развернутых моделей.

2. Щелкните правой кнопкой мыши развернутую модель, чтобы удалить и выберите параметр "Удалить ".

   

Удалите ваши инструменты

Удалите подключенную программу, выполнив следующие действия.

1. Откройте портал Azure.
2. Выберите группу ресурсов Azure, содержащую средство.
3. Нажмите кнопку "Удалить ".

Дальнейшие действия

• Узнайте о средствах, которые можно использовать с агентами ИИ Azure, такими как поиск файлов или интерпретатор кода.