Referência de esquema YAML para prompts do Kernel Semântico

A referência do esquema YAML para os prompts do Kernel Semântico é uma referência detalhada dos prompts em YAML, que lista toda a sintaxe YAML suportada e as opções disponíveis.

Definições

name

O nome da função a usar por predefinição ao criar funções de prompt com esta configuração. Se o nome for nulo ou vazio, um nome aleatório será gerado dinamicamente ao criar uma função.

description

A descrição da função a utilizar por defeito ao criar funções de prompt com esta configuração.

template_format

O identificador do formato de modelo do Kernel Semântico. O Kernel Semântico oferece suporte para os seguintes formatos de template:

1. semantic-kernel - Formato Kernel Semântico incorporado.
2. handlebars - Formato de modelo Handlebars.
3. líquido - Formato de molde líquido

modelo

A cadeia de template do prompt que define o prompt.

variáveis_de_entrada

A coleção de variáveis de entrada usada pelo modelo de prompt. Cada variável de entrada tem as seguintes propriedades:

1. name - O nome da variável.
2. description - A descrição da variável.
3. default - Um valor opcional por defeito para a variável.
4. is_required - Se a variável é considerada necessária (em vez de opcional). A predefinição é true.
5. json_schema - Um esquema JSON opcional que descreve esta variável.
6. allow_dangerously_set_content - Um valor booleano que indica se deve ser tratado o valor da variável como conteúdo potencialmente perigoso. A predefinição é false. Consulte Proteção contra Ataques de Injeção Prompt para mais informações.

variável_de_saida

A variável de saída usada pelo modelo de prompt. A variável de saída tem as seguintes propriedades:

1. description - A descrição da variável.
2. json_schema - O Esquema JSON que descreve esta variável.

execution_settings

A coleção de definições de execução usada pelo modelo de prompt. As definições de execução são um dicionário que é codificado pelo ID do serviço, ou default pelas definições de execução padrão. O ID de serviço de cada PromptExecutionSettings deve corresponder à chave no dicionário.

Cada entrada tem as seguintes propriedades:

1. service_id - Isto identifica o serviço para o qual estas definições estão configuradas, por exemplo, azure_openai_eastus, openai, ollama, huggingface, etc.
2. model_id - Isto identifica o modelo de IA para o qual estas definições estão configuradas, por exemplo, gpt-4, gpt-3.5-turbo.
3. function_choice_behavior - O comportamento que define a forma como as funções são escolhidas pelo LLM e como são invocadas pelos conectores de IA. Para mais informações, veja Comportamentos de Escolha de Função

Comportamento de Escolha de Função

Para desativar a chamada de funções, e o modelo gerar apenas uma mensagem voltada para o utilizador, defina a propriedade para null (o padrão).

• auto - Permitir que o modelo decida se deve chamar as funções e, em caso afirmativo, quais deve chamar.
• required - Forçar o modelo a chamar sempre uma ou mais funções.
• none - Instruir o modelo a não chamar nenhuma função e apenas a gerar uma mensagem dirigida ao utilizador.

allow_dangerously_set_content

Um valor booleano que indica se deve permitir a inserção de conteúdo potencialmente perigoso no prompt a partir das funções. O padrão é "false". Quando definido como verdadeiro, os valores de retorno apenas das funções são tratados como conteúdo seguro. Para os prompts usados com um serviço de conclusão de conversação, isto deve ser definido como false para proteger contra ataques de injeção de prompts. Ao utilizar outros serviços de IA, por exemplo, Text-To-Image, esta opção pode ser definida como true para permitir instruções mais complexas. Consulte Proteção contra Ataques de Injeção Prompt para mais informações.

Exemplo de prompt YAML

Abaixo está um exemplo de prompt YAML que utiliza o formato de modelo Handlebars e está configurado com diferentes temperaturas quando utilizado com os modelos gpt-3 e 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

Passos seguintes