GenAI İstem yeteneği

GenAI (Generative AI) Prompt becerisi, Azure OpenAI in Foundry Models veya Microsoft Foundry içinde konuşlandırılan büyük bir dil modeline (LLM) karşı sohbet tamamlama talebini uygular. Bu beceriyi, aranabilir içerik olarak indekslenip saklanabilen yeni bilgiler oluşturmak için kullanın.

İşte GenAI prompt becerisinin içerik yaratmanıza nasıl yardımcı olabileceğine dair bazı örnekler:

• Görüntüleri sözelleştirme
• Metnin büyük pasajlarını özetle
• Karmaşık içeriği basitleştirin
• Bir promptta ifade edebileceğiniz başka herhangi bir görevi yapın

GenAI İstemi becerisi genellikle 2026-04-01 Arama Servisi REST API ve bu sürümü hedefleyen Azure SDK’ları dosyalarında mevcuttur. Bu beceri, metin, görüntü ve görseller ile PDF dosyalarından çıkarılmış metin gibi çoklu modal içerikleri destekler.

Desteklenen modeller

• GPT modelleri, DeepSeek-R#, Llama-4-Maverick ve Cohere-command-r gibi Foundry'de dağıtılan herhangi bir sohbet tamamlama çıkarım modelini kullanabilirsiniz. Özellikle GPT modelleri için yalnızca chat tamamlama API uç noktaları desteklenmektedir. Azure OpenAI Responses API'sini (URI'de /openai/responses içeren) kullanan uç noktalar şu anda uyumlu değil.

• Görüntü sözlemesi için, görüntüyü analiz etmek için kullandığınız model hangi görüntü formatlarının desteklendiğini belirler.

• GPT-5 modelleri için parametre, temperature önceki modellerdeki gibi desteklenmemektedir. Tanımlanmışsa, diğer değerler hatalara yol açacağı için , olarak 1.0ayarlanmalıdır.

• Faturalandırma, kullandığınız modelin fiyatına göre belirlenir.

Prerequisites

• Döküm Modellerinde Azure OpenAI kaynağı veya Foundry projesi.

• Kaynağınıza veya projenize dağıtılan desteklenen bir model .

  • OpenAI Azure için, Azure portalındaki openai.azure.com sayfasından alan adresiyle uç noktayı kopyalayın. Bu becerideki parametre için bu uç noktayı Uri kullanın.

  • Foundry için, Foundry portalındaki Modeller sayfasından dağıtım için hedef URI'yi kopyalayın. Bu becerideki parametre için bu uç noktayı Uri kullanın.

• Doğrulama, Foundry'nizden veya Azure OpenAI kaynağından bir API anahtarıyla anahtar tabanlı olabilir. Ancak, bir role atanan arama hizmeti yönetilen kimlik kullanılarak rol tabanlı erişim öneriyoruz.

  • OpenAI Azure için, yönetilen kimliğe Bilişsel Hizmetler OpenAI Kullanıcısı atayın.

  • Foundry'de, yönetilen kimliğe Foundry Kullanıcısı'nı atayın.

    Important

    Foundry RBAC rolleri yakın zamanda yeniden adlandırıldı. Foundry User, Foundry Owner, Foundry Hesabı Sahibi ve Foundry Project Manager daha önce Azure Yapay Zeka Kullanıcısı, Azure Yapay Zeka Sahibi, Azure Yapay Zeka Hesabı Sahibi ve Azure Yapay Zeka Project Yöneticisi olarak adlandırıldı. Yeniden adlandırma kullanıma sunulmaya devam ederken bazı yerlerde önceki adları görmeye devam edebilirsiniz. Rol kimlikleri ve temel izinler yeniden adlandırma ile değiştirilmez.

@odata.type

#Microsoft.Skills.Custom.ChatCompletionSkill

Veri sınırları

Beceri parametreleri

* Tam olarak ,apiKeyauthIdentity, veya hizmetin sistem tarafından atanan kimliği kullanılmalıdır.

commonModelParameters Varsayılan Durumlar

Beceri girişleri

Beceri çıkışları

Örnek tanımlar

Yalnızca metin özetleme

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

Metin + resim açıklaması

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

Yapılandırılmış sayısal bilgi bulucu

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

Örnek çıktısı (kısılmış)

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

En iyi uygulamalar

• Metin Bölme yeteneğiyle uzun belgeleri modelin bağlam penceresinde kalmak için parçalayın.
• Yüksek hacimli indeksleme için, sorgu zamanı RAG iş yükleri için token kotalarının etkilenmemesi için bu beceriye ayrı bir model dağıtımı ayırın.
• Gecikmeyi en aza indirmek için, modeli ve Azure Yapay Zeka Arama hizmetinizi aynı Azure bölgesinde aynı yerde konumlandırın.
• Güvenilir yapılandırılmış çıkarım ve indeks alanlarına daha kolay eşleme responseFormat.json_schema ile kullanım.
• Token kullanımını izleyin ve endeksleyici Token per Minute (TPM) sınırlarınızı doyurursa kota artışı talepleri gönderin.

