Referenční informace ke schématu YAML pro výzvy k sémantickému jádru

Referenční informace ke schématu YAML pro výzvy sémantického jádra jsou podrobné referenční informace pro výzvy YAML, které uvádějí všechny podporované syntaxe YAML a jejich dostupné možnosti.

Definice

Jméno

Název funkce, který se má použít ve výchozím nastavení při vytváření funkcí výzvy pomocí této konfigurace. Pokud je název null nebo prázdný, náhodný název se při vytváření funkce vygeneruje dynamicky.

popis

Popis funkce, který se má použít ve výchozím nastavení při vytváření funkcí výzvy pomocí této konfigurace.

template_format

Identifikátor formátu šablony sémantického jádra. Sémantické jádro poskytuje podporu pro následující formáty šablon:

1. sémantické jádro – integrovaný sémantický formát jádra.
2. Handlebars – formát šablony Handlebars
3. liquid – formát šablony Liquid

šablona

Řetězec šablony výzvy, který definuje výzvu.

vstupní proměnné

Kolekce vstupních proměnných používaných šablonou podnětu. Každá vstupní proměnná má následující vlastnosti:

1. name – název proměnné.
2. description – popis proměnné.
3. default – volitelná výchozí hodnota proměnné.
4. is_required – určuje, jestli je proměnná považována za povinnou (nikoli nepovinnou). Výchozí hodnota je true.
5. json_schema – volitelné schéma JSON popisující tuto proměnnou.
6. allow_dangerously_set_content – logická hodnota označující, jestli se má proměnná zpracovat jako potenciálně nebezpečný obsah. Výchozí hodnota je false. Viz Ochrana před útoky prostřednictvím injekce výzev pro více informací.

Spropitné

Výchozí hodnota pro allow_dangerously_set_content je false. Při nastavení na hodnotu true je hodnota vstupní proměnné považována za bezpečný obsah. U výzev, které se používají se službou pro dokončování chatu, by měla být možnost nastavena na hodnotu false, aby se zabránilo útokům prostřednictvím injektáže výzev. Pokud používáte jiné služby AI, například text –To-Image, lze nastavit na hodnotu true, což umožní využívat složitější výzvy.

output_variable

Proměnná výstupu, kterou používá šablona podnětu. Výstupní proměnná má následující vlastnosti:

1. description – popis proměnné.
2. json_schema – Schéma JSON popisující tuto proměnnou

nastavení provádění

Kolekce nastavení spuštění používaná šablonou pro pokyny. Nastavení spuštění je slovník, který má klíče podle ID služby nebo default pro výchozí nastavení spuštění. ID služby každého PromptExecutionSettings musí odpovídat klíči ve slovníku.

Každá položka má následující vlastnosti:

1. service_id – Tato funkce identifikuje službu, pro která jsou tato nastavení nakonfigurovaná, například pro azure_openai_eastus, openai, ollama, huggingface atd.
2. model_id – Tato možnost identifikuje model AI, tato nastavení jsou nakonfigurována například pro gpt-4, gpt-3.5-turbo.
3. function_choice_behavior – Chování definující způsob, jakým LLM vybírá funkce a jak jsou tyto funkce vyvolávány prostřednictvím konektorů AI. Další informace naleznete v tématu Výběr funkcí - Chování

Spropitné

Pokud je k dispozici, identifikátor služby může sloužit jako klíč ve slovníkové kolekci nastavení spuštění. Pokud není zadaný identifikátor služby, bude nastaven na default.

Chování výběru funkce

Pokud chcete zakázat volání funkcí a nechat model generovat pouze zprávu zobrazenou uživatelem, nastavte vlastnost na hodnotu null (výchozí).

• auto – Umožnit modelu rozhodnout, zda funkce volat, a pokud ano, které z nich volat.
• required – pokud chcete model vynutit, aby vždy volal jednu nebo více funkcí.
• none – chcete-li dát modelu pokyn, aby nevolal žádné funkce a vygeneroval pouze uživatelskou zprávu.

povolit_nebezpečně_nastavit_obsah

Logická hodnota označující, zda má být potenciálně nebezpečný obsah vložen do výzvy z funkcí. Výchozí hodnota je false. Pokud je nastavena hodnota true, návratové hodnoty z funkcí se považují pouze za bezpečný obsah. U promptů, které se používají se službou dokončování chatu, by mělo být nastaveno na hodnotu false, aby se ochránily před útoky injectingu promptů. Pokud používáte jiné služby AI, např. Text-To-Image, lze nastavit na hodnotu true pro povolení složitějších výzev. Další informace najdete v tématu Ochrana před útoky pomocí vkládání příkazů.

Ukázka výzvy YAML

Níže je ukázka YAML ukázkového textu, která používá formát šablony Handlebars a je nakonfigurována s různými teplotami při použití s modely gpt-3 a gpt-4.

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

Další kroky

Handlebar šablony pro podnětyLiquid šablony pro podněty