GenAI prompt képesség

A GenAI (Generatív AI) Prompt képesség chat befejezés kérést hajt végre egy nagy nyelvi modell (LLM) ellen, amelyet Azure OpenAI-ban telepítettek Foundry Models vagy Microsoft Foundry formátumokban. Ezt a készséget használd új információk létrehozására, amelyeket indexelni és kereshető tartalomként tárolni.

Íme néhány példa arra, hogyan segíthet a GenAI prompt képesség tartalom létrehozásában:

• Képek verbálissáítása
• Foglalja össze a nagy szövegrészeket
• Egyszerűsítsd a bonyolult tartalmat
• Végezz el bármilyen más feladatot, amit egy promptban meg tudsz fogalmazni

A GenAI Prompt képesség általában elérhető a 2026-04-01 Search Service REST API és Azure SDK-k verzióban. Ez a képesség támogatja a szöveg-, kép- és multimodális tartalmakat, például képeket vizuális megjelenítéssel, illetve PDF fájlokból kinyert szöveget.

Támogatott modellek

• Használhatja a Foundryben üzembe helyezett csevegés-befejezési következtetési modelleket , például a GPT-modelleket, a DeepSeek-R#-t, a Llama-4-Mavericket és a Cohere-command-r-t. Kifejezetten a GPT modellek esetében csak a chat befejezések API végpontjai támogatottak. Az Azure OpenAI Responses API-t használó végpontok (amelyek az URI-ben /openai/responses szerepelnek) jelenleg nem kompatibilisek.

• A kép verbalizálásához az a modell, amit a kép elemzéséhez használsz, határozza meg, mely képformátumok támogatottak.

• A GPT-5 modelleknél a temperature paraméter nem ugyanúgy támogatott, mint a korábbi modellek. Ha definiálva van definiálva, akkor be kell állítani 1.0, mivel más értékek hibákat okozhatnak.

• A számlázás a használt modell árán alapul.

Prerequisites

• Azure OpenAI in Foundry Models resource vagy Foundry project.

• Egy támogatott modell , amelyet az erőforrásodban vagy projektedben telepítettek.

  • Azure OpenAI-hoz másold le a végpontot a openai.azure.com domainrel a Keys és a Endpoint oldalról a Azure portálon. Használd ezt a végpontot a Uri képesség paraméteréhez.

  • A Foundry esetében másold le a telepítés cél URI-jét a Modellek oldalról a Foundry portálon. Használd ezt a végpontot a Uri képesség paraméteréhez.

• A hitelesítés lehet kulcsalapú API kulcs segítségével, amely a Foundry-ből vagy az Azure OpenAI erőforrásból származik. Ugyanakkor javasoljuk, hogy egy szerepkörhöz rendelt keresőszolgáltatás által kezelt identitással rendelkező szerepalapú hozzáférést alkalmazzunk.

  • Azure OpenAI-n rendeld Cognitive Services OpenAI User a menedzselt identitáshoz.

  • A Foundryben rendelje hozzá az Öntödei felhasználót a felügyelt identitáshoz.

    Important

    Az Foundry RBAC-szerepköröket nemrég átnevezték. Foundry user, Foundry Owner, Foundry-fióktulajdonos és Foundry Project Manager korábban Azure AI-felhasználónak, Azure AI-tulajdonosnak, Azure AI-fióktulajdonosnak és Azure AI-Project-kezelőnek hívták. Előfordulhat, hogy egyes helyeken továbbra is megjelennek az előző nevek, amíg az átnevezés ki nem történik. A szerepkör-azonosítók és az alapvető engedélyek az átnevezés során módosulnak.

@odata.type

#Microsoft.Skills.Custom.ChatCompletionSkill

Adatkorlátok

Képességparaméterek

* Pontosan azapiKeyegyik , authIdentity, vagy a szolgáltatás rendszerhez rendelt identitását kell használni.

commonModelParameters Alapértelmezések

Készségbemenetek

Képességkimenetek

Mintadefiníciók

Csak szöveges összegzés

