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

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

  • Статья

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

Векторизаторы используются во время запроса, но указываются в определениях индекса и ссылаются на поля векторов через профиль вектора. Векторизатор Azure OpenAI вызывается AzureOpenAIVectorizer в API.

Примечание.

Этот векторизатор привязан к Azure OpenAI и взимается по существующей цене с оплатой Azure OpenAI по мере использования.

Необходимые компоненты

Служба Azure OpenAI должна иметь связанный настраиваемый поддомен. Если служба была создана с помощью портал Azure, этот поддомен автоматически создается в рамках настройки службы. Убедитесь, что служба включает в себя настраиваемый поддомен перед его использованием с интеграцией поиска ИИ Azure.

Ресурсы Службы OpenAI Azure (с доступом к моделям внедрения), созданным в AI Studio, не поддерживаются. Только ресурсы службы Azure OpenAI, созданные в портал Azure, совместимы с интеграцией навыков внедрения Azure OpenAI.

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

Параметры зависят от регистра.

Наименование параметра Description
resourceUri Универсальный код ресурса (URI) поставщика моделей в данном случае — ресурс Azure OpenAI. Этот параметр поддерживает только URL-адреса с доменом openai.azure.com, например https://<resourcename>.openai.azure.com. Если конечная точка Azure OpenAI имеет URL-адрес с доменом cognitiveservices.azure.com, например https://<resourcename>.cognitiveservices.azure.com, настраиваемый поддомен должен openai.azure.com быть создан сначала для ресурса Azure OpenAI и использовать https://<resourcename>.openai.azure.com его.
apiKey Секретный ключ, используемый для доступа к модели. Если вы предоставляете ключ, оставьте authIdentity пустым. Если задано и apiKey то, и authIdentityдругое apiKey значение используется в соединении.
deploymentId Имя развернутой модели внедрения Azure OpenAI. Модель должна быть моделью внедрения, например text-embedding-ada-002. Список моделей Azure OpenAI для поддерживаемых моделей.
authIdentity Управляемое пользователем удостоверение, используемое службой поиска для подключения к Azure OpenAI. Вы можете использовать системное или пользовательское управляемое удостоверение. Чтобы использовать системное удостоверение, оставьте и authIdentity оставьте apiKey пустым. Управляемое системой удостоверение используется автоматически. Управляемое удостоверение должно иметь разрешения пользователя OpenAI Cognitive Services для отправки текста в Azure OpenAI .
modelName (Требуется в API версии 2024-05-01-Preview и более поздних версиях). Имя модели внедрения Azure OpenAI, развернутой на предоставленном иdeploymentId.resourceUri В настоящее время поддерживаются 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",
        },
    }
]

См. также