Condividi tramite

Vettorizzatore di OpenAI di Azure

Il vettore OpenAI di Azure si connette a un modello di incorporamento distribuito alla risorsa Azure OpenAI in Foundry Models o al progetto Microsoft Foundry per generare incorporamenti in fase di query. I dati vengono elaborati nell'area geografica in cui viene distribuito il modello.

Sebbene i vettorizzatori siano utilizzati al momento della query, li specifichi nelle definizioni dell'indice e fai riferimento ad essi tramite un profilo vettoriale sui campi vettoriali. Per altre informazioni, vedere Configurare un vettore in un indice di ricerca.

Il vettore OpenAI di Azure viene chiamato AzureOpenAIVectorizer nell'API REST. Usare la versione stabile più recente di Indici - Creare (API REST) o un pacchetto di Azure SDK che fornisce la funzionalità.

Note

Questo vettore è associato ad Azure OpenAI e viene addebitato al prezzo Standard di Azure OpenAI.

Prerequisites

  • Una risorsa OpenAI di Azure in Foundry Models o un progetto Foundry.

    • La risorsa OpenAI di Azure deve avere un sottodominio personalizzato, ad esempio https://<resource-name>.openai.azure.com. È possibile trovare questo endpoint nella pagina Chiavi ed endpoint nel portale di Azure e usarlo per la proprietà resourceUri in questa competenza.

    • La risorsa padre del progetto Foundry fornisce l'accesso a più endpoint, tra cui https://<resource-name>.openai.azure.com, https://<resource-name>.services.ai.azure.come https://<resource-name>.cognitiveservices.azure.com. È possibile trovare questi endpoint nella pagina Chiavi ed endpoint nel portale di Azure e usarli per la proprietà resourceUri in questa abilità.

  • Modello di incorporamento OpenAI di Azure distribuito nella risorsa o nel progetto. Per i modelli supportati, vedere la sezione successiva.

Parametri del vettore

I parametri sono sensibili alla distinzione tra maiuscole e minuscole.

Nome del parametro Description
resourceUri (Obbligatorio) URI del fornitore del modello. I domini supportati sono:

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

Gli endpoint di Gestione API di Azure sono supportati con URL https://<resource-name>.azure-api.net. I collegamenti privati condivisi non sono supportati per gli endpoint di Gestione API.
apiKey Chiave privata usata per accedere al modello. Se si specifica una chiave, lasciare vuoto authIdentity. Se si impostano sia apiKey e authIdentity, viene apiKey utilizzato nella connessione.
deploymentId (Obbligatorio) ID del modello di incorporamento azure OpenAI distribuito. Si tratta del nome di distribuzione specificato durante la distribuzione del modello.
authIdentity Identità gestita dall'utente usata dal servizio di ricerca per la connessione. È possibile usare un'identità gestita dal sistema o dall'utente. Per utilizzare un'identità gestita dal sistema, lasciare apiKey e authIdentity vuoti. L'identità gestita dal sistema viene usata automaticamente. Per inviare testo a OpenAI di Azure, un'identità gestita deve avere autorizzazioni di tipo Utente OpenAI di Servizi cognitivi.
modelName (Obbligatorio) Nome del modello OpenAI di Azure distribuito al punto specificato deploymentId. I valori supportati sono:

  • text-embedding-ada-002
  • text-embedding-3-large
  • text-embedding-3-small

Tipi di query vettoriali supportati

Il vettorizzatore di OpenAI di Azure supporta solo query vettoriali text.

Dimensioni di campo previste

Le dimensioni di campo previste per un campo configurato con un vettorizzatore di OpenAI di Azure dipendono da modelName configurato.

modelName Dimensioni minime Dimensioni massime
text-embedding-ada-002 1536 1536
text-embedding-3-large 1 3072
text-embedding-3-small 1 1536

Definizione di esempio

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

Vedere anche

  • Last updated on