Skills

Uma competência (skill) reúne, em torno de um assunto, as instruções que o agente deve seguir e as ferramentas que ele pode acionar. Cobrança, Matrícula, Suporte — cada uma é uma competência.

O ganho está em ela ser reutilizável: a mesma competência entra em vários agentes, e ajustar aqui muda o comportamento de todos eles de uma vez. A tela fica em Skills, no menu; se não aparecer para você, peça a quem administra a sua organização.

Criando uma competência

  1. Em Skills, clique em + Nova skill.
  2. Dê um nome (ex.: Cobrança) e descreva o que ela sabe fazer (ex.: Consultar débitos e negociar prazos com o aluno).
  3. Na tela dela, escreva as instruções e acrescente as ferramentas.

Na tela da competência você tem:

  • Nome e Resumo — uma linha sobre o que ela resolve.
  • Descreva o que esta competência sabe fazer — as instruções. Escreva como quem explica a um colega novo: o que fazer, em que ordem e o que evitar. Ex.: "Ao lidar com cobrança, confirme o CPF antes de consultar o débito. Nunca prometa desconto que não esteja na régua."

No menu de ações do cabeçalho, Pausar tira a competência de uso sem apagá-la; Excluir remove-a dos agentes que a usam e leva junto as ferramentas dela (a tela pede confirmação).

Ferramentas

O painel Ferramentas, embaixo, é o que o agente consegue acionar quando usa esta competência. Use + Adicionar ferramenta; o menu de cada linha traz Editar e Remover, e Abrir o fluxo quando a ferramenta é um fluxo.

Cada ferramenta tem:

  • Tipo — um dos quatro abaixo.
  • Nome — o nome pelo qual o agente a chama, em letras minúsculas e sem espaços (ex.: consultar_debito).
  • Quando usar esta ferramenta — é o campo mais importante da tela. É este texto que o agente lê para decidir se aciona a ferramenta, e quando. Seja específico: "Use para ver o que o aluno deve. Informe o CPF sem pontuação."

Os quatro tipos

Tipo O que faz
Fluxo Executa um fluxo daqui mesmo. Só aparecem na lista os fluxos que aceitam ser ferramenta — os que têm o gatilho Ferramenta de IA (veja Gatilhos). É o tipo mais usado: tudo o que você já monta num fluxo vira habilidade do agente.
Servidor MCP Traz as ferramentas de um servidor MCP. Uma credencial do tipo Servidor MCP (ferramentas de agente) dá acesso a todas as ferramentas que aquele servidor publica. Cadastre-a em Credenciais.
Pensar em voz alta Dá ao agente um rascunho: ele anota o raciocínio antes de agir e relê nas etapas seguintes. Não consulta nem altera nada. Vale a pena em agente com muitas ferramentas, que sem isso encadeia chamadas por reflexo e erra logo na primeira.
Base de conhecimento Busca semântica numa base de documentos. Ainda não está disponível nesta versão — se você cadastrá-la, o agente avisa que não consegue pesquisar e segue por outro caminho, em vez de responder como se a base estivesse vazia.

Se a lista de fluxos vier vazia, abra o fluxo que você quer oferecer e acrescente o gatilho Ferramenta de IA a ele.


Para ligar a competência a um agente, veja a aba Skills em Agentes de IA.