Delen via

Gegevensbron - Azure Machine Learning-index (preview)

  • Artikel

De configureerbare opties van de Azure Machine Learning-index bij het gebruik van Azure OpenAI op uw gegevens. Deze gegevensbron wordt ondersteund in api-versie 2024-02-15-preview.

Name Type Vereist Beschrijving
parameters Parameters Waar De parameters die moeten worden gebruikt bij het configureren van de Azure Machine Learning-index.
type tekenreeks Waar Moet azure_ml_index zijn.

Parameters

Naam Type Vereist Beschrijving
project_resource_id tekenreeks Waar De resource-id van het Azure Machine Learning-project.
name tekenreeks Waar De naam van de Azure Machine Learning-index.
version tekenreeks Waar De versie van de Azure Machine Learning-index.
authentication Een van AccessTokenAuthenticationOptions, SystemAssignedManagedIdentityAuthenticationOptions, UserAssignedManagedIdentityAuthenticationOptions Waar De verificatiemethode die moet worden gebruikt bij het openen van de gedefinieerde gegevensbron.
in_scope boolean Onwaar Of query's moeten worden beperkt tot het gebruik van geïndexeerde gegevens. Standaard is True.
role_information tekenreeks Onwaar Geef het model instructies over hoe het zich moet gedragen en eventuele context waarnaar wordt verwezen bij het genereren van een antwoord. U kunt de persoonlijkheid van de assistent beschrijven en vertellen hoe u antwoorden kunt opmaken.
strictness geheel getal Onwaar De geconfigureerde striktheid van het filteren op zoekrelevantie. Hoe strikter, hoe hoger de precisie, maar een lagere terugroeping van het antwoord. Standaard is 3.
top_n_documents geheel getal Onwaar Het geconfigureerde bovenste aantal documenten dat moet worden aanbevolen voor de geconfigureerde query. Standaard is 5.
filter tekenreeks Onwaar Zoekfilter. Alleen ondersteund als de Azure Machine Learning-index van het type Azure Search is.

Verificatieopties voor toegangstokens

De verificatieopties voor Azure OpenAI Op uw gegevens bij gebruik van toegangstoken.

Name Type Vereist Beschrijving
access_token tekenreeks Waar Het toegangstoken dat moet worden gebruikt voor verificatie.
type tekenreeks Waar Moet access_token zijn.

Door het systeem toegewezen opties voor verificatie van beheerde identiteit

De verificatieopties voor Azure OpenAI op uw gegevens wanneer u een door het systeem toegewezen beheerde identiteit gebruikt.

Name Type Vereist Beschrijving
type tekenreeks Waar Moet system_assigned_managed_identity zijn.

Door de gebruiker toegewezen opties voor verificatie van beheerde identiteiten

De verificatieopties voor Azure OpenAI op uw gegevens bij gebruik van een door de gebruiker toegewezen beheerde identiteit.

Name Type Vereist Beschrijving
managed_identity_resource_id tekenreeks Waar De resource-id van de door de gebruiker toegewezen beheerde identiteit die moet worden gebruikt voor verificatie.
type tekenreeks Waar Moet user_assigned_managed_identity zijn.

Voorbeelden

Vereisten:

  • Configureer de roltoewijzingen van het Azure OpenAI-systeem dat is toegewezen aan de Azure Machine Learning-werkruimteresource. Vereiste rol: AzureML Data Scientist.
  • Configureer de roltoewijzingen van de gebruiker naar de Azure OpenAI-resource. Vereiste rol: Cognitive Services OpenAI User.
  • Installeer Az CLI en voer deze uit az login.
  • Definieer de volgende omgevingsvariabelen: AzureOpenAIEndpoint, ChatCompletionsDeploymentName, ProjectResourceId, , IndexName. IndexVersion
  • Voer uit export MSYS_NO_PATHCONV=1 als u MINGW gebruikt.
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

Installeer de nieuwste pip-pakketten 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))