Adatforrás – Azure AI Keresés (klasszikus)

Csak a következőkre vonatkozik:Öntödei (klasszikus) portál. Ez a cikk nem érhető el az új Foundry portálon. További információ az új portálról.

Megjegyzés:

A cikkben szereplő hivatkozások megnyithatják a tartalmat az új Microsoft Foundry-dokumentációban a most megtekintett Foundry (klasszikus) dokumentáció helyett.

Important

Azure OpenAI On Your Data elavult, és a kivonáshoz közeledik. A szolgáltatás 2026. október 14-én megszűnik

Microsoft leállította az új modellek előkészítését az OpenAI on Your Data Azure. Ez a funkció csak a következő modelleket támogatja:

  • GPT-4o (verzió: 2024-05-13, 2024-08-06 és 2024-11-20)
  • GPT-4o-mini (2024-07-18-es verzió)

Javasoljuk, hogy migrálja Azure OpenAI On Your Data számítási feladatokat a Foundry Agent ServiceFoundry IQ használatával a tartalom lekéréséhez és az adatokból származó megalapozott válaszok létrehozásához. Első lépésként tekintse meg a Foundry IQ-tudásbázis csatlakoztatása című témakört.

Az Azure AI Keresés konfigurálható opciói az Azure OpenAI On Your Data használatakor. Ez az adatforrás támogatott az API verzióban 2024-02-01.

Name Típus Szükséges Leírás
parameters Paraméterek True Az Azure Search konfigurálásakor használt paraméterek.
type karakterlánc True Biztosan az azure_search.

Parameters

Name Típus Szükséges Leírás
endpoint karakterlánc True Az abszolút végpont útvonal, amit az Azure Search erőforrás használhat.
index_name karakterlánc True Az index neve, amelyet a hivatkozott Azure Search erőforrásban használnak.
authentication Az ApiKeyAuthenticationOptions egyike: SystemAssignedManagedIdentityAuthenticationOptions, UserAssignedManagedIdentityAuthenticationOptions, onYourDataAccessTokenAuthenticationOptions True Az azonosítási módszer, amelyet a definiált adatforráshoz való hozzáférésnél kell használni.
embedding_dependency Az egyik a DeploymentNameVectorizationSource, EndpointVectorizationSource Téves A vektorkeresés beágyazási függősége. Szükséges, amikor query_type , vectorvector_simple_hybrid, vagy vector_semantic_hybrid.
fields_mapping FieldsMappingOptions Téves Testreszabott mezőtérképezési viselkedés, amelyet a keresési indexkel való interakcióhoz lehet használni.
filter karakterlánc Téves Keresési szűrő.
in_scope boolean Téves Hogy a lekérdezéseket korlátozni kell-e indexelt adatok használatára. Az alapértelmezett .True
query_type QueryType Téves Az Azure Search-hez használt lekérdezéstípus. Az alapértelmezett a simple
role_information karakterlánc Téves Adj utasításokat a modellnek arról, hogyan viselkedjen és milyen kontextusra hivatkoznia kell a válasz generálásához. Leírhatod az asszisztens személyiségét, és elmondhatod neki, hogyan kell a válaszokat formázni.
semantic_configuration karakterlánc Téves A lekérdezés szemantikai konfigurációja. Kötelező, amikor query_type az vagy semanticvector_semantic_hybrid .
strictness egész szám Téves A keresés relevancia szűrésének konfigurált szigorúsága. Minél magasabb a szigorúság, annál nagyobb a pontosság, de alacsonyabb a válasz emlékezése. Az alapértelmezett .3
top_n_documents egész szám Téves A konfigurált dokumentumok legfőbb száma, amelyeket a konfigurált lekérdezéshez kell használni. Az alapértelmezett .5
max_search_queries egész szám Téves A maximális számú újraírt lekérdezést egy felhasználói üzenet után a keresőszolgáltatónak kell küldeni. Ha nincs megadva, a rendszer dönti el, hány lekérdezést küldenek.
allow_partial_result egész szám Téves Ha igaznak van megadva, a rendszer engedélyezi a részleges keresési eredmények használatát, és a kérés megbukik, ha minden lekérdezés sikertelen. Ha nincs megadva, vagy nem tüntetik meg hamisnak, a kérés sikertelenül megbukik, ha bármelyik keresési lekérdezés meghibásítja.
include_contexts tömb Téves A kimeneti kontextus tartalmazott tulajdonságai. Ha nincs megadva, az alapértelmezett érték és citationsintent. Az értékek lehetnek citations,intent, all_retrieved_documents.

API kulcs hitelesítési lehetőségek

Az Azure OpenAI On Your Data hitelesítési lehetőségei API kulcs használatával.

Name Típus Szükséges Leírás
key karakterlánc True Az API kulcs, amit hitelesítéshez használnak.
type karakterlánc True Biztosan az api_key.

Rendszerhez rendelt menedzselt személyazonosság hitelesítési lehetőségek

Az Azure OpenAI On Your Data hitelesítési lehetőségei rendszerhez rendelt menedzselt identitáskor használva.

Name Típus Szükséges Leírás
type karakterlánc True Biztosan az system_assigned_managed_identity.

Felhasználó által hozzárendelt menedzselt személyazonosság hitelesítési lehetőségek

Az Azure OpenAI On Your Data hitelesítési lehetőségei felhasználó által kijelölt menedzselt identitáskor történő használatával.

