Aula 02 · Fundamentos
O copiloto no Claude e no ChatGPT
Você usa o conector para ler a conta, achar o comando certo e gravar só depois de ver a prévia.
- 20 a 25 minutos
- Exercício no conector
- Claude ou ChatGPT
- Módulo Fundamentos
Gravação em breve
O vídeo desta aula entra aqui assim que a gravação da Formação for editada. O conteúdo abaixo já cobre a aula inteira: resumo, pontos-chave e um exercício para fazer hoje, na conta da sua agência.
Resumo
Nesta aula
O conector liga o Claude ou o ChatGPT à conta da Interage. Ele deixa poucos comandos à mão e guarda o resto num catálogo: você descreve o que quer fazer e o buscar devolve o nome do comando, os argumentos, se ele pede confirmação e qual executor usa.
São três executores. O executar_leitura só lê. O executar_escrita cria ou altera. O executar_exclusao apaga. Comece sempre pela leitura. Se a conexão enxerga mais de uma empresa, academia_list_companies mostra quais são, e cada chamada leva o companyId da empresa certa: você diz o nome, o copiloto passa o ID.
O quick_start_get mostra o progresso e separa as tarefas essenciais, sem as quais o agente atende errado, das recomendadas, em que o agente funciona mas o cliente perde resultado. O implementacao_guia_get dá a ordem: descoberta, plano, execução, testes no Go Live e ligar o atendimento.
Escrita em dois passos
O copiloto mostra antes de gravar.
Na escrita, são dois passos. Com confirm:false, o comando devolve a prévia e um token, sem gravar nada. Você revisa. Com confirm:true e o mesmo token, grava.
O token vale 15 minutos a partir da prévia e é assinado sobre o conteúdo exato: mudou um campo, peça prévia nova.
Alguns comandos agem na primeira chamada, sem prévia. A descrição deles diz "escrita direta, sem confirmação", e o golive_clear apaga a conversa de teste sem volta. Revise antes de pedir.
Pontos-chave
O que muda no seu jeito de implantar.
Leia antes de escrever
Escopo com academia_list_companies, o que falta com quick_start_get, a ordem com o guia. Todo identificador sai de uma leitura feita agora: kb_list devolve o itemId que o kb_upsert usa. ID lembrado de outra conversa não vale.
Prévia antes de gravar
confirm:false devolve a prévia e o token, sem gravar. confirm:true com o mesmo token aplica. O token vale 15 minutos e cai se um campo mudar. Comando sem prévia age na primeira chamada: revise antes de pedir.
Não decore comandos
Descreva o pedido em português e deixe o buscar achar. O executor mostra o risco: leitura não muda nada, escrita cria ou altera, exclusão apaga. Se um comando não aparece, falta permissão ao seu usuário ou o recurso não foi liberado para a empresa.
Exercício
Leia a sua conta antes de mudar nada.
Na conta da sua agência, criada na aula 1. Nunca em conta de cliente. Os pedidos 1 a 4 só leem; o 5 monta uma prévia e para nela.
- 1. Cole: "Liste as empresas que a minha conexão Interage enxerga." Confira a sua agência na lista.
- 2. Cole: "Leia o Início rápido da [sua agência]. Mostre o progresso, as tarefas essenciais pendentes e as recomendadas pendentes." Anote as essenciais.
- 3. Cole: "Abra o guia de implementação da Interage sem seção. Me diga a ordem da implementação e liste as seções."
- 4. Cole: "Procure no catálogo do conector o comando que cria um item na base de conhecimento. Mostre o executor e os argumentos. Não execute nada."
- 5. Cole: "Monte a prévia de um item da base com o título Horário de atendimento da agência e o meu horário real. Use confirm:false. Não confirme."
Cinco pedidos para colar no copiloto
Se aparecer mais de uma empresa no pedido 1, escolha pelo nome e repita esse nome em todo pedido daqui em diante: o copiloto passa o companyId em cada chamada, e você não digita ID. No pedido 4, a resposta esperada é kb_upsert, executor executar_escrita, com confirmação, argumentos title e content. No pedido 5, você vê a prévia e um confirmation_token, e nada foi gravado. Deu certo quando você tem anotadas as essenciais pendentes, a ordem do guia e o nome do comando da base de conhecimento, e viu uma prévia sem gravar nada.
- Buscar e os três executores
- Prévia, token de 15 minutos e escrita direta
- Ler na hora, guardar cópia, prévia, ler de volta
- O ciclo em 7 passos: Início rápido, guia, docs, ler, prévia, ler de volta, Início rápido
Guia de Fundamentos do conector
O material de apoio desta aula, o Guia de Fundamentos do conector, está sendo finalizado e entra aqui em breve. Enquanto isso, a aba Na docs traz os artigos da central que sustentam esta aula.
- Prévia e confirmação: https://docs.interage.ai/mcp/previa-e-confirmacao
- Início rápido: https://docs.interage.ai/comecando/inicio-rapido
- Ler antes de escrever: https://docs.interage.ai/mcp/ler-antes-de-escrever
Prévia e confirmação
O artigo principal desta aula está em https://docs.interage.ai/mcp/previa-e-confirmacao. A central é a fonte de como o produto funciona: quando o copiloto tiver dúvida, peça que ele leia o artigo antes de responder.
Trilha Implementador
Todas as aulas num lugar só.
Veja as oito aulas da trilha, módulo por módulo. A Lisa manda o link de cada aula no seu WhatsApp.
Pratique os dois passos na conta da sua agência.
A conta começa já num plano, com garantia de 14 dias na primeira contratação. Se a sua agência quer implantar em clientes com apoio da Interage, o caminho é o Programa Parceiro Agência.