Ismerje meg, hogyan hozhat létre beágyazásokat az Azure OpenAI-val

Cikk
05/23/2024

A beágyazás az adatmegjelenítés speciális formátuma, amelyet gépi tanulási modellek és algoritmusok könnyen használhatnak. A beágyazás egy szöveg szemantikai jelentésének információdús ábrázolása. Minden beágyazás lebegőpontos számok vektora, így a vektortérben lévő két beágyazás távolsága korrelál két bemenet szemantikai hasonlóságával az eredeti formátumban. Ha például két szöveg hasonló, akkor a vektoros ábrázolásuknak is hasonlónak kell lennie. A power vector similarity search beágyazása azure-adatbázisokba, például Az Azure Cosmos DB for MongoDB virtuális mag , az Azure SQL Database vagy az Azure Database for PostgreSQL – rugalmas kiszolgáló.

Beágyazások lekérése

Egy szöveg beágyazási vektorának lekéréséhez kérést küldünk a beágyazási végponthoz az alábbi kódrészletekben látható módon:

curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings?api-version=2024-02-01\
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY' \
  -d '{"input": "Sample Document goes here"}'

import os
from openai import AzureOpenAI

client = AzureOpenAI(
  api_key = os.getenv("AZURE_OPENAI_API_KEY"),  
  api_version = "2024-02-01",
  azure_endpoint =os.getenv("AZURE_OPENAI_ENDPOINT") 
)

response = client.embeddings.create(
    input = "Your text string goes here",
    model= "text-embedding-ada-002"
)

print(response.model_dump_json(indent=2))

Feljegyzés

Az OpenAI Python-kódtár verziója 0.28.1 elavult. Javasoljuk, hogy használja a következőt 1.x: . A migrálási útmutatónkból tájékozódhat a migrálásról 0.28.1 1.x.

import openai

openai.api_type = "azure"
openai.api_key = YOUR_API_KEY
openai.api_base = "https://YOUR_RESOURCE_NAME.openai.azure.com"
openai.api_version = "2024-02-01"

response = openai.Embedding.create(
    input="Your text string goes here",
    engine="YOUR_DEPLOYMENT_NAME"
)
embeddings = response['data'][0]['embedding']
print(embeddings)

using Azure;
using Azure.AI.OpenAI;

Uri oaiEndpoint = new ("https://YOUR_RESOURCE_NAME.openai.azure.com");
string oaiKey = "YOUR_API_KEY";

AzureKeyCredential credentials = new (oaiKey);

OpenAIClient openAIClient = new (oaiEndpoint, credentials);

EmbeddingsOptions embeddingOptions = new()
{
    DeploymentName = "text-embedding-ada-002",
    Input = { "Your text string goes here" },
};

var returnValue = openAIClient.GetEmbeddings(embeddingOptions);

foreach (float item in returnValue.Value.Data[0].Embedding.ToArray())
{
    Console.WriteLine(item);
}

# Azure OpenAI metadata variables
$openai = @{
    api_key     = $Env:AZURE_OPENAI_API_KEY
    api_base    = $Env:AZURE_OPENAI_ENDPOINT # your endpoint should look like the following https://YOUR_RESOURCE_NAME.openai.azure.com/
    api_version = '2024-02-01' # this may change in the future
    name        = 'YOUR-DEPLOYMENT-NAME-HERE' #This will correspond to the custom name you chose for your deployment when you deployed a model.
}

$headers = [ordered]@{
    'api-key' = $openai.api_key
}

$text = 'Your text string goes here'

$body = [ordered]@{
    input = $text
} | ConvertTo-Json

$url = "$($openai.api_base)/openai/deployments/$($openai.name)/embeddings?api-version=$($openai.api_version)"

$response = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -ContentType 'application/json'
return $response.data.embedding

Ajánlott eljárások

Ellenőrizze, hogy a bemenetek nem lépik-e túl a maximális hosszt

A legújabb beágyazási modellek bemeneti szövegének maximális hossza 8192 token. Mielőtt kérést küld, ellenőrizze, hogy a bemenetek nem lépik-e túl ezt a korlátot.
Ha egyetlen beágyazási kérelemben küld egy bemeneti tömböt, a maximális tömbméret 2048.

Korlátozások és kockázatok

Beágyazási modelljeink megbízhatatlanok lehetnek, vagy bizonyos esetekben társadalmi kockázatokat jelenthetnek, és károkat okozhatnak a kockázatcsökkentések hiányában. Tekintse át a felelős AI-tartalmakat, ha többet szeretne megtudni arról, hogyan lehet felelősen megközelíteni a használatukat.

Következő lépések

További információ az Azure OpenAI és a beágyazások használatáról a dokumentumkeresés végrehajtásához a beágyazási oktatóanyagunkkal.
További információ az Azure OpenAI-t használó mögöttes modellekről.
Tárolja a beágyazásokat, és végezzen vektoros (hasonlósági) keresést a választott Azure-szolgáltatással:

Megosztás a következőn keresztül: