GenAI Prompt-färdighet

GenAI-kommandotolken (Generative AI) kör en begäran om att slutföra chatten mot en stor språkmodell (LLM) som distribuerats i Azure OpenAI i Foundry Models eller Microsoft Foundry. Använd den här färdigheten för att skapa ny information som kan indexeras och lagras som sökbart innehåll.

Här följer några exempel på hur GenAI-frågefärdigheten kan hjälpa dig att skapa innehåll:

• Verbalisera bilder
• Sammanfatta stora textavsnitt
• Förenkla komplext innehåll
• Utför alla andra uppgifter som du kan formulera i en fråga

GenAI Prompt-färdigheten är allmänt tillgänglig i 2026-04-01 Search Service REST API och i Azure-SDK:er som riktar sig mot den här versionen. Den här färdigheten stöder text, bild och multimodalt innehåll, till exempel bilder med visuella objekt och text som extraherats från PDF-filer.

Modeller som stöds

• Du kan använda valfri slutsatsdragningsmodell för chatten som distribueras i Foundry, till exempel GPT-modeller, DeepSeek-R#, Llama-4-Maverick och Cohere-command-r. Specifikt för GPT-modeller stöds endast API-slutpunkter för chattslutpunkter. Slutpunkter som använder Azure OpenAI Responses API (som innehåller /openai/responses i URI: n) är för närvarande inte kompatibla.

• För verbalisering av bilder avgör modellen som du använder för att analysera bilden vilka bildformat som stöds.

• För GPT-5-modeller stöds inte parametern temperature på samma sätt som tidigare modeller. Om det definieras måste det anges till 1.0, eftersom andra värden resulterar i fel.

• Fakturering baseras på prissättningen för den modell som du använder.

Förutsättningar

• En Azure OpenAI i Foundry Models-resursen eller Foundry-projektet.

• En modell som stöds som distribueras till din resurs eller ditt projekt.

  • För Azure OpenAI kopierar du slutpunkten med domänen openai.azure.com från sidan Nycklar och slutpunkt i Azure-portalen. Använd den här slutpunkten för parametern i den här färdigheten Uri .

  • För Foundry kopierar du mål-URI:n för distributionen från sidan Modeller i Foundry-portalen. Använd den här slutpunkten för parametern i den här färdigheten Uri .

• Autentisering kan vara nyckelbaserad med en API-nyckel från din Foundry- eller Azure OpenAI-resurs. Vi rekommenderar dock rollbaserad åtkomst med hjälp av en hanterad identitet för söktjänsten som tilldelats en roll.

  • I Azure OpenAI tilldelar du Cognitive Services OpenAI-användare till den hanterade identiteten.

  • På Foundry tilldelar du Foundry User till den hanterade identiteten.

    Important

    Foundrys RBAC-roller har nyligen namnändrats. Foundry User, Foundry Owner, Foundry Account Owner och Foundry Project Manager hette tidigare Azure AI-användare, Azure AI-ägare, Azure AI-kontoägare och Azure AI Project Manager. Du kanske fortfarande ser de tidigare namnen på vissa platser medan namnbytet distribueras. Roll-ID:na och kärnbehörigheterna ändras inte av namnbytet.

@odata.type

#Microsoft.Skills.Custom.ChatCompletionSkill

Databegränsningar

Kompetensparametrar

* Exakt en av apiKey, authIdentityeller tjänstens systemtilldelade identitet måste användas.

commonModelParameters Standardvärden

Kunskapsindata

Färdighetsresultat

Exempeldefinitioner

Sammanfattning av endast text

{
  "@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 }
}

Beskrivning av text och bild

{
  "@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" }
}

Strukturerad numerisk faktasökare

{
  "@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
      }
    }
  }
}

Exempelutdata (trunkerade)

{
  "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
    }
  }
}

Metodtips

• Dela upp långa dokument med färdigheten Textdelning för att hålla dig inom modellens kontextfönster.
• För indexering med stora volymer tillägnar du en separat modelldistribution till den här färdigheten så att tokenkvoter för RAG-arbetsbelastningar för frågetid inte påverkas.
• För att minimera svarstiden, samlokalisera modellen och Azure AI-sökning-tjänsten i samma Azure-region.
• Använd responseFormat.json_schema med GPT-4o för tillförlitlig strukturerad extrahering och enklare mappning till indexfält.
• Övervaka tokenanvändningen och skicka begäranden om kvotökning om indexeraren mättar dina TPM-gränser (Token per minut).

