Condividi tramite

Vettorizzatore di OpenAI di Azure

  • Articolo

Il vettorizzatore OpenAI di Azure si connette a un modello di incorporamento distribuito nella risorsa di OpenAI di Azure per generare incorporamenti in fase di query. I dati vengono elaborati nell'area geografica in cui viene distribuito il modello.

I vettori vengono usati in fase di query, ma specificati nelle definizioni di indice e a cui viene fatto riferimento sui campi vettoriali tramite un profilo vettoriale. Il vettore OpenAI di Azure viene chiamato AzureOpenAIVectorizer nell'API.

Nota

Il vettorizzatore è associato a OpenAI di Azure e viene addebitato al prezzo con pagamento in base al consumo di OpenAI di Azure.

Prerequisiti

Il servizio Azure OpenAI deve avere un sottodominio personalizzato associato. Se il servizio è stato creato tramite il portale di Azure, questo sottodominio viene generato automaticamente come parte della configurazione del servizio. Assicurarsi che il servizio includa un sottodominio personalizzato prima di usarlo con l'integrazione di Ricerca di intelligenza artificiale di Azure.

Le risorse del servizio OpenAI di Azure (con accesso ai modelli di incorporamento) create in AI Studio non sono supportate. Solo le risorse del servizio OpenAI di Azure create nel portale di Azure sono compatibili con l'integrazione delle competenze di incorporamento di Azure OpenAI.

Parametri del vettorizzatore

I parametri fanno distinzione tra maiuscole e minuscole.

Nome parametro Descrizione
resourceUri L'URI del provider di modelli, in questo caso, una risorsa OpenAI di Azure. Questo parametro supporta solo gli URL con dominio openai.azure.com, ad esempio https://<resourcename>.openai.azure.com. Se l'endpoint OpenAI di Azure ha un URL con dominio cognitiveservices.azure.com, ad esempio https://<resourcename>.cognitiveservices.azure.com, è necessario creare prima un sottodominio personalizzato con openai.azure.com per la risorsa OpenAI di Azure e usarlo https://<resourcename>.openai.azure.com .
apiKey Chiave privata usata per accedere al modello. Se si specifica una chiave, lasciare vuoto authIdentity. Se si imposta sia apiKey che authIdentity, apiKey viene usato nella connessione.
deploymentId Nome del modello di incorporamento di OpenAI di Azure distribuito. Il modello deve essere un modello di incorporamento, ad esempio text-embedding-ada-002. Per informazioni sui modelli supportati, vedere l'Elenco dei modelli di OpenAI di Azure.
authIdentity Identità gestita dall'utente usata dal servizio di ricerca per la connessione a OpenAI di Azure. È possibile usare un'identità gestita dal sistema o dall'utente. Per usare un'identità gestita dal sistema, lasciare vuoti apiKey e authIdentity. 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 nell'API versione 2024-05-01-Preview e successive. Nome del modello di incorporamento di OpenAI di Azure distribuito in resourceUri e deploymentId forniti. I valori attualmente supportati sono text-embedding-ada-002, text-embedding-3-large e 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",
        },
    }
]

Vedi anche