Aracılığıyla paylaş

Semantic Kernel istemleri için YAML şema referansı

Anlam Çekirdeği istemleri için YAML şema başvurusu, desteklenen tüm YAML söz dizimini ve bunların kullanılabilir seçeneklerini listeleyen YAML istemleri için ayrıntılı bir başvurudur.

Tanımlar

ad

Bu yapılandırmayı kullanarak istem işlevleri oluştururken varsayılan olarak kullanılacak işlev adı. Ad null veya boşsa, işlev oluşturulurken dinamik olarak rastgele bir ad oluşturulur.

Açıklama

Bu yapılandırmayı kullanarak istem işlevleri oluştururken varsayılan olarak kullanılacak işlev açıklaması.

şablon_formatı

Anlam Çekirdeği şablon biçiminin tanımlayıcısı. Anlam Çekirdeği aşağıdaki şablon biçimleri için destek sağlar:

  1. semantik çekirdek - Yerleşik Anlamsal Çekirdek biçimi.
  2. handlebars - Handlebars şablon biçimi.
  3. sıvı - Liquid şablon biçimi

şablon

İstemi tanımlayan istem şablonu dizesi.

girdi_değişkenleri

İstem şablonu tarafından kullanılan giriş değişkenlerinin koleksiyonu. Her giriş değişkeni aşağıdaki özelliklere sahiptir:

  1. name - Değişkenin adı.
  2. description - Değişkenin açıklaması.
  3. default - Değişken için isteğe bağlı bir varsayılan değerdir.
  4. is_required - Değişkenin gerekli kabul edilip edilmediği (isteğe bağlı değil). Varsayılan değer true.
  5. json_schema - Bu değişkeni açıklayan isteğe bağlı bir JSON Şeması.
  6. allow_dangerously_set_content - Değişken değerinin tehlikeli olabilecek içerik olarak işlenip işlenmeyeceğini gösteren boole değeri. Varsayılan değer false. Daha fazla bilgi için İstem Ekleme Saldırılarına Karşı Koruma bölümüne bakın.

Bahşiş

allow_dangerously_set_content için varsayılan değer false'tur. True olarak ayarlandığında, giriş değişkeninin değeri güvenli içerik olarak değerlendirilir. Sohbet tamamlama hizmetinde kullanılan istemler için, bu istem ekleme saldırılarına karşı korumak amacıyla false değeri verilmelidir. MetinTo-Image gibi diğer yapay zeka hizmetlerini kullanırken bu, daha karmaşık istemlere izin vermek için true olarak ayarlanabilir.

çıktı_değişkeni

komut istemi şablonu tarafından kullanılan çıkış değişkeni. Çıkış değişkeni aşağıdaki özelliklere sahiptir:

  1. description - Değişkenin açıklaması.
  2. json_schema - Bu değişkeni açıklayan JSON Şeması.

çalıştırma_ayarları

komut istemi şablonu tarafından kullanılan yürütme ayarlarının koleksiyonu. Yürütme ayarları, hizmet kimliği ile anahtarlanmış bir sözlük ya da varsayılan yürütme ayarları için default’dır. PromptExecutionSettings her hizmet kimliği sözlükteki anahtarla eşleşmelidir.

Her girdi aşağıdaki özelliklere sahiptir:

  1. service_id : Bu ayarlar, azure_openai_eastus, openai, ollama, huggingface vb. için yapılandırılan hizmeti tanımlar.
  2. model_id - Bu, bu ayarların gpt-4, gpt-3.5-turbo gibi ayarlar için yapılandırıldığı yapay zeka modelini tanımlar.
  3. function_choice_behavior - İşlevlerin LLM tarafından seçilme şeklini ve yapay zeka bağlayıcıları tarafından nasıl çağrıldıklarını tanımlayan davranış. Daha fazla bilgi için bkz. İşlev Seçimi Davranışları

İpucu

Sağlanırsa, hizmet tanımlayıcısı bir sözlük yürütme ayarları koleksiyonundaki anahtar olacaktır. Sağlanmadıysa hizmet tanımlayıcısı defaultolarak ayarlanır.

İşlev Seçimi Davranışı

İşlev çağrısını devre dışı bırakmak ve modelin yalnızca kullanıcıya yönelik bir ileti oluşturmasını sağlamak için özelliğini null (varsayılan) olarak ayarlayın.

  • auto - Modelin, işlevlerin çağrılıp çağrılmayacağına ve çağrılırsa hangilerinin çağrılacağına karar vermesine izin vermek için.
  • required - Modeli her zaman bir veya daha fazla işlevi çağırmaya zorlamak için.
  • none - Modele herhangi bir işlevi çağırmamasını ve yalnızca kullanıcıya yönelik bir ileti oluşturmasını bildirmek için.

tehlikeli_içeriği_ayarlamaya_izin_ver

İşlevlerden istemde tehlikeli olabilecek içeriğin eklenmesine izin verilip verilmeyeceğini gösteren boole değeri. Varsayılan değer false'tur. True olarak ayarlandığında, yalnızca işlevlerden döndürülen değerler güvenli içerik olarak değerlendirilir. Sohbet tamamlama hizmetiyle kullanılan istemler için, istem ekleme saldırılarına karşı korunmak amacıyla bu ayar "yanlış" olarak belirlenmelidir. MetinTo-Image gibi diğer yapay zeka hizmetlerini kullanırken bu, daha karmaşık istemlere izin vermek için true olarak ayarlanabilir. Daha fazla bilgi için bkz. İstem Ekleme Saldırılarına Karşı Koruma.

Örnek YAML istemi

Aşağıda, Handlebars şablon biçimini kullanan ve gpt-3 ve gpt-4 modelleriyle kullanıldığında farklı sıcaklıklarla yapılandırılan örnek bir YAML istemi verilmiştir.

name: GenerateStory
template: |
  Tell a story about {{topic}} that is {{length}} sentences long.
template_format: handlebars
description: A function that generates a story about a topic.
input_variables:
  - name: topic
    description: The topic of the story.
    is_required: true
  - name: length
    description: The number of sentences in the story.
    is_required: true
output_variable:
  description: The generated story.
execution_settings:
  service1:  
    model_id: gpt-4
    temperature: 0.6
  service2:
    model_id: gpt-3
    temperature: 0.4
  default:
    temperature: 0.5

Sonraki adımlar

Handlebars İstek ŞablonlarıLiquid İstek Şablonları

  • Last updated on