Vettorizzatore di OpenAI di Azure
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.
Usare l'API REST 2024-07-01 o un pacchetto di Azure SDK aggiornato per fornire la funzionalità.
Configurare un vettore in un indicedi ricerca fornisce istruzioni sull'utilizzo.
Nota
Il vettorizzatore è associato a OpenAI di Azure e viene addebitato al prezzo con pagamento in base al consumo di OpenAI di Azure.
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",
},
}
]