Skills de IA e MCP: equipando o assistente
Por Equipe BotConversa · Atualizado em 8 de setembro de 2026
Skill e aplicativo resolvem problemas diferentes, e confundir os dois é o começo errado. A regra é simples: Skill ensina o assistente a falar sobre algo; aplicativo dá a ele permissão para fazer algo.
| Skill de IA | Aplicativo de IA (MCP) | |
|---|---|---|
| O que é | Um conjunto de instruções guardado | Uma conexão com ferramentas |
| O que dá ao assistente | Conhecimento e método para uma tarefa | Poder de executar ações |
| Exemplo | Como conduzir uma triagem de suporte | Abrir o atendimento de verdade, na sua conta |
Os dois se completam. A skill diz como fazer a triagem; o aplicativo permite abrir o chamado no fim dela.
Onde fica tudo isso?
No menu lateral, vá em Configurações → Integrações. A página tem três abas:
| Aba | O que tem nela |
|---|---|
| Externo | As chaves de API e integrações de credencial da conta |
| Aplicativos de IA | As ferramentas que o assistente pode usar |
| Skills de IA | As habilidades que o assistente pode acionar |
Como crio uma Skill?
- Em Configurações → Integrações, abra a aba Skills de IA.
- Clique em + Criar.
- Preencha o Nome — é como você vai encontrar a skill na lista.
- Escreva a Descrição: para que a skill serve e quando deve ser usada.
- Escreva o Prompt: as instruções propriamente ditas — tarefa, tom e o que mais importar.
- Clique em Criar.
São três campos, mas eles têm pesos muito diferentes. O próximo tópico é o que separa uma skill que funciona de uma que nunca é acionada.
Como o assistente escolhe a Skill certa?
Pela Descrição. É ela que o assistente lê para decidir se aquela habilidade serve para o que o cliente acabou de dizer.
Esse é o ponto que mais gera frustração: a pessoa escreve um prompt excelente, deixa a descrição vaga, e a skill nunca é acionada. O assistente não adivinha o conteúdo do prompt — ele decide pela descrição.
Descrição fraca: "Skill de suporte." Não diz quando usar nem para quê. O assistente não tem como saber se ela serve para uma dúvida de cobrança ou para um produto com defeito.
Descrição boa: "Usar quando o cliente relatar um problema técnico, defeito ou algo que parou de funcionar. Conduz a triagem, coleta os dados do chamado e decide se escala para um atendente." Diz o gatilho e o resultado.
Ao escrever, responda duas coisas em uma frase ou duas: em que situação isso deve entrar e o que a skill faz. Cite as palavras que o cliente usaria de verdade — "não consigo entrar", "veio quebrado", "quero cancelar" — e não os termos internos da sua empresa.
O que escrever no Prompt?
O Prompt é o que o assistente segue depois de decidir usar a skill. Vale tratá-lo como o roteiro de um bom atendente:
- A tarefa — o que precisa ser feito, do começo ao fim.
- A ordem — o que perguntar primeiro, o que só perguntar depois.
- Os dados a coletar — e em quais campos eles devem ser gravados.
- O tom — formal, próximo, direto.
- Os limites — o que não prometer, quando parar e passar para um humano.
Escreva apenas o que se aplica àquela situação. O que vale para toda conversa — o nome da empresa, o tom geral, o horário de atendimento — continua nas instruções do assistente, não na skill. Veja Como configurar o Assistente de IA: as 7 partes.
Como sei se a Skill está sendo usada?
Cada skill mostra na lista quantas vezes foi chamada. É a métrica mais útil da tela, e vale olhar depois da primeira semana.
Uma skill parada em zero chamadas quase sempre tem um problema de descrição, não de prompt: o assistente não está entendendo quando ela serve. Reescreva a descrição com as palavras do cliente e observe de novo.
O contrário também informa: uma skill acionada em quase toda conversa provavelmente está com a descrição ampla demais e está sendo puxada para assuntos que não são dela.
O que são os Aplicativos de IA?
São as ferramentas que o assistente pode operar. É o suporte a MCP na prática — o padrão que permite a uma IA usar ferramentas externas em vez de só conversar.
Na aba Aplicativos de IA fica o Ferramentas BotConversa, que dá ao assistente acesso às ações internas da plataforma. Quando ele aparece como Conectado, o assistente já pode executar — dentro do que você autorizar no próximo tópico.
Na prática, é a diferença entre o assistente dizer "vou registrar seu interesse" e ele realmente aplicar a etiqueta enquanto conversa. Antes, cada ação dessas exigia um bloco no fluxo, depois que a IA terminasse. Agora ela acontece durante a conversa, conforme o que o cliente diz.
Como controlo o que o assistente pode fazer?
No card do aplicativo, clique em Gerenciar acesso. Abre a janela Acesso às Ferramentas BotConversa, com uma lista de permissões para marcar e desmarcar, uma a uma:
| Permissão | O que o assistente passa a poder fazer |
|---|---|
| Etiquetas | Aplicar e remover etiquetas do contato |
| Campanhas | Trabalhar com as campanhas da conta |
| Campos Personalizados | Gravar e consultar os campos que você criou |
| Campos do Sistema | Gravar e consultar os campos nativos do contato |
| Kanban | Mover o contato entre as etapas do quadro |
| Atribuições + abertura de casos | Abrir um atendimento e direcioná-lo a alguém da equipe |
| Fluxos em execução | Interferir nos fluxos que o contato está percorrendo |
| Eventos do Integrador | Disparar eventos que acionam suas automações no Integrador |
Marque, desmarque e clique em Salvar. Se alguma permissão aparecer esmaecida, ela não está disponível para a sua conta no momento.
Quais ferramentas cada permissão libera?
Cada permissão de Gerenciar acesso liga um grupo de ferramentas com nome técnico. O assistente só enxerga as dos grupos marcados; as de Sistema ficam sempre disponíveis. Você não precisa decorar os nomes — mas citá-los nas instruções tira ambiguidade, e é assim que o guia no fim desta página os usa.
| Permissão | Ferramentas | O que o assistente consegue fazer |
|---|---|---|
| Etiquetas | list_tags, get_subscriber_tags, add_tag, remove_tag | Ver as etiquetas da conta e as do contato; aplicar e remover |
| Campanhas | list_campaigns, get_subscriber_campaigns, add_campaign, remove_campaign | Ver campanhas; inscrever ou retirar o contato de uma campanha — não exclui a campanha |
| Fluxos em execução | list_flows, send_flow, schedule_flow_run | Ver fluxos; disparar um fluxo agora ou agendar para depois. Não cria nem edita fluxo |
| Atribuições + abertura de casos | list_users, list_groups, assign_subscriber, open_case, pause_automation | Ver equipe e departamentos; atribuir a conversa; abrir o atendimento humano; parar o robô para o contato |
| Campos Personalizados | list_variable_types, list_bot_variables, get_subscriber_variables, set_subscriber_variable, remove_subscriber_variable | Ler e gravar campos do contato; ver os tipos de campo e os campos do robô |
| Campos do Sistema | get_subscriber_system_fields, update_subscriber_system_fields | Ler e atualizar nome, sobrenome, e-mail, CPF e os demais campos nativos |
| Sequências | list_sequences, connect_sequence_to_subscriber, disconnect_sequence_from_subscriber | Ver sequências; inscrever ou retirar o contato. Esta permissão pode aparecer esmaecida na sua conta |
| Kanban | list_kanban_boards, list_kanban_cards, create_kanban_card, update_kanban_card_description, move_kanban_card | Ver quadros e cartões; criar cartão, editar a descrição e mover de coluna |
| Eventos do Integrador | list_albato_events, trigger_albato_event | Ver e disparar eventos que acionam suas automações do Integrador |
| Sistema (sempre disponível) | get_current_datetime, get_business_hours, load_skill | Saber a data e a hora atuais, o horário de atendimento e carregar uma skill |
O nome técnico das ferramentas do Integrador usa a palavra albato; na interface do BotConversa, é o Integrador de sempre.
Como o assistente deve usar as ferramentas
Ter a ferramenta não é saber usá-la. Cinco regras evitam quase todos os problemas, e valem para qualquer categoria:
- Consultar antes de agir. Primeiro a ferramenta de consulta do grupo —
list_tags,list_kanban_cards,get_subscriber_variables—, só depois a ação. É o que evita etiqueta duplicada, cartão repetido e nome inventado. - Confirmar antes do que não volta. Abrir atendimento, parar o robô, remover etiqueta ou campo, tirar de uma sequência, disparar um fluxo ou um evento: perguntar ao cliente e só executar com um "sim".
- Terminar sempre em texto simples. É o padrão do produto: depois de usar ferramentas, o assistente responde ao cliente em texto — sem citar nome técnico, id ou "chamei a ferramenta".
- Data e hora só vêm de
get_current_datetimeeget_business_hours. O assistente nunca deve supor que dia é hoje nem se a empresa está aberta. - A skill entra pela Descrição.
load_skillcarrega a skill que a Descrição indica. Se uma skill nunca é chamada, o problema está na Descrição — como explicado em "Como o assistente escolhe a Skill certa?".
Por onde começar?
- Escolha uma tarefa repetitiva que hoje mora no meio do seu prompt principal — a mais comum e mais chata.
- Transforme em skill, caprichando na descrição.
- Ligue só Etiquetas e Campos Personalizados no Ferramentas BotConversa.
- Teste com um contato de teste, passando pelo caminho da skill: Testando um fluxo antes de ativar.
- Volte em uma semana e olhe o contador de chamadas antes de criar a segunda skill.