Adicionar um nó de classificação a um fluxo de trabalho

Observação

As funcionalidades deste artigo são utilizadas por agentes ou fluxos de trabalho suportados pela estrutura do GitHub Copilot.

A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot. Saiba mais em Gerir custos para agentes alimentados pelo harness GitHub Copilot.

O nó de classificação recebe um bloco de texto e classifica-o numa das categorias que definir. Descreve cada categoria em linguagem simples e o nó usa IA para decidir a que categoria a entrada corresponde melhor. Cada categoria torna-se um ramo próprio, pelo que o fluxo de trabalho pode tomar uma ação diferente dependendo do resultado.

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

Ao utilizar o nó classify, pode:

  • Ordena uma entrada de texto numa das várias categorias que descreves em linguagem natural.
  • Ramifica o fluxo de trabalho para que cada categoria execute um conjunto diferente de passos.
  • Detete tudo o que não corresponda a uma categoria predefinida.
  • Melhore a precisão fornecendo exemplos de entradas para cada categoria.

Adicionar um nó de classificação

  1. No Copilot Studio, vai a Flows e abre um fluxo de trabalho existente, ou cria um novo.

    • Novo fluxo de trabalho: é direcionado para o estruturador para configurar um acionador.
    • Fluxo de trabalho existente: Abra o fluxo de trabalho e vá ao separador Build .
  2. Selecione o ícone Classificar no painel de Adicionar.

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

O nó na tela mostra um ponto de ligação por categoria, mais um ramo Outro (Predefinido). Ligue cada ramo aos passos que devem ser executados para essa categoria.

Forneça a entrada para classificar

No campo Input to classify, introduza o texto que pretende que o nó categorize. Utilize o seletor de conteúdo dinâmico para inserir uma variável de cadeia (de carateres) de um passo anterior, de modo a que o nó classifique dados reais em tempo de execução.

Por exemplo, num fluxo de trabalho que é ativado quando chega um novo email, define a entrada para a variável Corpo a partir do trigger para que cada execução classifique o conteúdo real do email.

O campo de entrada destina-se à introdução de texto livre. Se quiser considerar vários valores em conjunto (por exemplo, o assunto e o corpo do email), use o seletor dinâmico de conteúdo para os combinar no campo.

Escolha o modelo

Utilize o menu pendente do modelo no campo Input to classify e escolha o modelo que alimentará a classificação. Tenha em mente que existe um compromisso entre potência e velocidade nos modelos:

  • Selecione um modelo mais capaz quando as categorias são nuançadas ou fáceis de confundir, ou quando a entrada é longa e necessita de interpretação cuidadosa. Neste 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 corre em grande volume.

Defina as suas categorias

Na secção de Categorias , adicione uma entrada para cada resultado para onde pretende encaminhar. Para cada categoria:

  1. Dê à categoria um nome curto e descritivo. O nome torna-se na etiqueta no ramo que sai do nó, por isso faz com que seja algo que 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. Procura categorias que sejam claramente distintas umas das outras e que juntas cubram os inputs que esperas.

A categoria padrão

Uma categoria padrão é criada automaticamente para entradas que não correspondem claramente a nenhuma categoria que definiste. Aparece como o Outro ramo no nó. Ligue esta categoria a uma contingência adequada para que nada passe despercebido. Por exemplo, encaminha o item para revisão manual, regista-o ou notifica alguém.

Adicione exemplos para melhorar a precisão (opcional)

Em Exemplos, pode fornecer entradas de exemplo e a categoria a que cada um pertence. Exemplos ensinam o nó a processar casos limite e o tipo de linguagem que as suas verdadeiras entradas utilizam.

Para acrescentar um exemplo:

  1. Selecionar Adicionar exemplo.

  2. Em Selecionar categoria, escolha a categoria a que pertence o exemplo.

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

Adiciona exemplos para as categorias que se confundem com mais frequência, especialmente para casos extremos em que a resposta certa não é óbvia só pela descrição. Alguns exemplos bem escolhidos por categoria ambígua costumam fazer mais do que uma longa lista.

Ramifique o fluxo de trabalho com base no resultado

Cada categoria, incluindo Outros, é um ramo de saída separado no nó. Depois de o nó classificar uma entrada, o fluxo de trabalho continua pelo ramo para a categoria correspondente. Adicione os passos que pretende para cada ramo:

  • Envie o artigo para um agente, caixa de correio ou fila diferente, dependendo da sua categoria.
  • Execute uma ação terminal num ramo (por exemplo, eliminar ou arquivar) enquanto encaminha outros para seguimento.
  • Defina uma coluna ou um valor de estado e depois continue para os passos seguintes partilhados.

Apenas o ramo correspondente corre para uma dada entrada, pelo que cada caminho pode ser adaptado exatamente ao que essa categoria precisa.

Cenários de automação

O nó classify funciona melhor como um passo de encaminhamento: o texto livre entra, o nó decide do que se trata, e cada ramo processa esse caso.

Triagem de e-mails

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

  • Problema de produto: um Agente de Triagem de Problemas que regista e prioriza um pedido de suporte.
  • Pergunta de como fazer: um Agente Docs Responder que redige uma resposta a partir da base de conhecimento.
  • Atualização da conta: um Agente de Atualização de Conta que aplica a alteração.
  • Spam: uma ação Eliminar email que remove a mensagem.
  • Outro: uma alternativa que encaminha o e-mail para revisão manual.

Uma caixa de entrada, um fluxo de trabalho, e cada mensagem acaba onde deve, sem que alguém leia e organize cada uma.

Encaminhar pedidos de apoio recebidos

Um fluxo de trabalho é ativado quando um pedido é submetido através de um formulário ou caixa de correio partilhada. O nó de classificação lê o texto do pedido e classifica-o em Billing, Technical ou Sales. Cada ramo atribui o pedido à fila da equipa correspondente e notifica essa equipa, para que os pedidos cheguem às pessoas certas sem uma etapa de triagem intermédia.

Priorizar o feedback

Um fluxo de trabalho desencadeia quando um cliente envia feedback. O nó de classificação classifica o comentário como Bug report, Feature request ou Praise. Os relatórios de erros abrem um item de trabalho, os pedidos de funcionalidades são adicionados a uma lista de tarefas pendentes e os elogios são encaminhados para a equipa de conta. Esta ramificação transforma um único canal de feedback em três seguimentos personalizados.

Perguntas frequentes

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

Utilize o nó de classificação quando a única tarefa for classificar o texto numa categoria de um conjunto conhecido e criar ramificações com base no resultado. O nó classify foi concebido especificamente para a tarefa, é mais simples de configurar e fácil de ler na tela.

Utilize um nó de agente quando a etapa precisar de fazer mais do que categorizar: raciocinar com base em múltiplas entradas, chamar ferramentas, recorrer à base de conhecimento ou devolver campos estruturados. Um agente pode classificar e agir num único passo, ao custo de mais configuração.

O que acontece se uma entrada não corresponder a nenhuma categoria?

A entrada é encaminhada para a categoria automática Predefinida, apresentada como o ramo Outro. Ligue sempre esse ramo a uma contingência, para que possa processar entradas não correspondentes.

Como posso tornar a classificação mais precisa?

Escreve descrições claras e distintas de categorias que expliquem o que pertence e o que não pertence. Adiciona exemplos para as categorias que ficam confusas. Escolha um modelo mais capaz quando as categorias forem subtis. Categorias distintas com descrições nítidas importam mais do que o número de categorias.