Pular para o conteúdo principal

Listar Competências

Competências são instruções para o seu Agente que são definidas em linguagem natural. Elas permitem que seu agente entenda a intenção do usuário e proponha uma ação adequada com base na conversa.

Para acessar uma lista de competências criadas, você pode clicar em Listar Competências no menu lateral esquerdo, visualizando todas as competências criadas. Você ainda pode cadastrar as habilidades para cada competência, editar a competência ou deleta-la.

Habilidades, Editar e Excluir Competência​

Na caixa de cada competência, podem ser visualizados 3 ícones:

  • Habilidades — Nesse primeiro ícone, é possível visualizar as habilidades cadastradas para essa competência, criar, editar e excluir habilidades.
  • Editar — Com essa funcionalidade, é possível editar as informações relativas à competência em questão. Modifique, ajuste e refina a lógica das competências para garantir que estejam sempre alinhadas com as demandas em evolução do seu projeto.
  • Excluir — Nesse ícone, é possível excluir a competência e suas habilidades vinculadas. Quando uma competência já não é mais necessária, você pode excluí-la, garantindo que apenas as competências mais relevantes e eficazes permaneçam disponíveis para seus agentes.

Criar Habilidades​

Para criar uma habilidade, clique no ícone de "lâmpada" disponível na competência e, em seguida, em "+ Criar Habilidade" no canto superior direito da plataforma.

Toda habilidade tem os seguintes campos em comum:

  • Nome da habilidade — nome usado pelo agente para reconhecer a habilidade durante a conversa.
  • Descrição — explica ao agente do que se trata a habilidade, usada na tomada de decisão sobre qual habilidade aplicar. Você pode usar a função "Magic" para gerar a descrição automaticamente.
  • Tipo — define o comportamento da habilidade. Os tipos disponíveis são: Requisição de API, Chamar agente, Busca em conhecimento, Gerar imagem e Categorizador.

Os campos exibidos no formulário mudam de acordo com o Tipo selecionado.

Tipo 1: Requisição de API​

Use esse tipo para integrar a habilidade a uma API externa. Os campos disponíveis são:

  • Método HTTP — GET, POST, PUT ou DELETE.
  • URL Base — endereço da API a ser chamada.
  • URL Preview — pré-visualização da URL final, atualizada automaticamente conforme os parâmetros são preenchidos.
  • Formatação da Resposta — expressão no formato JMESPath para formatar a resposta recebida da API.

Abaixo desses campos, quatro abas permitem detalhar a requisição:

  • Headers — cabeçalhos HTTP enviados na requisição.
  • Params — parâmetros da requisição, com campos de Chave, Valor, Descrição e indicação se é Obrigatório.
  • Query Params — parâmetros enviados na query string da URL, com Tipo, Field Type, Chave, Valor, Descrição e indicação se é Obrigatório.
  • Body — parâmetros enviados no corpo da requisição, com a mesma estrutura de Query Params.
  • Authorization — tipo de autenticação da requisição: No Auth, Basic Auth ou Bearer Token.
Dica

Campos sensíveis, como senhas, tokens e chaves de API, podem ser marcados como Secret diretamente nas linhas de Header, Body, Query Params e Authorization, garantindo que o valor seja armazenado de forma protegida.

Também é possível importar uma requisição já pronta no formato cURL ou JSON, e a plataforma preenche automaticamente os campos correspondentes do formulário.

Tipo 2: Chamar agente​

Use esse tipo para acionar outro agente especializado a partir dessa habilidade. Selecione o Agente a ser chamado e, se desejar transferir a condução da conversa para ele, marque a opção Handoff.

Tipo 3: Busca em conhecimento​

Use esse tipo para que a habilidade busque informações em uma lista de Conhecimento já cadastrada. Basta selecionar o Conhecimento desejado.

Tipo 4: Gerar imagem​

Use esse tipo para que a habilidade gere uma imagem. Selecione o Modelo de geração de imagem a ser utilizado.

Tipo 5: Categorizador​

Use esse tipo para classificar automaticamente as conversas em categorias. Defina o Nome da habilidade e utilize o botão "+ Adicionar categoria" para cadastrar as categorias que serão atribuídas às conversas. Cada competência possui um único categorizador e novas categorias adicionadas são incorporadas ao já existente, ficando visíveis na conversa, na aba de Curadoria e na exportação das conversas.

Formato legado

Habilidades criadas antes de julho de 2026 continuam disponíveis no formato legado, com edição e visualização baseadas em blocos de instrução em markdown. Consulte Formato Legado de Habilidades para mais detalhes.