Name Típus Szükséges Leírás
managed_identity_resource_id karakterlánc True A felhasználó által kijelölt menedzselt identitás erőforrás-azonosítója, amelyet hitelesítéshez kell használni.
type karakterlánc True Biztosan az user_assigned_managed_identity.

Hozzáférési token hitelesítési lehetőségek

Az Azure OpenAI On Your Data hitelesítési lehetőségei Access Token használatakor.

Name Típus Szükséges Leírás
access_token karakterlánc True A hitelesítéshez szükséges hozzáférési token.
type karakterlánc True Biztosan az access_token.

Telepítési név vektorizációs forrása

A vektorizációs forrás részletei, amelyeket az Azure OpenAI On Your Data használ vektorkeresés alkalmazásakor. Ez a vektorizációs forrás egy belső beágyazási modell telepítési nevén alapul ugyanabban az Azure OpenAI erőforrásban. Ez a vektorizációs forrás lehetővé teszi, hogy vektorkeresést használj Azure OpenAI api-kulcs nélkül, valamint Azure OpenAI nyilvános hálózati hozzáférés nélkül.

Name Típus Szükséges Leírás
deployment_name karakterlánc True A beágyazási modell telepítési neve ugyanabban az Azure OpenAI erőforrásban.
type karakterlánc True Biztosan az deployment_name.
dimensions egész szám Téves A beágyazásoknak hány dimenzióval kell rendelkezniük. Csak a beépült text-embedding-3 és későbbi modelleket támogatták.

Végpont vektorizációs forrás

A vektorizációs forrás részletei, amelyeket az Azure OpenAI On Your Data használ vektorkeresés alkalmazásakor. Ez a vektorizációs forrás az Azure OpenAI beágyazott API végpontján alapul.

Name Típus Szükséges Leírás
endpoint karakterlánc True Megadja az erőforrás végpont URL-jét, ahonnan a beágyazások le kell érkezni. Formátumban kell lennie https://{YOUR_RESOURCE_NAME}.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Az API-verziós lekérdezési paraméter nem engedélyezett.
authentication ApiKeyAuthenticationOptions True Megadja a hitelesítési opciókat, amelyeket a megadott végpontról történő beágyazások elővételéhez kell használni.
type karakterlánc True Biztosan az endpoint.
dimensions egész szám Téves A beágyazásoknak hány dimenzióval kell rendelkezniük. Csak a beépült text-embedding-3 és későbbi modelleket támogatták. Ez támogatott az api verzió 2024-10-21.

Mezőtérképezési lehetőségek

Opcionális beállítások annak szabályozására, hogyan dolgoznak fel a mezők egy konfigurált Azure Search erőforrás használatakor.

Name Típus Szükséges Leírás
content_fields string[] Téves Az indexmezők nevei, amelyeket tartalomként kell kezelni.
vector_fields string[] Téves A vektoradatokat képviselő mezők nevei.
content_fields_separator karakterlánc Téves A szeparátor mintázat, amit a tartalommezőknek használniuk kell. Az alapértelmezett .\n
filepath_field karakterlánc Téves Az indexmező neve, amelyet fájlútként kell használni.
title_field karakterlánc Téves Az indexmező neve, amelyet címként kell használni.
url_field karakterlánc Téves Az indexmező neve, amelyet URL-ként kell használni.

Lekérdezés típusa

Az a fajta Azure Search lekérdezés, amelyet akkor kell végrehajtani, ha Azure OpenAI-ként használod az adataidban.

Számérték Leírás
simple Az alapértelmezett, egyszerű lekérdezési elemzőt képviseli.
semantic A szemantikai lekérdezési elemzőt képviseli haladó szemantikai modellezéshez.
vector A vektorkeresést képviseli a számított adatok felett.
vector_simple_hybrid Az egyszerű lekérdezési stratégia és a vektoradatok kombinációját képviseli.
vector_semantic_hybrid A szemantikai keresés és a vektoradat-lekérdezés kombinációját képviseli.

Példák

Prerequisites:

  • Konfiguráld a szerepkiosztásokat az Azure OpenAI rendszeréből, amely kezelt identitáshoz rendelte az Azure kereső szolgáltatásnak. Kötelező szerepek: Search Index Data Reader, Search Service Contributor.
  • Konfiguráld a szerepkiosztásokat a felhasználótól az Azure OpenAI erőforráshoz. Kötelező szerep: Cognitive Services OpenAI User.
  • Telepítsd az CLI-t, és futtasd az login.
  • Definiáljuk a következő környezeti változókat: AzureOpenAIEndpoint, ChatCompletionsDeploymentName,SearchEndpoint, SearchIndex.
export AzureOpenAIEndpoint=https://example.openai.azure.com/
export ChatCompletionsDeploymentName=turbo
export SearchEndpoint=https://example.search.windows.net
export SearchIndex=example-index

Telepítsd a legújabb pip csomagokat 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")
search_endpoint = os.environ.get("SearchEndpoint")
search_index = os.environ.get("SearchIndex")

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

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

completion = client.chat.completions.create(
    model=deployment,
    messages=[
        {
            "role": "user",
            "content": "Who is DRI?",
        },
    ],
    extra_body={
        "data_sources": [
            {
                "type": "azure_search",
                "parameters": {
                    "endpoint": search_endpoint,
                    "index_name": search_index,
                    "authentication": {
                        "type": "system_assigned_managed_identity"
                    }
                }
            }
        ]
    }
)

print(completion.model_dump_json(indent=2))
  • Last updated on