{
  "@odata.type": "#Microsoft.Skills.Custom.ChatCompletionSkill",
  "name": "Summarizer",
  "description": "Summarizes document content.",
  "context": "/document",
  "inputs": [
    { "name": "text", "source": "/document/content" },
    { "name": "systemMessage", "source": "='You are a concise AI assistant.'" },
    { "name": "userMessage", "source": "='Summarize the following text:'" }
  ],
  "outputs": [ { "name": "response" } ],
  "uri": "https://demo.openai.azure.com/openai/deployments/gpt-4o/chat/completions",
  "apiKey": "<api-key>",
  "commonModelParameters": { "temperature": 0.3 }
}

Szöveg + kép leírása

{
  "@odata.type": "#Microsoft.Skills.Custom.ChatCompletionSkill",
  "name": "Image Describer",
  "context": "/document/normalized_images/*",
  "inputs": [
    { "name": "image", "source": "/document/normalized_images/*/data" },
    { "name": "imageDetail", "source": "=high" },
    { "name": "systemMessage", "source": "='You are a useful AI assistant.'" },
    { "name": "userMessage", "source": "='Describe this image:'" }
  ],
  "outputs": [ { "name": "response" } ],
  "uri": "https://demo.openai.azure.com/openai/deployments/gpt-4o/chat/completions",
  "authIdentity": "11111111-2222-3333-4444-555555555555",
  "responseFormat": { "type": "text" }
}

Strukturált numerikus tényfeltáró

{
  "@odata.type": "#Microsoft.Skills.Custom.ChatCompletionSkill",
  "name": "NumericalFactFinder",
  "context": "/document",
  "inputs": [
    { "name": "systemMessage", "source": "='You are an AI assistant that helps people find information.'" },
    { "name": "userMessage", "source": "='Find all the numerical data and put it in the specified fact format.'"}, 
    { "name": "text", "source": "/document/content" }
  ],
  "outputs": [ { "name": "response" } ],
  "uri": "https://demo.openai.azure.com/openai/deployments/gpt-4o/chat/completions",
  "apiKey": "<api-key>",
  "responseFormat": {
    "type": "json_schema",
    "jsonSchemaProperties": {
      "name": "NumericalFactObj",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": "{\"facts\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"number\":{\"type\":\"number\"},\"fact\":{\"type\":\"string\"}},\"required\":[\"number\",\"fact\"]}}}",
        "required": [ "facts" ],
        "additionalProperties": false
      }
    }
  }
}

Mintakimenet (lerövidítve)

{
  "response": {
    "facts": [
      { "number": 32.0, "fact": "Jordan scored 32 points per game in 1986-87." },
      { "number": 6.0,  "fact": "He won 6 NBA championships." }
    ]
  },
  "usageInformation": {
    "usage": {
      "completion_tokens": 203,
      "prompt_tokens": 248,
      "total_tokens": 451
    }
  }
}

Bevált gyakorlatok

• Hosszú dokumentumokat osztasz a Text Split képességgel, hogy a modell kontextusablakában maradjon.
• Nagy volumenű indexeléshez külön modelltelepítést szentelj ennek a képességnek, hogy a lekérdezési idejű RAG munkaterhelések token kvótái érintetlenek maradjanak.
• A késleltetés minimalizálása érdekében helyezze el a modellt és az Azure AI Keresés szolgáltatást ugyanabban az Azure régióban.
• Használat responseFormat.json_schemaGPT-4o-val megbízható strukturált kivonáshoz és egyszerűbb indexmezőhöz való leképezéshez.
• Figyeld a token használatát, és nyújtsd be kvótanövelési kéréseket , ha az indexelő kitölti a Tokens per Minute (TPM) limiteket.

Hibák és figyelmeztetések

A felügyelt identitás hitelesítésének biztonsági szempontjai

