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

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

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

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

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

Note

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

Prerequisites

  • Ресурс Azure OpenAI в моделях Foundry или проект 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 Управляемая пользователем идентификация, используемая службой поиска для подключения. Вы можете использовать системное или управляемое пользователем удостоверение. Чтобы использовать управляемое системой удостоверение, оставьте apiKey и authIdentity пустыми. Управляемое системой удостоверение используется автоматически. Управляемое удостоверение должно иметь разрешения пользователя Cognitive Services OpenAI для отправки текста в 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",
        },
    }
]

См. также

  • Last updated on