Adicionar um nó de classificação a um fluxo de trabalho (GitHub Copilot)

Note

Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

O nó de classificação pega um pedaço de texto e o classifica em uma das categorias que você define. Você descreve cada categoria em linguagem simples e o nó usa IA para decidir a qual categoria a entrada melhor corresponde. Cada categoria se torna um ramo próprio, então o fluxo de trabalho pode tomar uma ação diferente dependendo do resultado.

Use o nó de classificação sempre que uma etapa precisar encaminhar o trabalho com base no significado de um texto em formato livre — o corpo de um e-mail, o envio de um formulário, uma mensagem de suporte — em vez de se basear em um campo fixo ou em uma correspondência por palavra-chave. Um uso comum é a triagem de e-mails: leia cada mensagem recebida e envie por um caminho diferente dependendo do tema.

Ao usar o nó de classificação, você pode:

  • Organize uma entrada de texto em uma das várias categorias que você descreve em linguagem natural.
  • Desvie o fluxo de trabalho para que cada categoria execute um conjunto diferente de etapas.
  • Capture qualquer coisa que não corresponda a uma categoria Padrão automática.
  • Melhore a precisão fornecendo exemplos de entradas para cada categoria.

Adicionar um nó de classificação

  1. Em Copilot Studio, vá para Flows e abra um fluxo de trabalho existente ou crie um novo.

    • Novo fluxo de trabalho: você acessa o designer para configurar um gatilho.
    • Fluxo de trabalho existente: abra o fluxo de trabalho e vá para a guia Compilar .
  2. Selecione o ícone Classificar no painel Adicionar.

  3. O painel de configuração é aberto para o nó Classify.

O nó na tela mostra um ponto de conexão por categoria, além de uma ramificação Outro (Padrão). Conecte cada ramificação às etapas que devem ser executadas para essa categoria.

Forneça a entrada para classificar

No campo Entrada para classificar, insira o texto que você deseja que o nó categorize. Use o seletor de conteúdo dinâmico para inserir uma variável de texto de uma etapa anterior, para que o nó classifique dados reais em tempo de execução.

Por exemplo, em um fluxo de trabalho que é acionado quando um novo e-mail chega, defina a entrada para a variável Corpo a partir do gatilho, assim cada execução classifique o conteúdo real do e-mail.

A entrada é destinada a texto livre. Se você tem vários valores que quer considerar juntos (por exemplo, assunto e corpo do e-mail), use o seletor dinâmico de conteúdo para combiná-los no campo.

Escolher o modelo

Use o menu suspenso do modelo no campo Input para classificar e escolher o modelo que alimentará a classificação. Lembre-se de que há um equilíbrio entre capacidade e velocidade nos modelos:

  • Selecione um modelo mais capaz quando as categorias são sutis ou fáceis de confundir, ou quando a entrada é longa e precisa de interpretação cuidadosa. Nesse caso, o modelo precisa de mais tempo para ser processado.
  • Selecione um modelo mais rápido quando as categorias são claramente distintas e o fluxo de trabalho roda em alto volume.

Defina suas categorias

Na seção Categorias, adicione uma entrada para cada destino para o qual deseja rotear. Para cada categoria:

  1. Dê à categoria um nome curto e descritivo. O nome vira o rótulo no ramo que sai do nó, então faça algo que você reconheça na tela (por exemplo, Product issue ou Account update).

  2. Na caixa Descrever o que pertence a esta categoria , explique em linguagem simples que tipo de entrada pertence aqui. Descrições claras são o fator mais importante para uma classificação precisa.

Selecione Adicionar categoria para criar mais. Procure categorias que sejam claramente distintas entre si e que, juntas, cubram as entradas que você espera receber.

A categoria padrão

Uma categoria padrão é criada automaticamente para entradas que não correspondem claramente a nenhuma categoria que você definiu. Ele aparece como a ramificação Outros do nó. Associe esta categoria a uma alternativa de contingência adequada para que nada passe despercebido silenciosamente. Por exemplo, encaminhe o item para revisão manual, registre ou avise alguém.

Adicione exemplos para melhorar a precisão (opcional)

Em Exemplos, você pode fornecer entradas de exemplo e a categoria a que cada um pertence. Exemplos ensinam o nó a lidar com casos-limite e com o tipo de linguagem usado nas suas entradas reais.

