инструмент Поиск с использованием ИИ Azure (классический)

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

В этой статье описывается настройка средства Поиск с использованием ИИ Azure, включая создание подключения к проекту и добавление средства в агент.

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

• Агент Microsoft Foundry.

• Индекс Поиск с использованием ИИ Azure, настроенный для векторного поиска. Индекс должен содержать следующее:

  • Одно или несколько Edm.String (текстовых) полей, атрибутируемых как доступные для поиска и извлекаемые.

  • Одно или несколько Collection(Edm.Single) полей (вектора), атрибутируемых как доступные для поиска.

Поддержка использования

Ограничения

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

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

• Ресурс Foundry с базовыми развертываниями агентов не поддерживает закрытые ресурсы Поиск с использованием ИИ Azure, а также ресурсы Поиск с использованием ИИ Azure с отключенным доступом к публичной сети и с частной конечной точкой. Чтобы использовать частный инструмент Поиск с использованием ИИ Azure с вашими агентами, разверните стандартного агента с инъекцией виртуальной сети.

• Если вы отключили доступ к общедоступной сети в ресурсе Поиск с использованием ИИ Azure, настройте подключение для использования управляемого удостоверения (бессерверная проверка подлинности) вместо ключа API. Подключения на основе ключей API не могут достичь службы поиска с отключенным доступом к общедоступной сети.

• Ресурс Поиск с использованием ИИ Azure и агент Foundry должны находиться в одном клиенте.

Установка

В этом разделе описано, как создать подключение между проектом Foundry, содержащим агент и службу Поиск с использованием ИИ Azure, содержащую индекс.

Если проект уже подключен к службе поиска, пропустите этот раздел.

Получение сведений о подключении службы поиска

Для подключения к проекту требуется конечная точка службы поиска и проверка подлинности на основе ключей или бессерверная проверка подлинности с помощью Microsoft Entra ID.

Для проверки подлинности без ключа необходимо включить управление доступом на основе ролей (RBAC) и назначить роли управляемому удостоверению проекта. Хотя этот метод включает дополнительные шаги, он повышает безопасность, устраняя необходимость жестко закодированных ключей API.

Выберите вкладку для требуемого метода проверки подлинности.

Создание подключения проекта

Следующим шагом является создание подключения к проекту с помощью собранных сведений о службе поиска. Имя подключения должно быть именем индекса поиска. Дополнительные сведения об этом шаге см. в разделе "Добавление нового подключения к проекту".

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

name: my_project_acs_connection_keys
type: azure_ai_search
endpoint: https://contoso.search.windows.net/
api_key: XXXXXXXXXXXXXXX

name: my_project_acs_connection_keyless
type: azure_ai_search
endpoint: https://contoso.search.windows.net/

az ml connection create --file {connection.yml} --resource-group {my_resource_group} --workspace-name {my_project_name}

from azure.ai.ml.entities import AzureAISearchConnection

# Create an Azure AI Search project connection
my_connection_name = "my-connection-name"
my_endpoint = "my-endpoint" # This could also be called target
my_api_keys = None # Leave blank for Authentication type = AAD

my_connection = AzureAISearchConnection(name=my_connection_name,
                                    endpoint=my_endpoint, 
                                    api_key= my_api_keys)

# Create the connection
ml_client.connections.create_or_update(my_connection)

Добавьте инструмент к агенту

Вы можете добавить средство Поиск с использованием ИИ Azure в агент программным способом или на портале Foundry. Примеры программ см. в разделе Использование существующего индекса с помощью средства Поиск с использованием ИИ Azure.

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

1. В левой области выберите "Агенты".

2. Выберите агента из списка, а затем выберите Знания>Добавить.

   

3. Выберите Поиск с использованием ИИ Azure.

   

4. В разделе "Подключение к индексу" выберите индексы, которые не являются частью этого проекта.

5. В разделе подключение ресурса Поиск с использованием ИИ Azure выберите подключение к проекту, созданное в предыдущем разделе.

6. В разделе индекс Поиск с использованием ИИ Azure выберите векторный индекс.

   Совет

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

   После создания индекса его можно использовать как внутри, так и за пределами агента. Например, индекс можно использовать с Поиск с использованием ИИ Azure REST API или пакетами SDK.

7. В разделе Отображаемое имя введите имя индекса.

8. В зависимости от конфигурации индекса выберите один из следующих типов поиска:

   • Простой
   • Семантические
   • Вектор
   • Гибридная (vector + ключевое слово)
   • Гибридная и семантическая

   По умолчанию средство Поиск с использованием ИИ Azure выполняет гибридный поиск (вектор + ключевое слово) во всех текстовых полях.

9. Выберите Connect, чтобы добавить средство Поиск с использованием ИИ Azure в агент.

   

Следующий шаг

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