Pular para o conteúdo principal

Listar Competências

Uma competência reúne as habilidades que o agente pode executar. Cada habilidade é uma requisição a uma API externa, que permite ao agente consultar ou enviar informações a outros sistemas durante a conversa.

Acessando​

No menu lateral esquerdo, em Recursos, acesse a página Competências & MCPs. Nela você vê todas as competências criadas, em cartões.

Use os filtros do topo para localizar uma competência: Pesquisa, Data inicial e Data final. O botão de atualizar recarrega a lista e o de limpar remove os filtros. As abas Todos e Meus favoritos alternam entre todas as competências e as que você marcou com a estrela.

No canto superior direito, estão os botões Criar servidor MCP (veja Criando Ferramentas MCP) e Criar competência (veja Criar Competência).

O cartão da competência​

Cada cartão mostra o nome, a identificação Competência, o ID (com botão para copiá-lo), a descrição e a data de criação. Na caixa de cada competência, ficam 3 ícones:

  • Habilidades — Nesse primeiro ícone (lâmpada), é 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 refine 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".

Os campos principais são:

  • Nome da habilidade (obrigatório) — nome usado pelo agente para reconhecer a habilidade durante a conversa.
  • Descrição (obrigatório) — 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.
  • Método HTTP (obrigatório) — 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. Veja um exemplo em Filtragem de retorno de API.

Abaixo desses campos, 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.