Поделиться через


Векторизатор Azure OpenAI

Векторизатор Azure OpenAI подключается к модели внедрения, развернутой в ресурсе Azure OpenAIв Foundry Models или проекте Microsoft Foundry для создания внедрения во время запроса. Данные обрабатываются в географическом расположении, где развернута модель.

Хотя векторизаторы используются во время запроса, вы указываете их в определениях индекса и ссылаетесь на них на поля векторов через профиль вектора. Дополнительные сведения см. в разделе "Настройка векторизатора" в индексе поиска.

Векторизатор Azure OpenAI вызывается AzureOpenAIVectorizer в REST API. Используйте последнюю стабильную версию индексов— создайте (REST API) или пакет azure SDK, предоставляющий эту функцию.

Note

Этот векторизатор привязан к Azure OpenAI и взимается по цене Azure OpenAI Standard.

Prerequisites

  • Ресурс Azure OpenAI в foundry Models или проект Foundry.

    • Ресурс Azure OpenAI должен иметь настраиваемый поддомен, например https://<resource-name>.openai.azure.com. Эту конечную точку можно найти на странице "Ключи и конечная точка " на портале Azure и использовать его для resourceUri свойства в этом навыке.

    • Родительский ресурс проекта Foundry предоставляет доступ к нескольким конечным точкам, включая https://<resource-name>.openai.azure.com, https://<resource-name>.services.ai.azure.comи https://<resource-name>.cognitiveservices.azure.com. Эти конечные точки можно найти на странице "Ключи" и "Конечная точка " на портале Azure и использовать их для resourceUri свойства в этом навыке.

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

Параметры векторизатора

Параметры чувствительны к регистру.

Имя параметра Description
resourceUri (обязательно) Универсальный код ресурса (URI) поставщика модели. Поддерживаемые домены:

  • openai.azure.com
  • services.ai.azure.com
  • cognitiveservices.azure.com

Конечные точки управления API Azure поддерживаются с URL-адресомhttps://<resource-name>.azure-api.net. Общие частные ссылки не поддерживаются для конечных точек управления API.

apiKey Секретный ключ, используемый для доступа к модели. Если вы предоставляете ключ, оставьте authIdentity пустым. Если задано и то, apiKey и authIdentityдругое apiKey используется в соединении.
deploymentId (обязательно) Идентификатор развернутой модели внедрения Azure OpenAI. Это имя развертывания, указанное при развертывании модели.
authIdentity Управляемое пользователем удостоверение, используемое службой поиска для подключения. Вы можете использовать системное или управляемое пользователем удостоверение. Чтобы использовать управляемое системой удостоверение, оставьте и authIdentity оставьте apiKey пустым. Управляемое системой удостоверение используется автоматически. Управляемое удостоверение должно иметь разрешения пользователя OpenAI Cognitive Services для отправки текста в Azure OpenAI .
modelName (обязательно) Имя модели Azure OpenAI, развернутой по указанному адресу deploymentId. Поддерживаются значения:

  • text-embedding-ada-002
  • text-embedding-3-large
  • text-embedding-3-small

Поддерживаемые типы векторных запросов

Векторизатор Azure OpenAI поддерживает text только векторные запросы.

Ожидаемые измерения поля

Ожидаемые измерения полей для поля, настроенного с помощью векторизатора Azure OpenAI, зависят от modelName настроенного.

modelName Минимальные измерения Максимальные размеры
text-embedding-ada-002 1536 1536
text-embedding-3-large 1 3072
text-embedding-3-small 1 1536

Пример определения

"vectorizers": [
    {
        "name": "my-openai-vectorizer",
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
            "resourceUri": "https://my-fake-azure-openai-resource.openai.azure.com",
            "apiKey": "0000000000000000000000000000000000000",
            "deploymentId": "my-ada-002-deployment",
            "authIdentity": null,
            "modelName": "text-embedding-ada-002",
        },
    }
]

См. также