Udostępnij za pośrednictwem

Wektoryzator usługi Azure OpenAI

  • Artykuł

Wektoryzator usługi Azure OpenAI łączy się z wdrożonym modelem osadzania w zasobie usługi Azure OpenAI w celu wygenerowania osadzania w czasie wykonywania zapytań. Dane są przetwarzane w obszarze geograficznym, w którym wdrożono model.

Wektoryzatory są używane w czasie zapytania, ale określone w definicjach indeksu i przywoływały do pól wektorowych za pośrednictwem profilu wektorowego. Wektoryzator azure OpenAI jest wywoływany AzureOpenAIVectorizer w interfejsie API.

Uwaga

Ten wektoryzator jest powiązany z usługą Azure OpenAI i pobiera opłaty za istniejącą cenę płatności zgodnie z rzeczywistym użyciem w usłudze Azure OpenAI.

Wymagania wstępne

Usługa Azure OpenAI musi mieć skojarzona niestandardowa poddomena. Jeśli usługa została utworzona za pośrednictwem witryny Azure Portal, ta poddomena zostanie automatycznie wygenerowana w ramach konfiguracji usługi. Przed rozpoczęciem korzystania z integracji usługi Azure AI Search upewnij się, że usługa zawiera niestandardową poddomenę podrzędną.

Zasoby usługi Azure OpenAI Service (z dostępem do modeli osadzania), które zostały utworzone w programie AI Studio, nie są obsługiwane. Tylko zasoby usługi Azure OpenAI utworzone w witrynie Azure Portal są zgodne z integracją umiejętności osadzania usługi Azure OpenAI.

Parametry wektoryzatora

W parametrach jest rozróżniana wielkość liter.

Nazwa parametru opis
resourceUri Identyfikator URI dostawcy modelu, w tym przypadku zasób azure OpenAI. Ten parametr obsługuje tylko adresy URL z domeną openai.azure.com, na przykład https://<resourcename>.openai.azure.com. Jeśli punkt końcowy usługi Azure OpenAI ma adres URL z domeną cognitiveservices.azure.com, na przykład https://<resourcename>.cognitiveservices.azure.com, należy najpierw utworzyć niestandardową poddomenę openai.azure.com dla zasobu usługi Azure OpenAI i użyć go zamiast tego.https://<resourcename>.openai.azure.com
apiKey Klucz tajny używany do uzyskiwania dostępu do modelu. Jeśli podasz klucz, pozostaw authIdentity wartość pustą. W przypadku ustawienia parametru apiKey i authIdentityapiKey parametr jest używany w połączeniu.
deploymentId Nazwa wdrożonego modelu osadzania usługi Azure OpenAI. Model powinien być modelem osadzania, takim jak osadzanie tekstu-ada-002. Zobacz listę modeli usługi Azure OpenAI dla obsługiwanych modeli.
authIdentity Tożsamość zarządzana przez użytkownika używana przez usługę wyszukiwania do nawiązywania połączenia z usługą Azure OpenAI. Możesz użyć tożsamości zarządzanej przez system lub użytkownika. Aby użyć tożsamości manged systemu, pozostaw apiKey i authIdentity puste. Tożsamość zarządzana przez system jest używana automatycznie. Tożsamość zarządzana musi mieć uprawnienia użytkownika openAI usług Cognitive Services do wysyłania tekstu do usługi Azure OpenAI.
modelName (Wymagane w interfejsie API w wersji 2024-05-01-Preview i nowszej). Nazwa modelu osadzania usługi Azure OpenAI wdrożonego w podanych elementach resourceUri i deploymentId. Obecnie obsługiwane wartości to text-embedding-ada-002, text-embedding-3-largei text-embedding-3-small

Obsługiwane typy zapytań wektorowych

Wektoryzator azure OpenAI obsługuje text tylko zapytania wektorowe.

Oczekiwane wymiary pola

Oczekiwane wymiary pola dla pola skonfigurowanego za pomocą wektoryzatora usługi Azure OpenAI zależą od skonfigurowanej modelName klasy .

modelName Minimalne wymiary Maksymalne wymiary
text-embedding-ada-002 1536 1536
osadzanie tekstu —3 — duże 1 3072
osadzanie tekstu — 3 małe 1 1536

Przykładowa definicja

"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",
        },
    }
]

Zobacz też