Dela via

Katalogvektoriserare för Azure AI Foundry-modell

  • Artikel

Viktigt!

Den här vektoriseraren är i offentlig förhandsversion under kompletterande användningsvillkor. REST API för förhandsversion 2024-05-01 stöder den här funktionen.

Katalogvektoriseraren för Azure AI Foundry-modellen ansluter till en inbäddningsmodell som distribuerades via Azure AI Foundry-modellkatalogen till en Azure Machine Learning-slutpunkt. Dina data bearbetas i geo-området där din modell distribueras.

Om du använde integrerad vektorisering för att skapa vektormatriserna bör kompetensuppsättningen innehålla en AML-färdighet som pekar på modellkatalogen i Azure AI Foundry-portalen.

Vectorizer-parametrar

Parametrar är skiftlägeskänsliga. Vilka parametrar du väljer att använda beror på vilken autentisering din AML-onlineslutpunkt kräver, om någon.

Parameternamn beskrivning
uri (Krävs) URI:n för den AML-onlineslutpunkt som JSON-nyttolasten skickas till. Endast https-URI-schemat tillåts.
modelName (Krävs) Modell-ID:t från Azure AI Foundry-modellkatalogen som distribueras på den angivna slutpunkten. Modeller som stöds är:
  • Facebook-DinoV2-Image-Embeddings-ViT-Base
  • Facebook-DinoV2-Image-Embeddings-ViT-Giant
  • Cohere-embed-v3-english
  • Cohere-embed-v3-multilingual
key (Krävs för nyckelautentisering) Nyckeln för AML-onlineslutpunkten.
resourceId (Krävs för tokenautentisering). Azure Resource Manager-resurs-ID för AML-onlineslutpunkten. Det bör vara i formatet subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/onlineendpoints/{endpoint_name}.
region (Valfritt för tokenautentisering). Den region som AML-onlineslutpunkten distribueras i. Behövs om regionen skiljer sig från söktjänstens region.
timeout (Valfritt) När det anges anger du tidsgränsen för http-klienten som gör API-anropet. Det måste formateras som ett XSD-värde "dayTimeDuration" (en begränsad delmängd av ett ISO 8601-varaktighetsvärde ). Till exempel PT60S i 60 sekunder. Om det inte anges väljs ett standardvärde på 30 sekunder. Tidsgränsen kan anges till högst 230 sekunder och minst 1 sekund.

Vilka autentiseringsparametrar som ska användas

Vilka autentiseringsparametrar som krävs beror på vilken autentisering din AML-onlineslutpunkt använder, om någon. AML-onlineslutpunkter tillhandahåller två autentiseringsalternativ:

  • Nyckelbaserad autentisering. En statisk nyckel tillhandahålls för att autentisera bedömningsbegäranden från vektoriseraren.
    • Använda URI- och nyckelparametrarna
  • Tokenbaserad autentisering. AML-onlineslutpunkten distribueras med hjälp av tokenbaserad autentisering. Azure AI-tjänsten Search hanterade identitet måste vara aktiverad. Vektoriseraren använder sedan tjänstens hanterade identitet för att autentisera mot AML-onlineslutpunkten, utan att några statiska nycklar krävs. Identiteten måste vara tilldelad ägar- eller deltagarroll.
    • Använd parametern resourceId .
    • Om söktjänsten finns i en annan region än AML-arbetsytan använder du regionparametern för att ange den region som AML-onlineslutpunkten distribuerades i

Frågetyper för vektorer som stöds

Vilka vektorfrågetyper som stöds av Katalogvektoriseraren för Azure AI Foundry-modellen beror på vilken modelName som är konfigurerad.

Inbäddningsmodell Stöder text fråga Stöder imageUrl fråga Stöder imageBinary fråga
Facebook-DinoV2-Image-Embeddings-ViT-Base X X
Facebook-DinoV2-Image-Embeddings-ViT-Giant X X
Cohere-embed-v3-english X
Cohere-embed-v3-multilingual X

Förväntade fältdimensioner

De förväntade fältdimensionerna för ett fält som konfigurerats med en katalogvektoriserare för Azure AI Foundry-modellen beror på vilken modelName som är konfigurerad.

modelName Förväntade dimensioner
Facebook-DinoV2-Image-Embeddings-ViT-Base 768
Facebook-DinoV2-Image-Embeddings-ViT-Giant 1536
Cohere-embed-v3-english 1024
Cohere-embed-v3-multilingual 1024

Exempeldefinition

Föreslagna modellnamn i Azure AI Foundry-modellkatalogen består av basmodellen plus ett slumpmässigt suffix med tre bokstäver. Namnet på din modell skiljer sig från det som visas i det här exemplet.

"vectorizers": [
    {
        "name": "my-model-catalog-vectorizer",
        "kind": "aml",
        "amlParameters": {
            "uri": "https://Cohere-embed-v3-multilingual-hin.eastus.models.ai.azure.com",
            "key": "aaaaaaaa-0b0b-1c1c-2d2d-333333333333",
            "timeout": "PT60S",
            "modelName": "Cohere-embed-v3-multilingual-hin",
            "resourceId": null,
            "region": null,
        },
    }
]

Se även