Muitas tools de escrita do MCP pedem um identificador: de uma oportunidade, de um item da base de conhecimento, de um endpoint. Esse identificador nunca deve ser um palpite. Ele vem de uma leitura anterior, ponto final.
Por que o palpite custa caro
Um identificador errado nem sempre trava a chamada com um erro óbvio. Às vezes ele aponta pra outro registro, real, que existe na sua empresa. Se a tool aceitar esse identificador, o que devia mudar num lugar muda em outro. Numa clínica, isso pode ser a edição do horário de outro profissional. Numa revenda, a alteração de uma oportunidade que não tinha nada a ver com o pedido. O jeito de nunca chegar nessa situação é simples: leia antes, sempre.
Onde ler cada identificador
| Para mexer em | Leia antes |
|---|---|
| Oportunidades | crm_list_pipelines (funil e estágio), opportunities_list |
| Base de conhecimento | kb_list devolve o identificador do item, e você passa ele pro kb_upsert pra editar o item certo |
| Integrações e endpoints | integrations_list, endpoints_list |
| Tools do seu agente | tools_list dá o nome exato |
| Testes de Go Live | golive_start devolve o contato que todas as outras golive_* usam |
O padrão por trás da tabela
Repare que a leitura sempre vem de uma tool específica, não de memória de uma conversa anterior. Um identificador que apareceu numa resposta há dez minutos pode já ter mudado, ou nunca ter existido do jeito que você lembra. Peça pro seu assistente reler antes de escrever, mesmo que pareça repetitivo. Sai mais barato reler do que corrigir uma mudança que caiu no registro errado.
Isso vale até quando você já sabe, de cabeça, qual registro quer mudar. Uma associação com centenas de contatos, ou uma revenda com dezenas de oportunidades abertas, tem sempre mais de um item parecido. O nome que você lembra pode se repetir em dois registros diferentes. Só a leitura confirma qual dos dois é o certo.
O próximo cuidado, depois de ler certo
Ler o identificador certo resolve metade do problema. A outra metade é garantir que a mudança que você aprovou é exatamente a que foi gravada. Isso é assunto de prévia e confirmação, o protocolo que toda tool de escrita segue.
Como confirmar
- Antes de aprovar uma escrita, confira se seu assistente citou de onde veio o identificador (o nome da tool de leitura que ele chamou antes).
- Se ele não mencionar isso, pergunte diretamente: "de onde veio esse identificador?" antes de seguir.
- Depois da confirmação, releia o registro afetado (pela tool de leitura correspondente) pra garantir que foi o certo que mudou.
Erros comuns
- Aceitar um identificador de memória de uma conversa anterior. Ele pode já ter mudado, ou nunca ter existido do jeito que você lembra.
- Confiar no nome em vez do identificador. Nomes se repetem entre registros parecidos; só a leitura confirma qual dos dois é o certo.
- Pular a releitura em operações que parecem óbvias. Mesmo quando você "já sabe" qual registro quer mudar, ler antes é sempre mais barato que corrigir depois.
- Deixar seu assistente propor um identificador sem ter lido antes. Pare e peça pra ele reler primeiro, mesmo que pareça repetitivo.