Hatalar ve uyarılar

Yönetilen kimlik kimlik doğrulaması için güvenlikle ilgili dikkat edilmesi gerekenler

GenAI İstemi becerisi yönetilen kimlik doğrulaması kullandığında, Azure Yapay Zeka Arama Foundry Tools hedef kitlesi (https://cognitiveservices.azure.com) için bir Microsoft Entra erişim belirteci alır ve tarafından uribelirtilen uç noktaya gönderilen isteklere ekler. Yönetilen kimlik kimlik doğrulaması ayarlandığında veya hem hem de authIdentityapiKey boş olduğunda ve hizmet sistem tarafından atanan kimliği kullandığında uygulanırauthIdentity.

tarafından uri başvurulan uç noktanın kendi OpenAI veya Foundry kaynağınız Azure olması beklenir. Desteklenen etki alanları şunlardır:

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

Azure API Management (APIM) uç noktaları (*.azure-api.net) ve bu kaynakları önleyen özel etki alanları da desteklenir. Özel bir etki alanı veya APIM ana bilgisayar adı yalnızca adından doğrulanamadığından Azure Yapay Zeka Arama bu uç noktaları etki alanı eşleştirme yerine yapılandırma zamanında canlı bağlantı denetimiyle doğrular. Uç nokta ile arkasındaki OpenAI veya Foundry kaynağının Azure arasındaki ilişkiyi yapılandırmak ve sürdürmek sizin sorumluluğundadır.

Önerilen güvenlik uygulamaları

Güvenli bir dağıtımın korunmasına yardımcı olmak için şu uygulamaları izleyin:

• Yalnızca sahip olduğunuz ve güvendiğiniz uç noktalara ayarlayın uri . Daha önce listelenen Döküm Araçları etki alanlarını tercih edin. APIM veya özel etki alanı uç noktası kullanıyorsanız, yönetilen kimliği etkinleştirmeden önce kendi kaynağınızın önünde olduğunu onaylayın. Güvenilir görünümlü bir ana bilgisayar adı sahiplik kanıtı değildir.
• Arama hizmeti tarafından kullanılan yönetilen kimliğe en az ayrıcalık ilkesini uygulayın:
  • Azure OpenAI'de yalnızca Bilişsel Hizmetler OpenAI Kullanıcısı atayın.
  • Foundry'de, yalnızca Foundry Kullanıcı'yı atayın. Daha geniş roller vermekten kaçının.
• Arama hizmetinin ulaşabileceği uç noktaları ve hedef kaynağın istekleri kabul ettiği kaynakları kısıtlamak için Ağ Güvenlik Çevresi (NSP) ve özel uç noktaları veya sanal ağ tümleştirmesini kullanın.
• APIM veya özel etki alanı uç noktası kullanıyorsanız ağ geçidinin gelen istekleri doğrulayıp yalnızca hedeflenen arka uca ilettiğinden emin olun. Ayrıca erişim ilkelerini düzenli aralıklarla gözden geçirmelisiniz.
• Yönetilen kimliği yerine tercih edin apiKey. kullanıyorsanız apiKey, güvenli bir şekilde depolayıp döndürün ve kaynak denetimine eklemeyin. Hizmet, hem apiKeyhem de authIdentity ayarlayan yapılandırmaları reddeder.
• Beceri kümesi tanımlarını, yönetilen kimlik rolü atamalarını, APIM ve özel etki alanı yapılandırmalarını düzenli aralıklarla gözden geçirerek değerlerin uri , erişim denetimlerinin ve kimlik izinlerinin güncel ve uygun kaldığını onaylayın. Yerleşik değişiklik yönetimi ve güvenlik gözden geçirme süreçlerinizle yapılandırma değişikliklerini gözden geçirin.
• Beklenmeyen veya yetkisiz etkinlikler için OpenAI, Foundry Araçları ve Dökümhane oturum açma günlüklerini, kimlik doğrulama olaylarını ve erişim günlüklerini Azure izleyin.
• Artık gerekli olmayan kullanılmayan becerileri, uç noktaları, rol atamalarını ve API anahtarlarını kaldırın.

Beceri kümesi yapılandırmasına erişimi kısıtlama

Beceri kümelerini oluşturabilen, değiştirebilen veya çalıştırabilen kullanıcılar hem hedef uç noktayı (uri) hem de beceri tarafından kullanılan kimlik doğrulama yapılandırmasını denetler. Beceri, Döküm Araçları hedef kitlesi için bu uç noktaya bir yönetilen kimlik belirteci gönderdiğinden, bu izinleri güvenilen yöneticilerle kısıtlayın ve yönetilen kimlik özellikli becerileri yapılandırırken standart değişiklik yönetimi ve güvenlik gözden geçirme işlemlerinizi izleyin.

Ayrıca bakınız

• Azure Yapay Zeka Arama yerleşik endeks cihazları
• Tümleşik vektörleştirme
• Bir beceri seti nasıl tanımlanır?
• Azure AI model çıkarımı (Foundry)
• OpenAI