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

Adatforrás – Azure Machine Learning-index (előzetes verzió)

  • Cikk

Az Azure Machine Learning-index konfigurálható beállításai az Azure OpenAI On Your Data használatakor. Ez az adatforrás az API-verzióban 2024-02-15-previewtámogatott.

Név Típus Kötelező Leírás
parameters Paraméterek Igaz Az Azure Machine Learning-index konfigurálásakor használandó paraméterek.
type húr Igaz Kell lennie azure_ml_index.

Paraméterek

Név Típus Kötelező Leírás
project_resource_id húr Igaz Az Azure Machine Learning-projekt erőforrás-azonosítója.
name húr Igaz Az Azure Machine Learning-index neve.
version húr Igaz Az Azure Machine Learning-index verziója.
authentication Az AccessTokenAuthenticationOptions, SystemAssignedManagedIdentityAuthenticationOptions, UserAssignedManagedIdentityAuthenticationOptions Igaz A megadott adatforrás elérésekor használandó hitelesítési módszer.
in_scope Logikai Hamis Azt határozza meg, hogy a lekérdezések az indexelt adatok használatára legyenek-e korlátozva. Az alapértelmezett szint a True.
role_information húr Hamis Adja meg a modell utasításait arról, hogy hogyan kell viselkednie, és minden olyan környezetet, amelyre hivatkoznia kell a válasz létrehozásakor. Leírhatja az asszisztens személyiségét, és megtudhatja, hogyan formázhatja a válaszokat.
strictness egész szám Hamis A keresési relevancia szűrésének konfigurált szigorúsága. Minél magasabb a szigorúság, annál nagyobb a pontosság, de annál kisebb a válasz visszahívása. Az alapértelmezett szint a 3.
top_n_documents egész szám Hamis A konfigurált lekérdezéshez használható dokumentumok maximális száma. Az alapértelmezett szint a 5.
filter húr Hamis Keresési szűrő. Csak akkor támogatott, ha az Azure Machine Learning-index Azure Search típusú.

Hozzáférési jogkivonat hitelesítési beállításai

Az Azure OpenAI on Your Data hitelesítési lehetőségei hozzáférési jogkivonat használata esetén.

Név Típus Kötelező Leírás
access_token húr Igaz A hitelesítéshez használandó hozzáférési jogkivonat.
type húr Igaz Kell lennie access_token.

A rendszer által hozzárendelt felügyelt identitás hitelesítési beállításai

Az Azure OpenAI on Your Data hitelesítési lehetőségei rendszer által hozzárendelt felügyelt identitás használatakor.

Név Típus Kötelező Leírás
type húr Igaz Kell lennie system_assigned_managed_identity.

Felhasználó által hozzárendelt felügyelt identitás hitelesítési beállításai

Az Azure OpenAI on Your Data hitelesítési lehetőségei felhasználó által hozzárendelt felügyelt identitás használatakor.

Név Típus Kötelező Leírás
managed_identity_resource_id húr Igaz A hitelesítéshez használandó, felhasználó által hozzárendelt felügyelt identitás erőforrás-azonosítója.
type húr Igaz Kell lennie user_assigned_managed_identity.

Példák

Előfeltételek:

  • Konfigurálja a szerepkör-hozzárendeléseket az Azure OpenAI rendszer által hozzárendelt felügyelt identitásból az Azure Machine Learning-munkaterület erőforrásához. Kötelező szerepkör: AzureML Data Scientist.
  • Konfigurálja a szerepkör-hozzárendeléseket a felhasználótól az Azure OpenAI-erőforráshoz. Kötelező szerepkör: Cognitive Services OpenAI User.
  • Telepítse az Az CLI-t, és futtassa.az login
  • Adja meg a következő környezeti változókat: AzureOpenAIEndpoint, ChatCompletionsDeploymentName, ProjectResourceId, IndexName. IndexVersion
  • Futtassa export MSYS_NO_PATHCONV=1 , ha MINGW-t használ.
export AzureOpenAIEndpoint=https://example.openai.azure.com/
export ChatCompletionsDeploymentName=turbo
export ProjectResourceId='/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.MachineLearningServices/workspaces/{workspace-id}'
export IndexName=testamlindex
export IndexVersion=2

Telepítse a legújabb pipcsomagokat openai, azure-identity.

import os
from openai import AzureOpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

endpoint = os.environ.get("AzureOpenAIEndpoint")
deployment = os.environ.get("ChatCompletionsDeploymentName")
project_resource_id = os.environ.get("ProjectResourceId")
index_name = os.environ.get("IndexName")
index_version = os.environ.get("IndexVersion")

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default")

client = AzureOpenAI(
    azure_endpoint=endpoint,
    azure_ad_token_provider=token_provider,
    api_version="2024-02-15-preview",
)

completion = client.chat.completions.create(
    model=deployment,
    messages=[
        {
            "role": "user",
            "content": "Who is DRI?",
        },
    ],
    extra_body={
        "data_sources": [
            {
                "type": "azure_ml_index",
                "parameters": {
                    "project_resource_id": project_resource_id,
                    "name": index_name,
                    "version": index_version,
                    "authentication": {
                        "type": "system_assigned_managed_identity"
                    },
                }
            }
        ]
    }
)

print(completion.model_dump_json(indent=2))