Para adicionar um exemplo:

  1. Selecionar Adicionar exemplo.

  2. Em Selecionar categoria, escolha a categoria à qual o exemplo pertence.

  3. Na caixa de texto, cole ou digite uma entrada representativa para essa categoria.

Adicione exemplos para as categorias que mais se confundem, especialmente para casos extremos onde a resposta certa não é óbvia só pela descrição. Alguns exemplos bem escolhidos por categoria ambígua geralmente fazem mais do que uma longa lista.

Ramifique o fluxo de trabalho com base no resultado

Cada categoria, incluindo Outros, é uma ramificação de saída separada no nó. Após o nó classificar uma entrada, o fluxo de trabalho continua descendo pelo ramo para a categoria correspondente. Adicione os passos que você deseja para cada ramo:

  • Envie o item para outro agente, caixa de correio ou fila, dependendo da categoria.
  • Execute uma ação final em uma ramificação (por exemplo, excluir ou arquivar) enquanto encaminha as outras para acompanhamento posterior.
  • Defina uma coluna ou um valor de status e depois continue para etapas posteriores compartilhadas.

Apenas o ramo correspondente é executado para uma determinada entrada, então cada caminho pode ser personalizado exatamente para o que essa categoria precisa.

Cenários de automação

O nó de classificação funciona melhor como uma etapa de roteamento: um texto em formato livre entra, o nó decide do que se trata, e cada ramificação lida com esse caso.

Triagem de Email

Um fluxo de trabalho é ativado quando um novo e-mail chega. O nó Classificar usa o Corpo do e-mail como entrada e o classifica como Product issue, How-to question, Account update, Spam ou Outro. Cada ramificação encaminha a mensagem para o lugar certo:

  • Problema de produto: um Agente Triador de Questões que arquiva e prioriza um chamado.
  • Pergunta do tipo "como fazer": um Agente de Respostas da Documentação que elabora uma resposta com base na base de conhecimento.
  • Atualização da conta: um Agente de Atualização de Conta que aplica a alteração.
  • Spam: a ação Excluir e-mail que remove a mensagem.
  • Outro: um plano B que encaminha o e-mail para revisão manual.

Uma caixa de entrada, um fluxo de trabalho, e cada mensagem acaba onde deveria, sem que uma pessoa leia e organize cada uma.

Rotear solicitações de suporte recebidas

Um fluxo de trabalho é ativado quando uma solicitação é enviada por meio de um formulário ou caixa de correio compartilhada. O nó Classificar lê o texto da solicitação e o classifica em Billing, Technical ou Sales. Cada branch atribui a solicitação à fila da equipe correspondente e notifica essa equipe, para que as solicitações cheguem às pessoas certas sem uma etapa de triagem no meio.

Dê prioridade ao feedback

Um fluxo de trabalho é ativado quando um cliente envia feedback. O nó de classificação classifica o comentário em Bug report, Feature request ou Praise. Relatos de bugs abrem um item de trabalho, solicitações de funcionalidades são adicionadas a uma lista de pendências, e elogios são encaminhados para a equipe de atendimento da conta. Esse ramificamento transforma um único canal de feedback em três continuações personalizadas.

Perguntas frequentes

Quando devo usar o nó de classificação em vez de um nó agente?

Use o nó de classificação quando a única tarefa for classificar o texto em uma categoria de um conjunto conhecido e seguir ramificações com base no resultado. O nó de classificação é feito especialmente para o trabalho, mais simples de configurar e fácil de ler na tela.

Use um nó de agente quando a etapa precisar fazer mais do que categorizar: raciocinar com base em várias entradas, chamar ferramentas, recorrer ao conhecimento ou retornar campos estruturados. Um agente pode classificar e agir em uma única etapa, ao custo de mais configuração.

O que acontece se uma entrada não se encaixar em nenhuma categoria?

A entrada vai para a categoria automática Padrão, exibida como o ramo Outro. Sempre ligue esse ramo a um plano B para lidar com entradas não combinadas.

Como faço para tornar a classificação mais precisa?

Escreva descrições claras e distintas de categorias que expliquem o que pertence e o que não pertence. Adicione exemplos para as categorias que ficam confusas. Escolha um modelo mais capaz quando as categorias são sutis. Categorias distintas com descrições claras importam mais do que o número de categorias.