Delen via

Azure OpenAI vectorizer

  • Artikel

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.

Vectorizers worden gebruikt tijdens het uitvoeren van query's, maar opgegeven in indexdefinities en waarnaar wordt verwezen op vectorvelden via een vectorprofiel. De Azure OpenAI-vectorizer wordt aangeroepen AzureOpenAIVectorizer in de API.

Notitie

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

Vereisten

Uw Azure OpenAI-service moet een gekoppeld aangepast subdomein hebben. Als de service is gemaakt via Azure Portal, wordt dit subdomein automatisch gegenereerd als onderdeel van de installatie van uw service. Zorg ervoor dat uw service een aangepast subdomein bevat voordat u deze gebruikt met de Integratie van Azure AI Search.

Azure OpenAI Service-resources (met toegang tot insluitmodellen) die zijn gemaakt in de Azure AI Foundry-portal, worden niet ondersteund. Alleen de Azure OpenAI Service-resources die in Azure Portal zijn gemaakt, zijn compatibel met de integratie van vaardigheden voor Azure OpenAI Embedding .

Vectorizer-parameters

Parameters zijn hoofdlettergevoelig.

Parameternaam Beschrijving
resourceUri De URI van de modelprovider, in dit geval, een Azure OpenAI-resource. Deze parameter ondersteunt alleen URL's met een domein openai.azure.com, zoals https://<resourcename>.openai.azure.com. Als het Azure OpenAI-eindpunt een URL met een domein cognitiveservices.azure.comheeft, zoals https://<resourcename>.cognitiveservices.azure.comeen aangepast subdomein, openai.azure.commoet u eerst een aangepast subdomein maken voor de Azure OpenAI-resource en in plaats daarvan gebruikenhttps://<resourcename>.openai.azure.com.
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