A maioria das tools de escrita do MCP muda algo dentro da Academia: um registro, um campo, um dado. Cinco tools vão além disso. Elas produzem um efeito fora da Academia, ou um efeito que não dá pra desfazer. Vale conhecer as cinco antes de usar qualquer uma delas.
Duas delas, kb_upsert e contact_bot_pause, seguem o protocolo de
prévia e confirmação: você vê o que vai
acontecer antes de confirmar. Mas a prévia não muda a natureza do efeito
depois que ele acontece.
As outras três, endpoint_execute, golive_send_template e
golive_clear, não têm prévia nenhuma: executam direto, na primeira
chamada. São justamente as que produzem efeito fora da Academia ou
irreversível, e são as que exigem mais cuidado antes do pedido, porque não
existe um passo de revisão depois dele.
endpoint_execute
Dispara uma chamada real no provedor configurado naquele endpoint. Se o endpoint for de leitura, você recebe um dado de fora. Se for de escrita, a chamada grava algo do outro lado, num sistema que não é da Interage.
golive_send_template
Envia uma mensagem de WhatsApp de verdade, pelo número real da sua empresa. A diferença é o destino: ela vai sempre pro contato de teste do Go Live, nunca pra um cliente real. Ainda assim, é uma mensagem de verdade saindo pelo seu WhatsApp, não uma simulação.
golive_clear
Apaga o histórico de teste do Go Live. Não tem volta. Se você precisa comparar uma conversa de teste anterior com uma nova, salve o que interessa antes de limpar.
kb_upsert
Grava conteúdo na sua base de conhecimento, seja um item novo ou uma edição de um item que já existe. O conteúdo persiste, e a tool reconstrói os trechos indexados daquele item, o que seu agente usa pra responder com base nele. Uma edição aqui muda o que seu agente sabe a partir dali.
contact_bot_pause
Pausa o bot pra aquele contato por tempo indeterminado. Não existe um
prazo automático que reativa sozinho. A única forma de voltar é chamar
contact_bot_reactivate depois.
O fio comum entre as cinco
Todas essas tools têm em comum o mesmo tipo de risco: o efeito sai da
Academia, ou fica permanente dentro dela. Em kb_upsert e
contact_bot_pause, a prévia do protocolo de dois passos mostra exatamente
o que vai acontecer antes de confirmar; use esse momento pra ler com
atenção. Em endpoint_execute, golive_send_template e golive_clear,
esse momento não existe: a atenção redobrada precisa vir antes do pedido.
Como confirmar
- Em
kb_upsertecontact_bot_pause, releia a prévia com atenção redobrada antes de confirmar: o efeito, aqui, não é só um campo dentro da Academia. - Em
endpoint_execute,golive_send_templateegolive_clear, confira tudo antes de pedir: não vem prévia, e o pedido já executa. - Depois de
endpoint_execute, confira do lado do sistema externo (quando possível) se o resultado bateu com o esperado. - Depois de
contact_bot_pause, anote em algum lugar pra lembrar de chamarcontact_bot_reactivatequando o motivo pontual passar.
Erros comuns
- Pedir
endpoint_executesem saber o que aquele endpoint faz. Não vem prévia: o pedido já dispara. Principalmente se ele foi configurado por outra pessoa da sua equipe. - Esperar uma prévia em
endpoint_execute,golive_send_templateougolive_clear. Essas três executam direto, na primeira chamada. Quem revisa é você, antes de pedir. - Chamar
golive_clearsem salvar o que interessava antes. O histórico de teste apagado não volta, e não há confirmação no meio do caminho. - Pausar um contato e esquecer de reativar. Não existe prazo automático
que reativa sozinho: só
contact_bot_reactivatedesfaz isso. - Tratar a prévia de
kb_upsertecontact_bot_pausecomo a de qualquer outra tool. A prévia mostra o que vai acontecer, mas não muda a natureza do efeito depois que ele acontece: fora da Academia, ou permanente dentro dela.