Delen via

Azure OpenAI vectorizer

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

Hoewel vectorizers tijdens query's worden gebruikt, geeft u deze op in indexdefinities en verwijst u ernaar op vectorvelden via een vectorprofiel. Zie Een vectorizer configureren in een zoekindex voor meer informatie.

De Azure OpenAI-vectorizer wordt aangeroepen AzureOpenAIVectorizer in de REST API. Gebruik de nieuwste stabiele versie van Indexen : Maken (REST API) of een Azure SDK-pakket dat de functie biedt.

Note

Deze vectorizer is gebonden aan Azure OpenAI en wordt in rekening gebracht tegen de Standaardprijs van Azure OpenAI.

Prerequisites

  • Een Azure OpenAI in Foundry Models-resource of Foundry-project.

    • Uw Azure OpenAI-resource moet een aangepast subdomein hebben, zoals https://<resource-name>.openai.azure.com. U vindt dit eindpunt op de pagina Sleutels en eindpunt in Azure Portal en gebruikt dit voor de resourceUri eigenschap in deze vaardigheid.

    • De bovenliggende resource van uw Foundry-project biedt toegang tot meerdere eindpunten, waaronder https://<resource-name>.openai.azure.com, https://<resource-name>.services.ai.azure.comen https://<resource-name>.cognitiveservices.azure.com. U kunt deze eindpunten vinden op de pagina Sleutels en eindpunten in Azure Portal en deze gebruiken voor de resourceUri eigenschap in deze vaardigheid.

  • Een Azure OpenAI-insluitmodel dat is geïmplementeerd in uw resource of project. Zie de volgende sectie voor ondersteunde modellen.

Vectorizer-parameters

Parameters zijn hoofdlettergevoelig.

Parameternaam Description
resourceUri (Vereist) De URI van de modelprovider. Ondersteunde domeinen zijn:

  • openai.azure.com
  • services.ai.azure.com
  • cognitiveservices.azure.com

Azure API Management-eindpunten worden ondersteund met URL https://<resource-name>.azure-api.net. Gedeelde privékoppelingen worden niet ondersteund voor API Management-eindpunten.
apiKey De geheime sleutel die wordt gebruikt voor toegang tot het model. Als u een sleutel opgeeft, laat u deze authIdentity leeg. Als u beide instelt apiKey en authIdentity, wordt deze apiKey gebruikt voor de verbinding.
deploymentId (Vereist) De id van het geïmplementeerde Azure OpenAI-insluitingsmodel. Dit is de implementatienaam die u hebt opgegeven bij het implementeren van het model.
authIdentity Een door de gebruiker beheerde identiteit die wordt gebruikt door de zoekservice voor de verbinding. U kunt een door het systeem of 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) De naam van het Azure OpenAI-model dat is geïmplementeerd op het opgegeven deploymentId. Ondersteunde waarden zijn:

  • text-embedding-ada-002
  • text-embedding-3-large
  • 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
text-embedding-ada-002 1536 1536
text-embedding-3-large 1 3072
text-embedding-3-small 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

  • Last updated on