Sdílet prostřednictvím

Vektorizátor Azure OpenAI

  • Článek

Vektorizátor Azure OpenAI se připojí k nasazeného modelu vkládání ve vašem prostředku Azure OpenAI a vygeneruje vkládání v době dotazu. Vaše data se zpracovávají v geografické oblasti, ve které je váš model nasazený.

Vektorizátory se používají v době dotazu, ale specifikují se v definicích indexu a odkazují na vektorová pole prostřednictvím vektorového profilu. Vektorizátor Azure OpenAI se volá AzureOpenAIVectorizer v rozhraní API.

Poznámka:

Tento vektorizátor je vázán na Azure OpenAI a účtuje se za stávající cenu průběžných plateb Azure OpenAI.

Požadavky

Vaše služba Azure OpenAI musí mít přidruženou vlastní subdoménu. Pokud byla služba vytvořená prostřednictvím webu Azure Portal, tato subdoména se automaticky vygeneruje jako součást nastavení služby. Před použitím s integrací služby Azure AI Search se ujistěte, že vaše služba obsahuje vlastní subdoménu.

Prostředky služby Azure OpenAI (s přístupem k modelům vkládání) vytvořené na portálu Azure AI Foundry se nepodporují. S integrací dovedností Azure OpenAI Embedding jsou kompatibilní pouze prostředky služby Azure OpenAI vytvořené na webu Azure Portal.

Parametry vektorizátoru

Parametry rozlišují malá a velká písmena.

Název parametru Popis
resourceUri Identifikátor URI zprostředkovatele modelu v tomto případě prostředek Azure OpenAI. Tento parametr podporuje pouze adresy URL s doménou openai.azure.com, například https://<resourcename>.openai.azure.com. Pokud má koncový bod Azure OpenAI adresu URL s doménou cognitiveservices.azure.com, například https://<resourcename>.cognitiveservices.azure.com, musí se nejprve vytvořit vlastní subdoména openai.azure.com pro prostředek Azure OpenAI a použít https://<resourcename>.openai.azure.com místo toho.
apiKey Tajný klíč použitý pro přístup k modelu. Pokud zadáte klíč, nechejte authIdentity prázdný. Pokud nastavíte připojení apiKey i authIdentity, apiKey použije se v připojení.
deploymentId Název nasazeného modelu vkládání Azure OpenAI Model by měl být vložený model, například text-embedding-ada-002. Seznam modelů Azure OpenAI pro podporované modely
authIdentity Identita spravovaná uživatelem používaná vyhledávací službou pro připojení k Azure OpenAI. Můžete použít identitu spravovanou systémem nebo uživatelem. Pokud chcete použít systémovou mangovanou identitu, nechejte apiKey ji prázdnou.authIdentity Identita spravovaná systémem se používá automaticky. Spravovaná identita musí mít oprávnění uživatele OpenAI služeb Cognitive Services k odesílání textu do Azure OpenAI.
modelName (Povinné ve verzi API 2024-05-01-Preview a novější). Název modelu vkládání Azure OpenAI, který je nasazený v zadaném resourceUri prostředí a deploymentId. Aktuálně podporované hodnoty jsou text-embedding-ada-002, text-embedding-3-largea text-embedding-3-small

Podporované typy vektorových dotazů

Vektorizátor Azure OpenAI podporuje text pouze vektorové dotazy.

Očekávané rozměry pole

Očekávané dimenze pole pro pole nakonfigurované vektorizátorem Azure OpenAI závisí na modelName nakonfigurované konfiguraci.

modelName Minimální rozměry Maximální rozměry
text-embedding-ada-002 1536 1536
text-embedding-3-large 0 3072
text-embedding-3-small 0 1536

Ukázková definice

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

Viz také