Azure OpenAI 벡터라이저

  • 아티클

Azure OpenAI 벡터라이저는 Azure OpenAI 리소스에 배포된 포함 모델에 연결하여 쿼리 시 포함을 생성합니다. 데이터는 모델이 배포된 지역에서 처리됩니다.

벡터라이저는 쿼리 시 사용되지만 인덱스 정의에 지정되고 벡터 프로필을 통해 벡터 필드에서 참조됩니다. Azure OpenAI 벡터라이저는 API에서 호출 AzureOpenAIVectorizer 됩니다.

  • 2024-07-01 REST API 또는 기능을 제공하도록 업데이트된 Azure SDK 패키지를 사용합니다.

  • 검색 인덱스에 벡터라이저를 구성하면 사용 지침이 제공됩니다.

참고 항목

이 벡터라이저는 Azure OpenAI에 바인딩되어 있으며 기존 Azure OpenAI 종량제 가격으로 요금이 부과됩니다.

필수 조건

Azure OpenAI 서비스에는 연결된 사용자 지정 하위 도메인이 있어야 합니다. Azure Portal을 통해 서비스를 만든 경우 이 하위 도메인은 서비스 설정의 일부로 자동으로 생성됩니다. Azure AI Search 통합과 함께 사용하기 전에 서비스에 사용자 지정 하위 도메인이 포함되어 있는지 확인합니다.

AI Studio에서 만든 Azure OpenAI 서비스 리소스(모델 포함에 대한 액세스 권한 포함)는 지원되지 않습니다. Azure Portal에서 만든 Azure OpenAI 서비스 리소스만 Azure OpenAI 포함 기술 통합과 호환됩니다.

벡터라이저 매개 변수

매개 변수는 대/소문자를 구분합니다.

매개 변수 이름 설명
resourceUri 모델 공급자의 URI(이 경우 Azure OpenAI 리소스)입니다. 이 매개 변수는 도메인이 있는 URL openai.azure.com(예: https://<resourcename>.openai.azure.com.)만 지원합니다. Azure OpenAI 엔드포인트에 도메인cognitiveservices.azure.com과 같은 https://<resourcename>.cognitiveservices.azure.comURL이 있는 경우 Azure OpenAI 리소스에 대해 먼저 사용자 지정 하위 도메인 openai.azure.com 을 만들고 대신 사용해야 https://<resourcename>.openai.azure.com 합니다.
apiKey 모델에 액세스하는 데 사용되는 비밀 키입니다. 키를 제공하는 경우 authIdentity를 비워 둡니다. apiKey와 authIdentity를 모두 설정하면 연결에 apiKey가 사용됩니다.
deploymentId 배포된 Azure OpenAI 포함 모델의 이름입니다. 모델은 text-embedding-ada-002와 같은 포함 모델이어야 합니다. 지원되는 모델은 Azure OpenAI 모델 목록을 참조하세요.
authIdentity Azure OpenAI에 연결하기 위해 검색 서비스에서 사용하는 사용자 관리 ID입니다. 시스템 관리 ID 또는 사용자 관리 ID를 지정할 수 있습니다. 시스템 관리 ID를 사용하려면 apiKey 및 authIdentity을(를) 비워 둡니다. 시스템 관리 ID가 자동으로 사용됩니다. Azure OpenAI에 텍스트를 보내려면 관리 ID에 Cognitive Services OpenAI 사용자 권한이 있어야 합니다.
modelName (API 버전 2024-05-01-Preview 이상에서 필요) 제공된 resourceUri 및 deploymentId에 배포된 Azure OpenAI 포함 모델의 이름입니다. 현재 지원되는 값은 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",
        },
    }
]

참고 항목