Compartilhar via

Use o editor de código para escrever e editar YAML em tópicos

Os Tópicos podem ser escritos e editados no editor de códigos, que oferece suporte ao uso de YAML, que significa "YAML Ain't Markup Language™". O YAML é usado para gravar arquivos de configuração e tende a ser mais fácil de ler do que XML ou JSON. Os arquivos YAML usam a extensão de arquivo .yaml ou .yml. Os arquivos YAML são formatados com espaçamento e recuo para representar estruturas de dados, como cadeias de caracteres, números, boolianos, listas e dicionários.

Para acessar o editor de código de um tópico, selecione o ícone Mais (…) e selecione Abrir editor de código.

Assista a este vídeo para obter uma visão geral de como usar o YAML no editor de código:

Importante

Qualquer criador pode usar o editor de código para explorar a configuração de um tópico. Desenvolvedores e usuários avançados podem optar por criar e editar no editor de código. No entanto, recomendamos ser muito cauteloso ao fazer revisões no editor de código, porque erros de pontuação ou sintaxe podem resultar em mensagens de erro complexas ou interromper a conversa atual. Nossas equipes de suporte técnico não podem ajudar a corrigir erros do editor de código. Portanto, se você é um novato na revisão do YAML, faça uma cópia do tópico antes de fazer qualquer alteração.

Quando usar o editor de códigos

O Copilot Studio nunca requer que você escreva YAML do zero. Em vez disso, o YAML é gerado automaticamente quando você cria objetos na tela de tópico. Você pode revisar a configuração no editor de códigos para entender melhor as configurações ou optar por fazer alterações no YAML. Aqui estão exemplos de casos de uso para o editor de códigos:

  • O editor de códigos exibe a configuração completa de um tópico sem a necessidade de interagir com elementos de diálogo individuais no tópico. É um balcão único para exibir todas as configurações em um tópico.
  • Os criadores podem optar por copiar nós específicos de um tópico e colá-los em outros tópicos, em vez de usar os ícones Copiar e Colar . Pode ser mais fácil do que selecionar vários nós de uma configuração.
  • Os criadores podem optar por atualizar um ID de fluxo do Power Automate no YAML, em vez de aguardar a sincronização com o menu Chamada e Ação.
  • Os criadores podem optar por clonar e revisar os nós de Pergunta ou os nós de Mensagem quando eles são semelhantes. No entanto, nesses casos, é fundamental garantir que todos os IDs e variáveis permaneçam exclusivos. Lembre-se de revisar IDs clonados para transformá-los em IDs exclusivos.
  • Os criadores podem optar por fazer revisões simples, como acrescentar um termo a frases de tópico, no editor de código, já que pode ser mais rápido digitar ou copiar e colar o texto no código YAML.

Noções básicas sobre o YAML no editor de código

A imagem a seguir mostra um exemplo de um bloco comum do YAML.

Captura de tela de um bloco de código YAML de exemplo no editor de códigos.

Veja como esse código se aplica ao tópico correspondente conforme aparece na tela.

  • Linha 1: O tipo de tópico
  • Linhas 2-3: Indicar o início de um tópico de impulsionamento de conversação
  • Linha 7: indica um nó de respostas generativas
  • Linha 9: a variável relevante
  • Linhas 11-12: Detalhes sobre o prompt e instruções especiais
  • Linhas 20-26: Links de fontes de conhecimento
  • Linhas 28-32: Grupo de condições — cada condição tem uma ID exclusiva, juntamente com os detalhes e redirecionamentos da fórmula da condição

Testar YAML no editor de código

Se você quiser testar esse código, execute as seguintes etapas no Copilot Studio:

  1. Criar um agente.

  2. Acesse a página Configurações de seu agente, selecione IA Generativa e escolha Generativa.

  3. Vá para a página Tópicos, selecione Sistema e escolha o tópico Impulsionamento de conversa.

  4. Abrir o editor de códigos.

  5. Substitua o código existente pelo código YAML de amostra a seguir.

     kind: AdaptiveDialog
 beginDialog:
  kind: OnUnknownIntent
  id: main
  priority: -1
  actions:
    - kind: SearchAndSummarizeContent
      id: search-content
      userInput: =System.Activity.Text
      variable: Topic.Answer
      moderationLevel: Medium
      additionalInstructions: Include emojis to make responses more fun.
      publicDataSource:
        sites:
          - "www.chessusa.com/"
          - "www.chess.com/"
          - "www.lichess.org/"

      sharePointSearchDataSource: {}

    - kind: ConditionGroup
      id: has-answer-conditions
      conditions:
        - id: has-answer
          condition: =!IsBlank(Topic.Answer)
          actions:
            - kind: EndDialog
              id: end-topic
              clearTopicQueue: true

  6. Selecione Salvar e feche o editor de código.

  7. Teste o agente no painel Teste fazendo uma pergunta relacionada ao xadrez, como "Como um cavalo se move?"

Conteúdo relacionado