Delen via

Azure OpenAI vectorizer

  • Artikel

Belangrijk

Deze functie is beschikbaar als openbare preview onder aanvullende gebruiksvoorwaarden. De REST API 2023-10-01-Preview en latere preview-REST API's ondersteunen deze functie.

De Azure OpenAI-vectorizer maakt verbinding met een geïmplementeerd insluitmodel op uw Azure OpenAI-resource om insluitingen te genereren tijdens het uitvoeren van query's. Uw gegevens worden verwerkt in de geografische locatie waar uw model wordt geïmplementeerd.

Notitie

Deze vectorizer is gebonden aan Azure OpenAI en wordt in rekening gebracht tegen de bestaande prijs voor betalen per gebruik van Azure OpenAI.

Vectorizer-parameters

Parameters zijn hoofdlettergevoelig.

Parameternaam Beschrijving
resourceUri De URI van een modelprovider, zoals een Azure OpenAI-resource of een OpenAI-URL.
apiKey De geheime sleutel die wordt gebruikt voor toegang tot het model. Als u een sleutel opgeeft, laat u deze authIdentity leeg. Als u zowel de apiKey als authIdentityde optie instelt, wordt deze apiKey gebruikt voor de verbinding.
deploymentId De naam van het geïmplementeerde Azure OpenAI-insluitingsmodel. Het model moet een insluitmodel zijn, zoals tekst-insluiten-ada-002. Zie de lijst met Azure OpenAI-modellen voor ondersteunde modellen.
authIdentity Een door de gebruiker beheerde identiteit die door de zoekservice wordt gebruikt om verbinding te maken met Azure OpenAI. U kunt een door het systeem beheerde identiteit of een door de gebruiker beheerde identiteit gebruiken. Als u een door het systeem beheerde identiteit wilt gebruiken, laat u deze leeg en authIdentity leegapiKey. De door het systeem beheerde identiteit wordt automatisch gebruikt. Een beheerde identiteit moet cognitive Services OpenAI-gebruikersmachtigingen hebben om tekst naar Azure OpenAI te verzenden.
modelName (Vereist in API-versie 2024-05-01-Preview en hoger). De naam van het Azure OpenAI-insluitingsmodel dat is geïmplementeerd op de opgegeven resourceUri en deploymentId. Momenteel ondersteunde waarden zijn text-embedding-ada-002, text-embedding-3-largeen text-embedding-3-small

Ondersteunde vectorquerytypen

De Azure OpenAI-vectorizer ondersteunt text alleen vectorquery's.

Verwachte velddimensies

De verwachte velddimensies voor een veld dat is geconfigureerd met een Azure OpenAI-vectorizer, zijn afhankelijk van de modelName waarde die is geconfigureerd.

modelName Minimumdimensies Maximumdimensies
tekst-insluiten-ada-002 1536 1536
tekst-insluiten-3-groot 1 3072
tekst-insluiten-3-klein 1 1536

Voorbeelddefinitie

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

Zie ook