--- title: "Skills de IA e MCP: equipando o assistente" url: https://ajuda.botconversa.com.br/aula/skills-de-ia-e-mcp section: "Criando automações" date_modified: 2026-09-08T13:11:21.987837+00:00 language: pt-BR --- # Skills de IA e MCP: equipando o assistente ## Resposta rápida As duas novidades que mais mudam o assistente da **V2** ficam em **Configurações → Integrações**. Na aba **Skills de IA** você guarda prompts como habilidades que o assistente aciona sozinho quando o assunto aparece. Na aba **Aplicativos de IA** fica o **Ferramentas BotConversa**, que dá ao assistente permissão para executar ações na sua conta — etiquetas, campos, Kanban, abertura de atendimento — e você marca uma a uma o que ele pode fazer. **Tempo de leitura:** ~10 min**Para quem é:** Quem usa o Assistente de IA na V2 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? 1. Em **Configurações → Integrações**, abra a aba **Skills de IA**. 2. Clique em **\+ Criar**. 3. Preencha o **Nome** — é como você vai encontrar a skill na lista. 4. Escreva a **Descrição**: para que a skill serve e quando deve ser usada. 5. Escreva o **Prompt**: as instruções propriamente ditas — tarefa, tom e o que mais importar. 6. 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. **Descrições que se sobrepõem confundem o assistente.** Se duas skills podem ser lidas como servindo para a mesma situação, ele pode escolher a errada. Quando duas descrições ficarem parecidas demais, ou junte as skills, ou deixe explícito na descrição o que cada uma **não** cobre. ## 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](/aula/como-configurar-o-assistente-de-ia). ## 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. **Ligue só o que você vai usar.** Cada permissão marcada é uma ação que o assistente pode executar sozinho, sem passar por você. Comece pelas de menor risco — Etiquetas e Campos Personalizados são ótimas para experimentar, porque são fáceis de revisar e de desfazer. Deixe **Fluxos em execução** para quando você já confiar no comportamento dele. ## 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_datetime` e `get_business_hours`.** O assistente nunca deve supor que dia é hoje nem se a empresa está aberta. - **A skill entra pela Descrição.** `load_skill` carrega 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?". **Guia completo para download.** No fim desta página, em **Arquivos para download**, está o guia com cada ferramenta explicada, seis receitas prontas (qualificar lead, agendar retorno, passar para uma pessoa, registrar no Kanban, coletar dados, cancelamento), um roteiro para uma IA gerar as instruções do seu assistente e um bloco pronto para colar. Ele vem em duas versões: **.txt** para subir no bloco Assistente GPT em **Suba um arquivo** — o bloco aceita TXT, PDF, DOC, XLS, XLSX e CSV, até 5 MB e 6 arquivos — e **.md** para colar no GPT Especialista ou em outra IA. ## Por onde começar? 1. **Escolha uma tarefa repetitiva** que hoje mora no meio do seu prompt principal — a mais comum e mais chata. 2. **Transforme em skill**, caprichando na descrição. 3. **Ligue só Etiquetas e Campos Personalizados** no Ferramentas BotConversa. 4. **Teste com um contato de teste**, passando pelo caminho da skill: [Testando um fluxo antes de ativar](/aula/testando-um-fluxo-antes-de-ativar). 5. **Volte em uma semana** e olhe o contador de chamadas antes de criar a segunda skill. ## Dicas - **Uma skill por assunto, não por cliente.** "Triagem de defeito" é uma skill. "Atendimento da Maria" não é. - **Gaste mais tempo na descrição que no prompt.** Prompt ruim gera resposta ruim; descrição ruim faz a skill nunca ser usada — e isso é pior, porque não aparece. - **Não duplique nas skills o que já está nas instruções gerais.** Instrução repetida em dois lugares vira instrução contraditória na primeira vez que você atualizar só um deles. - **Revise as permissões de tempos em tempos.** O que você ligou para um teste costuma ficar ligado para sempre. - **Cuidado com o número de mensagens.** Skills que conduzem entrevistas longas fazem o assistente falar mais, e cada mensagem é cobrada — veja [Cobrança dentro da janela de 24h](/aula/cobranca-dentro-da-janela-de-24h). ## Perguntas frequentes Preciso estar na V2 para usar Skills e Aplicativos? Sim. Os dois recursos chegaram com a versão 2 do assistente. Se você ainda não atualizou, veja [Assistente de IA V2: o que muda e como atualizar](/aula/assistente-de-ia-v2). Criei uma skill e ela nunca é acionada. O que houve? Quase sempre é a descrição. O assistente decide pela descrição, não pelo prompt. Reescreva dizendo em que situação a skill deve entrar, usando as palavras que o cliente usaria de verdade. Quantas skills posso criar? Crie conforme a necessidade, mas com parcimônia: quanto mais skills com descrições parecidas, maior a chance de o assistente escolher a errada. Poucas e bem delimitadas funcionam melhor que muitas e sobrepostas. Qual a diferença entre uma Skill e o Contexto Geral do assistente? O Contexto Geral é o que ele sabe o tempo todo — informações do negócio, sempre disponíveis. A skill é um procedimento que só entra em cena quando o assunto aparece. O assistente pode executar ações sem eu perceber? Ele executa o que você autorizou em **Gerenciar acesso**, e só isso. Por isso vale marcar apenas as permissões que você realmente quer, e revisá-las de tempos em tempos. Uma permissão aparece esmaecida e não consigo marcar. Ela não está disponível para a sua conta no momento. Se for algo que você precisa, fale com o suporte. As Skills valem para todos os meus assistentes? As skills ficam em Configurações, na conta — não dentro de um fluxo. Vale conferir o comportamento de cada assistente depois de criar a primeira, com um contato de teste. Posso subir o guia de ferramentas como arquivo do assistente? Sim, a versão **.txt**. O bloco Assistente GPT aceita TXT, PDF, DOC, XLS, XLSX e CSV — o .md não entra. Suba junto com o contexto do negócio; ele conta para o limite de 6 arquivos. Preciso escrever o nome técnico das ferramentas nas instruções? Não é obrigatório: o assistente recebe a lista das ferramentas liberadas. Mas citar o nome — `add_tag`, `open_case` — tira ambiguidade sobre o que você espera em cada situação, e o guia para download traz um bloco pronto com eles.