GenAI Prompt vaardigheid

Met de GenAI-promptvaardigheid (Generatieve AI) wordt een aanvraag voor het voltooien van een chat uitgevoerd op basis van een groot taalmodel (LLM) dat is geïmplementeerd in Azure OpenAI in Foundry Models of Microsoft Foundry. Gebruik deze vaardigheid om nieuwe informatie te maken die kan worden geïndexeerd en opgeslagen als doorzoekbare inhoud.

Hier volgen enkele voorbeelden van hoe de GenAI-promptvaardigheid u kan helpen bij het maken van inhoud:

• Afbeeldingen verbaal maken
• Grote passages van tekst samenvatten
• Complexe inhoud vereenvoudigen
• Voer een andere taak uit die u in een prompt kunt formuleren

De GenAI-promptvaardigheid is algemeen beschikbaar in de 2026-04-01 REST API van de zoekservice en in Azure-SDK's die deze versie targeten. Deze vaardigheid ondersteunt tekst, afbeeldingen en multimodale inhoud, zoals afbeeldingen met visuals en tekst die zijn geëxtraheerd uit PDF-bestanden.

Ondersteunde modellen

• U kunt elk deductiemodel voor voltooiing van chats gebruiken dat is geïmplementeerd in Foundry, zoals GPT-modellen, DeepSeek-R#, Llama-4-Maverick en Cohere-command-r. Voor GPT-modellen worden alleen de API-eindpunten voor chatvoltooiingen ondersteund. Eindpunten die gebruikmaken van de Api voor Azure OpenAI-antwoorden (die in de URI zijn opgenomen /openai/responses ) zijn momenteel niet compatibel.

• Voor beeld verbaalgebruik bepaalt het model dat u gebruikt om de afbeelding te analyseren welke afbeeldingsindelingen worden ondersteund.

• Voor GPT-5-modellen wordt de temperature parameter niet op dezelfde manier ondersteund als eerdere modellen. Indien gedefinieerd, moet deze worden ingesteld op 1.0, omdat andere waarden leiden tot fouten.

• Facturering is gebaseerd op de prijzen van het model dat u gebruikt.

Vereiste voorwaarden

• Een Azure OpenAI in Foundry Models-resource of Foundry-project.

• Een ondersteund model dat is geïmplementeerd in uw resource of project.

  • Kopieer voor Azure OpenAI het eindpunt met het openai.azure.com domein vanaf de pagina Sleutels en Eindpunt in Azure Portal. Gebruik dit eindpunt voor de Uri parameter in deze vaardigheid.

  • Kopieer voor Foundry de doel-URI voor de implementatie vanaf de pagina Modellen in de Foundry-portal. Gebruik dit eindpunt voor de Uri parameter in deze vaardigheid.

• Verificatie kan worden gebaseerd op sleutels met een API-sleutel uit uw Foundry- of Azure OpenAI-resource. We raden echter aan om op rollen gebaseerde toegang te gebruiken met behulp van een door de zoekservice beheerde identiteit die is toegewezen aan een rol.

  • Wijs in Azure OpenAI Cognitive Services OpenAI-gebruiker toe aan de beheerde identiteit.

  • Wijs In Foundry Foundry Foundry User toe aan de beheerde identiteit.

    Important

    De rollen Foundry RBAC zijn onlangs hernoemd. Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.

@odata.type

#Microsoft.Skills.Custom.ChatCompletionSkill

Gegevenslimieten

Vaardigheidsparameters

* Precies één van, apiKeyof de authIdentity identiteit van de service moet worden gebruikt.

commonModelParameters Standaardinstellingen

Invoer van vaardigheden

Uitvoer van vaardigheden

Voorbeelddefinities

Samenvatting van alleen tekst

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

Beschrijving van tekst en afbeelding

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

Gestructureerde numerieke feitenzoeker

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

Voorbeelduitvoer (afgekapt)

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

Beste praktijken

• Lange documenten segmenteren met de vaardigheid Tekst splitsen om binnen het contextvenster van het model te blijven.
• Wijs voor indexering met grote volumes een afzonderlijke modelimplementatie toe aan deze vaardigheid, zodat tokenquota voor RAG-workloads in querytijd niet worden beïnvloed.
• Als u de latentie wilt minimaliseren, zoekt u het model en uw Azure AI Zoeken-service in dezelfde Azure-regio.
• Gebruik responseFormat.json_schema met GPT-4o voor betrouwbare gestructureerde extractie en eenvoudigere toewijzing aan indexvelden.
• Bewaak het tokengebruik en verzend aanvragen voor quotumverhoging als de indexeerfunctie uw tpm-limieten (Tokens per minuut) verzadigt.