Ha a GenAI Prompt képesség felügyelt identitás-hitelesítést használ, Azure AI Keresés lekér egy Microsoft Entra hozzáférési jogkivonatot az Foundry Tools célközönségéhez (https://cognitiveservices.azure.com), és beleszámítja a megadott urivégpontra küldött kérelmekbe. A felügyelt identitás hitelesítése akkor érvényes, ha authIdentity be van állítva, vagy ha mindkettő apiKeyauthIdentity üres, és a szolgáltatás a rendszer által hozzárendelt identitást használja.

A hivatkozott uri végpont várhatóan a saját Azure OpenAI- vagy Foundry-erőforrás lesz. A támogatott tartományok a következők:

• openai.azure.com
• cognitiveservices.azure.com
• services.ai.azure.com

Azure API Management (APIM-) végpontok (*.azure-api.net) és az erőforrásokat kezelő egyéni tartományok is támogatottak. Mivel egy egyéni tartomány vagy APIM-állomásnév önmagában nem ellenőrizhető a nevéből, Azure AI Keresés ezeket a végpontokat konfigurációs időpontban, nem pedig tartományegyeztetéssel, élő kapcsolatellenőrzéssel ellenőrzi. Ön felel a végpont és a mögötte található Azure OpenAI vagy Foundry erőforrás közötti kapcsolat konfigurálásáért és fenntartásáért.

Ajánlott biztonsági eljárások

A biztonságos üzembe helyezés fenntartásához kövesse az alábbi eljárásokat:

• Csak a saját és megbízható végpontokra van beállítva uri . A korábban felsorolt Foundry Tools-tartományok előnyben részesítése. Ha APIM-ot vagy egyéni tartományvégpontot használ, a felügyelt identitás engedélyezése előtt győződjön meg arról, hogy a saját erőforrása elé tartozik. A megbízhatónak látszó gazdagépnév nem bizonyítja a tulajdonjogot.
• Alkalmazza a minimális jogosultság elvét a keresési szolgáltatás által használt felügyelt identitásra:
  • Az OpenAI Azure csak Cognitive Services OpenAI-felhasználót rendelhet hozzá.
  • A Foundryben csak öntödei felhasználót rendeljen hozzá. Kerülje a szélesebb szerepkörök megadását.
• A hálózati biztonsági szegélyhálózat (NSP) és a privát végpontok vagy a VNet-integráció használatával korlátozhatja, hogy a keresési szolgáltatás mely végpontokat érheti el, és mely forrásokból fogadja a célerőforrás a kéréseket.
• Ha APIM-ot vagy egyéni tartományvégpontot használ, győződjön meg arról, hogy az átjáró ellenőrzi a bejövő kéréseket, és csak a kívánt háttérrendszernek továbbítja őket. A hozzáférési szabályzatokat rendszeresen át kell tekintenie.
• Inkább a felügyelt identitást részesítse előnyben.apiKey Ha használja apiKey, tárolja és forgassa biztonságosan, és ne ágyazza be a forrásvezérlőbe. A szolgáltatás elutasítja a mindkettőt apiKey és authIdentitya .
• Rendszeresen tekintse át a képességkészlet-definíciókat, a felügyelt identitásszerepkör-hozzárendeléseket, valamint az APIM- és egyéni tartománykonfigurációkat annak ellenőrzéséhez, hogy az értékek, a hozzáférés-vezérlés és az identitásengedélyek továbbra is aktuálisak és megfelelőek maradnak-e uri . Tekintse át a konfigurációs módosításokat a már létrehozott változáskezelési és biztonsági felülvizsgálati folyamatokkal.
• Monitorozza Azure OpenAI, Foundry Tools és Foundry bejelentkezési naplókat, hitelesítési eseményeket és hozzáférési naplókat váratlan vagy jogosulatlan tevékenységek esetén.
• Távolítsa el a már nem használt készségeket, végpontokat, szerepkör-hozzárendeléseket és API-kulcsokat.

A képességkészlet-konfigurációhoz való hozzáférés korlátozása

Azok a felhasználók, akik képességkészleteket hozhatnak létre, módosíthatnak vagy futtathatnak, vezérelhetik a célvégpontot (uri) és a képesség által használt hitelesítési konfigurációt is. Mivel a képesség egy felügyelt identitási jogkivonatot küld az Foundry Tools célközönségének erre a végpontra, korlátozza ezeket az engedélyeket a megbízható rendszergazdák számára, és kövesse a szabványos változáskezelési és biztonsági felülvizsgálati folyamatokat a felügyelt identitással kompatibilis készségek konfigurálásakor.

Lásd még

• Azure AI Keresés beépített indexelők
• Integrált vektorizáció
• Hogyan definiáljuk a készségkészletet
• Hogyan generáljunk csevegéseket Azure AI modell következtetésével (Foundry)
• strukturált kimenetek Azure OpenAI