Fel och varningar

Säkerhetsöverväganden för hanterad identitetsautentisering

När GenAI Prompt-färdigheten använder hanterad identitetsautentisering hämtar Azure AI-sökning en Microsoft Entra åtkomsttoken för Foundry Tools-målgruppen (https://cognitiveservices.azure.com) och inkluderar den i begäranden som skickas till slutpunkten som anges av uri. Hanterad identitetsautentisering gäller när authIdentity anges, eller när båda apiKey och authIdentity är tomma och tjänsten använder den systemtilldelade identiteten.

Slutpunkten som refereras av uri förväntas vara din egen Azure OpenAI- eller Foundry-resurs. Domäner som stöds är:

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

Azure API Management(APIM) slutpunkter (*.azure-api.net) och anpassade domäner som ligger framför dessa resurser stöds också. Eftersom en anpassad domän eller ETT APIM-värdnamn inte kan verifieras enbart från namnet verifierar Azure AI-sökning dessa slutpunkter med en liveanslutningskontroll vid konfigurationstillfället i stället för genom domänmatchning. Du ansvarar för att konfigurera och underhålla relationen mellan slutpunkten och Azure OpenAI- eller Foundry-resursen bakom den.

Rekommenderade säkerhetsmetoder

Följ dessa metoder för att upprätthålla en säker distribution:

• Ange uri endast till slutpunkter som du äger och litar på. Föredrar de Foundry Tools-domäner som angavs tidigare. Om du använder en APIM- eller slutpunkt för anpassad domän bekräftar du att den frontar din egen resurs innan du aktiverar hanterad identitet. Ett betrott värdnamn är inte ett bevis på ägarskap.
• Tillämpa principen om lägsta behörighet på den hanterade identitet som används av söktjänsten:
  • På Azure OpenAI tilldelar du endast Cognitive Services OpenAI-användare.
  • På Foundry tilldelar du endast Foundry-användare. Undvik att bevilja bredare roller.
• Använd nätverkssäkerhetsperimeter (NSP) och privata slutpunkter eller VNet-integrering för att begränsa vilka slutpunkter söktjänsten kan nå och vilka källor målresursen accepterar begäranden från.
• Om du använder en APIM- eller slutpunkt för anpassad domän kontrollerar du att gatewayen validerar inkommande begäranden och vidarebefordrar dem endast till den avsedda serverdelen. Du bör också granska dess åtkomstprinciper med jämna mellanrum.
• Föredrar hanterad identitet framför apiKey. Om du använder apiKeylagrar och roterar du det på ett säkert sätt och bäddar inte in det i källkontrollen. Tjänsten avvisar konfigurationer som anger både apiKey och authIdentity.
• Granska regelbundet definitioner för kompetensuppsättningar, tilldelningar av hanterade identitetsroller samt APIM- och anpassade domänkonfigurationer för att bekräfta att uri värden, åtkomstkontroller och identitetsbehörigheter fortfarande är aktuella och lämpliga. Granska konfigurationsändringar via dina etablerade processer för ändringshantering och säkerhetsgranskning.
• Övervaka Azure OpenAI, Foundry Tools och Foundry-inloggningsloggar, autentiseringshändelser och åtkomstloggar för oväntad eller obehörig aktivitet.
• Ta bort oanvända kunskaper, slutpunkter, rolltilldelningar och API-nycklar som inte längre krävs.

Begränsa åtkomsten till konfiguration av kompetensuppsättningar

Användare som kan skapa, ändra eller köra kompetensuppsättningar styr både målslutpunkten (uri) och autentiseringskonfigurationen som används av kunskapen. Eftersom färdigheten skickar en hanterad identitetstoken för Foundry Tools-målgruppen till slutpunkten begränsar du dessa behörigheter till betrodda administratörer och följer dina standardprocesser för ändringshantering och säkerhetsgranskning när du konfigurerar hanterade identitetsaktiverade kunskaper.

Se även

• Inbyggda indexerare i Azure AI-sökning
• Integrerad vektorisering
• Så här definierar du en kompetensuppsättning
• Så här genererar du chattavslut med Azure AI-modellinferens (Foundry)
• Strukturerade utdata i Azure OpenAI