Bagikan melalui

Vektorizer Azure OpenAI

  • Artikel

Vektorizer Azure OpenAI tersambung ke model penyematan yang disebarkan pada sumber daya Azure OpenAI Anda untuk menghasilkan penyematan pada waktu kueri. Data Anda diproses di Geo tempat model Anda disebarkan.

Vektorizer digunakan pada waktu kueri, tetapi ditentukan dalam definisi indeks, dan dirujuk pada bidang vektor melalui profil vektor. Vektorizer Azure OpenAI dipanggil AzureOpenAIVectorizer dalam API.

Catatan

Vektorizer ini terikat ke Azure OpenAI dan dibebankan pada harga bayar sesuai penggunaan Azure OpenAI yang ada.

Prasyarat

Layanan Azure OpenAI Anda harus memiliki subdomain kustom terkait. Jika layanan dibuat melalui portal Azure, subdomain ini secara otomatis dibuat sebagai bagian dari penyiapan layanan Anda. Pastikan layanan Anda menyertakan subdomain kustom sebelum menggunakannya dengan integrasi Azure AI Search.

Sumber daya Azure OpenAI Service (dengan akses ke model penyematan) yang dibuat di AI Studio tidak didukung. Hanya sumber daya Azure OpenAI Service yang dibuat di portal Azure yang kompatibel dengan integrasi keterampilan Azure OpenAI Embedding.

Parameter vektorizer

Parameternya peka huruf besar/kecil.

Nama Parameter Deskripsi
resourceUri URI penyedia model, dalam hal ini, sumber daya Azure OpenAI. Parameter ini hanya mendukung URL dengan domain openai.azure.com, seperti https://<resourcename>.openai.azure.com. Jika titik akhir Azure OpenAI memiliki URL dengan domain cognitiveservices.azure.com, seperti https://<resourcename>.cognitiveservices.azure.com, subdomain kustom dengan openai.azure.com harus dibuat terlebih dahulu untuk sumber daya Azure OpenAI dan gunakan https://<resourcename>.openai.azure.com sebagai gantinya.
apiKey Kunci rahasia yang digunakan untuk mengakses model. Jika Anda menyediakan kunci, biarkan authIdentity kosong. Jika Anda mengatur apiKey dan authIdentity, apiKey digunakan pada koneksi.
deploymentId Nama model penyematan Azure OpenAI yang disebarkan. Model harus menjadi model penyematan, seperti text-embedding-ada-002. Lihat Daftar model Azure OpenAI untuk model yang didukung.
authIdentity Identitas yang dikelola pengguna yang digunakan oleh layanan pencarian untuk menyambungkan ke Azure OpenAI. Anda dapat menggunakan sistem atau identitas terkelola pengguna. Untuk menggunakan identitas yang di-manged sistem, biarkan apiKey dan authIdentity kosong. Identitas yang dikelola sistem digunakan secara otomatis. Identitas terkelola harus memiliki izin Pengguna OpenAI Cognitive Services untuk mengirim teks ke Azure OpenAI.
modelName (Diperlukan dalam API versi 2024-05-01-Preview dan yang lebih baru). Nama model penyematan Azure OpenAI yang disebarkan di disediakan resourceUri dan deploymentId. Nilai yang saat ini didukung adalah text-embedding-ada-002, text-embedding-3-large, dan text-embedding-3-small

Jenis kueri vektor yang didukung

Vektorizer Azure OpenAI hanya mendukung text kueri vektor.

Dimensi bidang yang diharapkan

Dimensi bidang yang diharapkan untuk bidang yang dikonfigurasi dengan vektorizer Azure OpenAI bergantung pada modelName yang dikonfigurasi.

modelName Dimensi minimum Dimensi maksimum
text-embedding-ada-002 1536 1536
text-embedding-3-large 1 3072
text-embedding-3-small 1 1536

Definisi sampel

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

Lihat juga