Fouten en waarschuwingen

Beveiligingsoverwegingen voor verificatie van beheerde identiteiten

Wanneer de GenAI Prompt-vaardigheid gebruikmaakt van verificatie van beheerde identiteiten, verkrijgt Azure AI Zoeken een Microsoft Entra toegangstoken voor de Foundry Tools-doelgroep (https://cognitiveservices.azure.com) en bevat deze in aanvragen die worden verzonden naar het eindpunt dat is opgegeven dooruri. Verificatie van beheerde identiteit is van toepassing wanneer authIdentity deze is ingesteld of wanneer beide apiKey leeg zijn en authIdentity de service gebruikmaakt van de door het systeem toegewezen identiteit.

Het eindpunt waarnaar wordt verwezenuri, is naar verwachting uw eigen Azure OpenAI- of Foundry-resource. Ondersteunde domeinen zijn:

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

Azure API Management (APIM)-eindpunten (*.azure-api.net) en aangepaste domeinen die voor deze resources worden gebruikt, worden ook ondersteund. Omdat een aangepast domein of APIM-hostnaam niet alleen kan worden geverifieerd op basis van de naam, valideert Azure AI Zoeken deze eindpunten met een live-connectiviteitscontrole tijdens de configuratie in plaats van door domeinkoppeling. U bent verantwoordelijk voor het configureren en onderhouden van de relatie tussen het eindpunt en de Azure OpenAI- of Foundry-resource daarachter.

Aanbevolen beveiligingsprocedures

Volg deze procedures om een veilige implementatie te onderhouden:

• Alleen instellen uri op eindpunten die u bezit en vertrouwt. Geef de voorkeur aan de domeinen Foundry Tools die eerder zijn vermeld. Als u een APIM- of aangepast domeineindpunt gebruikt, controleert u of het uw eigen resource fronteert voordat u beheerde identiteit inschakelt. Een vertrouwde hostnaam is geen bewijs van eigendom.
• Pas het principe van minimale bevoegdheden toe op de beheerde identiteit die wordt gebruikt door de zoekservice:
  • Wijs in Azure OpenAI alleen Cognitive Services OpenAI-gebruiker toe.
  • Wijs in Foundry alleen Foundry User toe. Vermijd het verlenen van bredere rollen.
• Gebruik netwerkbeveiligingsperimeter (NSP) en privé-eindpunten of VNet-integratie om te beperken welke eindpunten de zoekservice kan bereiken en welke bronnen de doelresource aanvragen accepteert.
• Als u een APIM- of aangepast domeineindpunt gebruikt, moet u ervoor zorgen dat de gateway binnenkomende aanvragen valideert en deze alleen doorstuurt naar de beoogde back-end. Controleer ook regelmatig het toegangsbeleid.
• Geef de voorkeur aan beheerde identiteit boven apiKey. Als u deze gebruikt apiKey, slaat u deze veilig op en draait u deze niet in broncodebeheer. De service weigert configuraties die beide apiKey en authIdentity.
• Controleer regelmatig de definities van vaardighedensets, roltoewijzingen van beheerde identiteiten en APIM- en aangepaste domeinconfiguraties om te bevestigen dat uri waarden, toegangsbeheer en identiteitsmachtigingen actueel en passend blijven. Controleer configuratiewijzigingen via de bestaande processen voor wijzigingsbeheer en beveiligingsbeoordeling.
• Bewaak Azure OpenAI, Foundry Tools en Foundry-aanmeldingslogboeken, verificatiegebeurtenissen en toegangslogboeken voor onverwachte of niet-geautoriseerde activiteiten.
• Verwijder ongebruikte vaardigheden, eindpunten, roltoewijzingen en API-sleutels die niet meer nodig zijn.

Toegang tot de configuratie van vaardighedensets beperken

Gebruikers die vaardighedensets kunnen maken, wijzigen of uitvoeren, beheren zowel het doeleindpunt (uri) als de verificatieconfiguratie die door de vaardigheid wordt gebruikt. Omdat de vaardigheid een beheerde identiteitstoken verzendt voor de Foundry Tools-doelgroep naar dat eindpunt, beperkt u deze machtigingen tot vertrouwde beheerders en volgt u uw standaardprocessen voor wijzigingsbeheer en beveiligingsbeoordeling bij het configureren van vaardigheden met beheerde identiteiten.

Zie ook

• Ingebouwde indexeerfuncties van Azure AI Zoeken
• Geïntegreerde vectorisatie
• Een vaardighedenset definiëren
• Chatvoltooiingen genereren met Azure AI-modeldeductie (Foundry)
• Gestructureerde uitvoer in Azure OpenAI