# Agentic Pro — roteiro técnico completo e fala integral

Edição integral da ementa, sem duração obrigatória. 23 aulas e 138 blocos. Todas as falas abaixo são as versões Sonnet aceitas; visuais por Opus. Demonstrações e pendências explicitadas por aula.


# 1.1 — Como funciona a formação e o que você vai ter no final / m01-a01

**Objetivo:** Reconhecer o percurso completo, localizar materiais e iniciar um projeto próprio verificável.

**Preparação:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Ensaio:** Captura dos canais da turma e URL específica de suporte ainda não fornecidas; não inventar o caminho da plataforma.

### m01-a01-b01 — O resultado que orienta o curso

Slide m01-a01-s01

Bem-vindo à formação Agentic Pro, da Escola de Automação e IA. O objetivo é que, ao final, você olhe para uma tarefa do seu trabalho e saiba transformá-la em um processo com IA. Aqui, processo quer dizer uma sequência com três partes: uma entrada, que é o que chega; etapas, que a IA executa; e uma saída, que é algo que você consegue conferir.

Para tornar isso concreto, imagine esta situação. Uma reunião com um cliente termina. A IA organiza o que o cliente pediu, prepara uma proposta e salva o documento no lugar combinado, aguardando a sua aprovação. Isso é uma ilustração do ponto de chegada, e não um resultado que já esteja pronto. Vamos construir e testar cada parte ao longo das aulas.

Repare no que continua com você. Você segue responsável por confirmar o escopo, ou seja, o que foi de fato combinado com o cliente, e por aprovar a entrega. O que muda é que você deixa de conduzir cada passagem, copiando e colando informações de um lugar para outro.

A ordem do caminho é esta. Primeiro, você conhece o ambiente em que o trabalho acontece. Depois, aprende a ensinar um procedimento para a IA, a conectar ferramentas e a coordenar as etapas. Nesta primeira aula, eu mostro o percurso completo, explico como vamos trabalhar e peço que você escolha um processo seu para acompanhar o curso inteiro.

### m01-a01-b04 — Quem conduz e quem decide

Slide m01-a01-s04

Eu sou o Leo Marques, fundador e CTO, e vou conduzir você nesta formação. Minha preocupação é transformar uma ideia de automação em um trabalho que dá para acompanhar e conferir. Por isso, o seu papel não é decorar comandos nem acreditar em uma resposta só porque ela parece bem escrita. É definir o que precisa acontecer e reconhecer uma boa entrega.

Se você é empresário, vai começar pelas tarefas que já conhece: uma reunião, uma proposta, uma consulta, uma rotina. Se trabalha como gestor de IA, vai olhar também para o que precisa perguntar a quem conhece o processo. Nos dois casos, você não precisa ter todas as respostas técnicas para começar. Precisa saber qual problema estamos resolvendo, quem recebe o resultado e o que pode dar errado.

Vamos usar uma empresa fictícia, o Ateliê Horizonte. Ela precisa organizar pedidos em uma planilha. Ao final de uma reunião, alguém precisa entender o pedido, montar a proposta com a tabela de preços da empresa e deixar o documento disponível para aprovação.

Agora vou abrir o arquivo mapa-processo.md e os arquivos do caso. Um mapa de processo é uma folha simples que descreve o caminho: o que entra, o que acontece, o que sai e quem confere. Vou apontar uma entrega de cada vez, porque cada uma pode ser conferida separadamente. A primeira é o entendimento: o resumo do que o cliente pediu. A segunda é a proposta: o documento montado com a tabela de preços. A terceira é o documento salvo, aguardando aprovação. Estou mostrando o desenho do caso, não um resultado já executado.

Observe também quem aprova. É a pessoa responsável pela empresa, que no seu caso é você. Separar as três entregas é o que torna o trabalho testável: se algo sair errado, sabemos em qual delas o erro apareceu.

### m01-a01-b02 — Como percorrer as aulas

Slide m01-a01-s02

Cada aula tem três momentos: uma explicação curta, uma demonstração e a conferência do resultado. Quando chegar a hora de você fazer, pause o vídeo. O tempo da sua prática é seu, e pode ser maior do que o da aula.

Vou abrir agora a ementa, que organiza o curso por módulos, e mostrar onde ficam os arquivos de exemplo desta aula: projeto-final.md, mapa-processo.md e como-pedir-ajuda.md. Vamos usá-los em breve.

Vamos começar pelo Claude e, depois, levar um caso para o Codex, que é o ambiente de trabalho da OpenAI. Assim, você vê o que muda de uma ferramenta para outra e o que permanece no processo. Você pode começar sem conhecer todas as telas.

Os exemplos de cliente, preços e pedidos são fictícios. Eles permitem que você repita a sequência sem mexer nos dados do seu negócio. Quando o percurso estiver claro, você adapta a entrada, as regras e a saída para o seu trabalho.

Se alguma tela estiver diferente da que aparece aqui, procure a função que estamos usando. Os produtos mudam com frequência. Um exemplo: no Claude, a conversa e o Cowork, que é o modo de executar tarefas com várias etapas, estão sendo unificados. Se você não vir um seletor chamado Cowork, peça a tarefa diretamente na conversa. Alguns recursos também dependem do seu plano. O que vale guardar é o que precisa acontecer e como verificar. O nome do botão pode mudar.

### m01-a01-b05 — O mapa até o seu próprio processo

Slide m01-a01-s05

Vamos percorrer os seis módulos na ordem em que você vai usá-los.

No primeiro módulo, você prepara o ambiente e aprende a controlar três coisas: acesso, contexto e consumo. Acesso é o que a IA pode abrir e alterar no seu computador; você vai dar autorização na medida do efeito de cada ação. Contexto é a informação que a IA tem à vista durante o trabalho, e ela tem limite. Consumo é quanto do seu plano cada uso gasta. Isso inclui a escolha do modelo e do esforço, que é o quanto a IA raciocina antes de responder. Alguns modelos, como os da família Fable, vêm incluídos em certos planos com limite e exigem créditos em outros. Por isso, vamos conferir o que o seu plano oferece, em vez de supor.

No segundo módulo, você transforma um procedimento em uma skill. Uma skill é um arquivo de instruções que ensina à IA como executar um procedimento seu, para que você não precise explicá-lo de novo a cada vez.

No terceiro, você conecta ferramentas por meio do MCP, um padrão aberto que permite à IA consultar ou usar outros programas, como o Drive, com a sua autorização. Mesmo uma conexão só de leitura pode expor informação sensível, então vamos conceder apenas o acesso necessário.

No quarto, você junta etapas em uma sequência e prepara uma rotina, que é um trabalho que se repete em horário definido. A ordem é esta: ensinar uma peça, testá-la sozinha, conectar as peças, aprovar e só depois agendar. Também vamos ver a diferença entre uma rotina na nuvem, que roda sem o seu computador ligado, e uma local, que precisa dele ligado.

No quinto, você leva uma skill e uma conexão para o ecossistema da OpenAI. Os nomes e a disponibilidade variam conforme o plano, e a autorização das conexões precisa ser conferida de novo.

O bônus mostra quando faz sentido acrescentar o WhatsApp. O custo do canal oficial depende do tipo de mensagem, do país e de quem iniciou a conversa. E qualquer mensagem ao cliente, inclusive uma cobrança, só é enviada depois da sua aprovação.

Nós começamos pelo Claude para aprender em um ambiente principal. Depois, a migração ajuda você a separar o método da interface. Entrada, regra, ferramenta e aprovação continuam existindo, mesmo quando mudam os menus e os nomes dos arquivos de instrução.

Agora vou abrir o arquivo projeto-final.md e preencher um exemplo pequeno com o Ateliê Horizonte: a entrada é o texto da reunião, a saída é a proposta em documento, e quem confere é a pessoa responsável pelo atendimento. Escolhi uma tarefa pequena de propósito. Organizar as informações de um pedido costuma ensinar mais do que tentar automatizar a empresa inteira de uma vez.

Além de acompanhar o exemplo, escolha um processo seu. Ele será a sua entrega ao final: um mapa, uma skill testada, a ferramenta necessária e uma conferência do resultado. Escolha algo que você entenda bem o bastante para perceber uma omissão. Durante a formação você vai refiná-lo, usando os exercícios como referência.

### m01-a01-b06 — Materiais, comunidade e uma boa dúvida

Slide m01-a01-s06

Na área de materiais da aula, procure os arquivos citados no exercício: projeto-final.md, mapa-processo.md e como-pedir-ajuda.md. Baixe uma cópia e mantenha tudo em uma pasta da formação, no seu computador. Não edite a sua única cópia de um documento de trabalho para acompanhar um exemplo. O conjunto de apoio tem textos fictícios, modelos, critérios e soluções comentadas. Tente o exercício antes de comparar com a solução, porque é assim que você percebe o que ainda não está claro. Vou localizar esses arquivos agora, sem abrir nenhum dado privado.

Quando surgir uma dúvida, use a comunidade da sua turma. Para um problema de acesso à formação, procure o suporte indicado na plataforma. Para uma dúvida de execução, envie quatro informações: qual aula você está seguindo, o que queria fazer, o que aconteceu e qual mensagem apareceu. Uma captura da área relevante costuma ajudar, desde que você esconda dados pessoais e credenciais, como senhas e chaves de acesso.

Vou abrir o como-pedir-ajuda.md e preencher uma dúvida fictícia. Compare estas duas. “Não funcionou” não mostra onde o trabalho parou. “Na aula de skills, instalei no projeto, mas a sessão não encontra o nome; a pasta existe e esta é a mensagem” já indica onde investigar: se a skill foi instalada no lugar em que a sessão procura. Você também pode dizer o que já tentou e anexar um exemplo fictício. Não precisa mandar a conversa inteira nem o arquivo real de um cliente. Esse cuidado melhora a qualidade da ajuda e torna a dúvida útil para outros alunos.

### m01-a01-b03 — O primeiro compromisso

Slide m01-a01-s03

Para começar, escolha uma tarefa pequena que você repete. Pode ser organizar informações, preparar um documento ou consultar um sistema. Pause o vídeo, abra o projeto-final.md e escreva quatro coisas: o que chega, o que você faz com isso, o que precisa sair no final e quem confere o resultado. Se quiser desenhar o caminho passo a passo, use o mapa-processo.md.

A tarefa não precisa ser o processo mais importante da empresa. Escolha uma que você conheça bem o bastante para perceber quando a IA acertou e quando deixou algo de fora. Essa conferência vai acompanhar você até o fim da formação. Use apenas dados fictícios ou genéricos nesse caderno, sem senhas e sem informações de clientes.

Na próxima aula, vamos ver por que usar um ambiente que executa tarefas, e não apenas uma conversa, e como isso muda o tipo de pedido que você faz.

# 1.1 — Como funciona a formação e o que você vai ter no final

ID m01-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Dependências e ensaio:** Captura dos canais da turma e URL específica de suporte ainda não fornecidas; não inventar o caminho da plataforma.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m01-a01-b01 | m01-a01-s01 / p. 1 | Apresentar o percurso e a prévia conceitual do caso. Não mostrar proposta como resultado já executado. | Professor apresenta entrada → etapas → entrega → conferência, sem simular uma execução. |
| m01-a01-b04 | m01-a01-s04 / p. 2 | Mostrar o mapa do Ateliê Horizonte e distinguir entendimento, proposta e documento aguardando aprovação. | O aluno distingue as três entregas e identifica quem aprova. |
| m01-a01-b02 | m01-a01-s02 / p. 3 | Mostrar a ementa por módulos e localizar os arquivos de exemplo desta entrega. | Aluno localiza os seis módulos e os arquivos de exercício. |
| m01-a01-b05 | m01-a01-s05 / p. 4 | Percorrer os seis módulos e abrir o caderno de projeto do aluno. | Projeto pessoal com entrada, saída e responsável pela conferência. |
| m01-a01-b06 | m01-a01-s06 / p. 5 | Abrir a pasta de apoio e o modelo de pergunta; reservar captura real dos canais da turma. | Aluno encontra os arquivos e prepara uma dúvida que outra pessoa consegue entender. |
| m01-a01-b03 | m01-a01-s03 / p. 6 | Pedir ao aluno uma tarefa repetitiva. Disponibilizar apoio/mapa-processo.md. | Entrada, saída, pessoa que confere e uma pergunta com contexto; sem credenciais ou dados de clientes. |

## m01-a01-b01 — O resultado que orienta o curso

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar o percurso e a prévia conceitual do caso. Não mostrar proposta como resultado já executado. | slides/m01-a01.pptx e slides/m01-a01.pdf, página 1, ID m01-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a01-b01. Sem trilha prevista. |

**Estado inicial:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Entrada/material:** apoio/projeto-final.md, apoio/mapa-processo.md, apoio/como-pedir-ajuda.md

**Passos de captura:**
1. Apresentar o percurso e a prévia conceitual do caso. Não mostrar proposta como resultado já executado.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Professor apresenta entrada → etapas → entrega → conferência, sem simular uma execução.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a01-b01; SHA-256 7fca93e884bf6a1c93267067e6038e4afb2673cc0cdca30d788744591c732332.

**Função visual:** Apresentar o percurso e a prévia conceitual do caso. Não mostrar proposta como resultado já executado.


## m01-a01-b04 — Quem conduz e quem decide

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Mostrar o mapa do Ateliê Horizonte e distinguir entendimento, proposta e documento aguardando aprovação. | slides/m01-a01.pptx e slides/m01-a01.pdf, página 2, ID m01-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a01-b04. Sem trilha prevista. |

**Estado inicial:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Entrada/material:** apoio/projeto-final.md, apoio/mapa-processo.md, apoio/como-pedir-ajuda.md

**Passos de captura:**
1. Abrir mapa-processo.md e os três arquivos do caso.
2. Apontar a entrega de cada etapa sem apresentar o exemplo como execução já feita.

**Saída e conferência:** O aluno distingue as três entregas e identifica quem aprova.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a01-b04; SHA-256 ca94e3d8d71d66097b78e94f209e50d521e80d9eedad47ceed496d7b4b1da484.

**Função visual:** Mostrar o mapa do Ateliê Horizonte e distinguir entendimento, proposta e documento aguardando aprovação.


## m01-a01-b02 — Como percorrer as aulas

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar a ementa por módulos e localizar os arquivos de exemplo desta entrega. | slides/m01-a01.pptx e slides/m01-a01.pdf, página 3, ID m01-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a01-b02. Sem trilha prevista. |

**Estado inicial:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Entrada/material:** apoio/projeto-final.md, apoio/mapa-processo.md, apoio/como-pedir-ajuda.md

**Passos de captura:**
1. Mostrar a ementa por módulos e localizar os arquivos de exemplo desta entrega.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Aluno localiza os seis módulos e os arquivos de exercício.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a01-b02; SHA-256 88ffd168f94572dd9c5ccac61036d73e0b15062e9646e3804b56dfe298e8160b.

**Função visual:** Mostrar a ementa por módulos e localizar os arquivos de exemplo desta entrega.


## m01-a01-b05 — O mapa até o seu próprio processo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Percorrer os seis módulos e abrir o caderno de projeto do aluno. | slides/m01-a01.pptx e slides/m01-a01.pdf, página 4, ID m01-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a01-b05. Sem trilha prevista. |

**Estado inicial:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Entrada/material:** apoio/projeto-final.md, apoio/mapa-processo.md, apoio/como-pedir-ajuda.md

**Passos de captura:**
1. Mostrar a sequência ambiente → skill → MCP → time → migração → bônus.
2. Abrir projeto-final.md e preencher um exemplo de tarefa pequena.

**Saída e conferência:** Projeto pessoal com entrada, saída e responsável pela conferência.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a01-b05; SHA-256 5e5ecaa9f7eac649956e429cfcdf2e0c1d59f4944f6f6e07889a0fd675fbeac3.

**Função visual:** Percorrer os seis módulos e abrir o caderno de projeto do aluno.


## m01-a01-b06 — Materiais, comunidade e uma boa dúvida

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir a pasta de apoio e o modelo de pergunta; reservar captura real dos canais da turma. | slides/m01-a01.pptx e slides/m01-a01.pdf, página 5, ID m01-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a01-b06. Sem trilha prevista. |

**Estado inicial:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Entrada/material:** apoio/projeto-final.md, apoio/mapa-processo.md, apoio/como-pedir-ajuda.md

**Passos de captura:**
1. Localizar exercícios e soluções sem abrir dados privados.
2. Preencher uma pergunta com aula, objetivo, resultado e erro.
3. No ensaio, conferir na plataforma o caminho real de comunidade e suporte.

**Saída e conferência:** Aluno encontra os arquivos e prepara uma dúvida que outra pessoa consegue entender.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a01-b06; SHA-256 eb178ba2f3c26f0e78ada97f9b2ce54df4d43a183af6d1d8a484f55938e7b1e4.

**Função visual:** Abrir a pasta de apoio e o modelo de pergunta; reservar captura real dos canais da turma.


## m01-a01-b03 — O primeiro compromisso

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Pedir ao aluno uma tarefa repetitiva. Disponibilizar apoio/mapa-processo.md. | slides/m01-a01.pptx e slides/m01-a01.pdf, página 6, ID m01-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a01-b03. Sem trilha prevista. |

**Estado inicial:** Abrir mapa do curso, pasta de apoio e plataforma da turma. Confirmar o acesso real a comunidade/suporte antes de captar a tela.

**Entrada/material:** apoio/projeto-final.md, apoio/mapa-processo.md, apoio/como-pedir-ajuda.md

**Passos de captura:**
1. Pedir ao aluno uma tarefa repetitiva. Disponibilizar apoio/mapa-processo.md.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Entrada, saída, pessoa que confere e uma pergunta com contexto; sem credenciais ou dados de clientes.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a01-b03; SHA-256 1876f79113f44a8d5f1523bfb79af55b47b2d81a1d2f268e40514f7d0fd09be3.

**Função visual:** Pedir ao aluno uma tarefa repetitiva. Disponibilizar apoio/mapa-processo.md.


## Atividade e solução

Preencher projeto-final.md com uma tarefa pequena e formular uma dúvida fictícia usando o modelo.

Entrada, saída, pessoa que confere e uma pergunta com contexto; sem credenciais ou dados de clientes.

## Materiais

- projeto-final.md
- mapa-processo.md
- como-pedir-ajuda.md

# 1.2 — Porque o Claude? / m01-a02

**Objetivo:** Distinguir superfícies do Claude e comparar orientação com execução usando a mesma entrada.

**Preparação:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Ensaio:** Comparação real entre superfícies precisa de captura e conferência no ambiente da gravação.

### m01-a02-b01 — Escolher o ambiente pela tarefa

Slide m01-a02-s01

Quando você usa uma inteligência artificial, pode pedir duas coisas diferentes. Uma é uma resposta: uma explicação, uma sugestão, um texto. A outra é um trabalho que envolve ações, como ler arquivos, organizar dados e salvar o resultado. Essa diferença ajuda a escolher o ambiente em que você vai trabalhar.

Para discutir uma ideia, uma conversa costuma bastar. Mas, se eu quero que a IA leia os arquivos de uma pasta, organize os dados, use uma ferramenta e salve uma entrega, preciso conferir se aquele ambiente oferece esses recursos. Aqui, chamo de ferramenta qualquer recurso que a IA pode acionar para agir, como abrir um arquivo ou gravar um documento.

Nesta formação, vamos concentrar o trabalho no Claude Code, usado pelo aplicativo desktop, que é o programa instalado no seu computador. O Claude Code é o ambiente do Claude para o trabalho mais técnico: você escolhe uma pasta e a sessão trabalha com os arquivos dela. Uma sessão é uma conversa de trabalho que tem o seu próprio acesso. Com um ambiente principal, você aprende o processo com menos troca de contexto, ou seja, sem precisar descobrir, a cada tela nova, onde cada coisa fica.

Isso não quer dizer que o chat nunca execute ações, nem que o Code seja o único caminho para trabalhar com agentes, que são IAs que usam ferramentas para avançar em uma tarefa. Os recursos mudam e dependem das ferramentas disponíveis na sua conta. A escolha aqui é de método, e não uma sentença sobre o que cada ambiente consegue fazer.

Agora, faça um primeiro teste. Abra um chat e uma sessão Code de teste, sem dados pessoais: sem arquivos de clientes e sem conversas suas anteriores. Em cada um, procure duas coisas: se há acesso a uma pasta e quais ferramentas aparecem. Ainda não precisa pedir nada. Os nomes e a posição dos botões podem variar conforme o seu plano e a versão do aplicativo; por isso, procure pela função e não pelo nome exato. Anote qual dos dois ambientes mostra pasta e ferramentas. Esse é o ponto de partida do que vamos comparar ao longo da aula.

### m01-a02-b04 — Escolher a superfície pelo trabalho

Slide m01-a02-s04

O nome Claude aparece em lugares diferentes, e cada lugar é uma superfície, isto é, um jeito de acessar o serviço. Na web e no celular, você conversa e usa os recursos liberados para a sua conta. No desktop, você também pode trabalhar com arquivos locais, que são os arquivos do seu computador, e com outras capacidades dele. No terminal, que é a janela em que se digitam comandos no computador, o Claude Code oferece uma interface de comandos. Existem ainda a extensão do Chrome e as sessões Code na web. Cada ambiente tem condições próprias de acesso.

Pense no mesmo profissional em mesas de trabalho diferentes. A conta e algumas conversas podem acompanhar você, mas a mesa determina quais arquivos e ferramentas estão à mão. Essa comparação ajuda a entender a continuidade; ela não significa que todas as sessões usam exatamente o mesmo modelo, as mesmas permissões ou os mesmos arquivos. O modelo é a IA que responde dentro da sessão, e as permissões definem o que essa sessão pode fazer.

Nesta formação, a indicação principal é o Code no aplicativo desktop. Vamos selecionar uma pasta, trabalhar nela e abrir a entrega fora da conversa. Quem já usa o terminal pode fazer parte do percurso por lá. Quem está na web precisa conferir se o exercício exige um arquivo local ou um projeto remoto.

Vamos transformar isso em um diagnóstico de três passos. Primeiro, abra uma sessão de exercício no aplicativo desktop. Segundo, nessa sessão, identifique três coisas: a pasta local que está selecionada, o modelo escolhido e as ferramentas disponíveis. Sobre o modelo, o acesso depende do produto e do plano, e alguns modelos exigem créditos em determinados planos. Para este exercício, use o que a sua conta oferece, sem procurar o mais avançado. Os limites de uso são compartilhados entre as superfícies; se quiser conferir quanto já usou, olhe a área Usage dentro de Settings, ou digite barra usage no Code. Terceiro, compare com uma conversa web de teste, também sem dados pessoais, e veja o que ela mostra e o que não mostra.

Ao final, você deve conseguir completar duas frases: “esta sessão executa em tal lugar” e “ela pode ler tais arquivos”. Se alguma ficar em branco, ainda falta descobrir algo antes de pedir uma ação. Por isso, antes de pedir uma ação, descubra onde ela vai acontecer. Esse é o primeiro diagnóstico quando uma tarefa funciona em um ambiente e falha em outro.

### m01-a02-b02 — Resposta e entrega

Slide m01-a02-s02

Veja a diferença entre dois pedidos. O primeiro é: “Como posso organizar uma lista de pedidos?”. Aqui eu peço orientação, e a resposta é um texto explicando como fazer. O segundo é: “Leia esta lista, separe os pedidos por situação e salve um resumo na pasta de saída”. Agora existe uma entrada, que é a lista; uma ação, que é separar e resumir; e uma saída, que é um arquivo que posso abrir e conferir.

Para praticar, vamos usar uma lista fictícia: o arquivo pedidos-demo.csv. CSV é uma planilha em texto simples, que abre no Excel ou em outro programa de planilhas. Nenhum dado real entra aqui.

Faça assim. Na sessão Code, com a pasta de exercícios selecionada, envie primeiro o pedido de orientação e leia a resposta. Depois, envie o segundo pedido. Antes de executar, eu mostro qual pasta pode ser usada e qual resultado espero. Se a sessão pedir permissão para criar um arquivo, leia o pedido e aprove somente se ele falar da pasta de saída e do resumo que você solicitou. A permissão deve ser proporcional ao efeito: criar um resumo é um efeito pequeno, e mesmo assim vale conferir o que está sendo autorizado.

Depois, confiro o arquivo que foi salvo: abro, vejo se os pedidos estão separados por situação e comparo com o que pedi. Se recebo só uma explicação de como fazer, o segundo pedido ainda não foi concluído. Nesse caso, verifique se a pasta estava selecionada e se a lista foi entregue à sessão.

O critério é simples: o primeiro pedido devolve orientação, e o segundo deve deixar um arquivo para você abrir. Registre três coisas: o acesso que a sessão tinha, a ação que ela realizou e o resultado que você encontrou.

Você vai ouvir a expressão modo agêntico. Aqui, ela descreve um trabalho em que a IA escolhe e usa ferramentas para avançar na tarefa, observa o resultado e decide o próximo passo, dentro do acesso que recebeu. A qualidade depende também da clareza do objetivo, das instruções e da conferência.

### m01-a02-b05 — O que mudou em Chat e Cowork

Slide m01-a02-s05

Uma atualização importante: a experiência de conversa e a de Cowork estão sendo unificadas no Claude. Cowork é a opção que, em algumas contas, aparecia separada da conversa. Dependendo do plano e da liberação da sua conta, esse seletor antigo pode não aparecer. Nesse caso, você descreve a tarefa na conversa e usa as capacidades disponíveis ali. Em outras contas, a interface anterior ainda pode existir. Se a sua tela for diferente da que aparece no vídeo, siga a sua e descreva o que você vê.

Por isso, a frase “no chat você pergunta, no Code você constrói” serve apenas como uma orientação inicial de estudo. Ela não descreve uma fronteira absoluta. Uma conversa com ferramentas também pode pesquisar, criar arquivos e executar várias etapas. O que vamos observar é a capacidade real daquela sessão.

Agora, uma comparação justa, em três passos. Primeiro, dê a mesma entrada às duas sessões: anexe ou abra o pedidos-demo.csv na conversa e na sessão Code. Segundo, faça o mesmo pedido de saída nas duas, pedindo um resumo salvo, e confira se o arquivo existe em cada ambiente. Terceiro, registre as diferenças reais no arquivo comparacao-ambientes.md, anotando, para cada ambiente, o acesso, a ação e o resultado. Escreva apenas o que você viu, sem completar com o que acha que deveria acontecer.

Na hora de interpretar, lembre-se: se uma superfície não recebeu a lista ou não tem acesso à pasta, isso explica a diferença; não prova que o modelo é incapaz. Se as duas entregam um arquivo correto, ambas executaram o trabalho. O exercício ensina a verificar entrada, ferramenta e resultado. A escolha do Code aqui mantém o nosso caminho de aprendizagem consistente, com os materiais organizados em um projeto.

### m01-a02-b06 — Especialização sem complicar o time

Slide m01-a02-s06

Um pedido enorme para “cuidar de tudo” mistura decisões diferentes. Pense em um caso em que uma reunião vira um resumo, o resumo vira uma proposta com preço, e a proposta é salva como documento no Drive. Se a saída estiver errada, fica difícil descobrir se o problema foi entender a reunião, escolher o preço ou salvar o documento. Separar o trabalho em procedimentos ajuda a corrigir a parte certa. Esses procedimentos especializados se chamam skills: são instruções escritas para uma tarefa específica, que você chama quando precisa dela.

Veja três falhas desse caso. Na primeira, o resumo trouxe um prazo que não foi combinado na reunião. Na segunda, o resumo está correto, mas a proposta saiu com o preço errado. Na terceira, o resumo e a proposta estão corretos, mas não há nenhum documento no Drive. Para cada uma, diga qual etapa você investigaria.

Vamos conferir. No prazo inventado, precisamos corrigir a extração do prazo, que é a etapa que lê a reunião e retira dela essa informação. Mexer na etapa da proposta não resolve a causa, porque o erro já nasceu no resumo. No preço errado, olhamos a regra ou a tabela de preços que a proposta usa; o resumo, nesse caso, não é o suspeito. No documento ausente, com o resumo e a proposta corretos, vamos olhar para o acesso e para a etapa de entrega.

Você pode começar com uma só skill para uma tarefa pequena. Não precisa criar vários agentes nem várias conversas para parecer um time. Quando surgirem responsabilidades com entradas e saídas diferentes, vale separá-las. Mais adiante, uma skill orquestradora, que é a skill que chama as outras na ordem certa e passa o resultado de uma etapa para a seguinte, vai coordenar essas passagens. Antes disso, você vai conseguir chamar cada procedimento isoladamente e observar o que ele fez. Esse é o motivo de aprender primeiro as peças: o time precisa continuar compreensível para quem é responsável pelo resultado.

### m01-a02-b03 — O mesmo serviço em superfícies diferentes

Slide m01-a02-s03

Fechando o mapa: o Claude pode aparecer no navegador, no aplicativo desktop, no celular, em uma extensão do Chrome e no terminal. Com a mesma conta, o trabalho pode continuar entre alguns desses lugares, mas recursos e acessos variam. Uma sessão pode ter acesso à sua pasta local e outra não.

Um exemplo disso é o controle remoto, que conecta uma sessão do seu computador a outro lugar de acesso, dependendo da versão, da conta e das políticas da sua organização. Mesmo assim, a execução continua no computador, que precisa estar ligado e com o processo ativo. O controle remoto não leva seus arquivos nem a execução para a nuvem.

A unificação entre conversa e Cowork está sendo liberada no Claude; sua conta pode mostrar a experiência nova ou a anterior. Em vez de decorar uma divisão antiga entre nomes, pergunte o que aquela sessão consegue acessar e executar.

Também vamos abandonar a ideia de uma instrução gigante para tudo. Você pode ter procedimentos especializados, as skills, usar um por vez e depois coordená-los. Agora vamos preparar o ambiente em que faremos isso.

# 1.2 — Porque o Claude?

ID m01-a02. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Dependências e ensaio:** Comparação real entre superfícies precisa de captura e conferência no ambiente da gravação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m01-a02-b01 | m01-a02-s01 / p. 1 | Abrir um chat e uma sessão Code de teste, sem dados pessoais. | Ambiente e recursos disponíveis ficam identificados. |
| m01-a02-b04 | m01-a02-s04 / p. 2 | Mostrar desktop, sessão Code e diagrama de superfícies, sem expor chats pessoais. | O aluno sabe dizer onde a sessão executa e quais arquivos ela pode ler. |
| m01-a02-b02 | m01-a02-s02 / p. 3 | Comparar pedido de orientação com pedido de gerar arquivo usando apoio/pedidos-demo.csv. A execução e a saída precisam ser ensaiadas. | A resposta explicativa é distinguida de um arquivo realmente gerado e aberto. |
| m01-a02-b05 | m01-a02-s05 / p. 4 | Comparar o mesmo pedido com pedidos-demo.csv; anotar diferenças observadas entre as superfícies. | Comparação baseada em acessos e resultado, sem afirmar que todo chat apenas responde. |
| m01-a02-b06 | m01-a02-s06 / p. 5 | Apresentar três falhas distintas no caso e associar cada uma à etapa responsável. | Prazo: extração; preço: regra/tabela; documento ausente: acesso/entrega. |
| m01-a02-b03 | m01-a02-s03 / p. 6 | Apresentar apenas um mapa verbal das superfícies; não fazer tour completo. | Uma orientação e uma entrega de arquivo distinguidas pela evidência; diferenças de superfície registradas. |

## m01-a02-b01 — Escolher o ambiente pela tarefa

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir um chat e uma sessão Code de teste, sem dados pessoais. | slides/m01-a02.pptx e slides/m01-a02.pdf, página 1, ID m01-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a02-b01. Sem trilha prevista. |

**Estado inicial:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/comparacao-ambientes.md

**Passos de captura:**
1. Abrir um chat e uma sessão Code de teste, sem dados pessoais.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Ambiente e recursos disponíveis ficam identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a02-b01; SHA-256 de42acd3b7d22fedfb260238ab8ebf317643455d3a6a19a166bfcf91fc7cf43b.

**Função visual:** Abrir um chat e uma sessão Code de teste, sem dados pessoais.


## m01-a02-b04 — Escolher a superfície pelo trabalho

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar desktop, sessão Code e diagrama de superfícies, sem expor chats pessoais. | slides/m01-a02.pptx e slides/m01-a02.pdf, página 2, ID m01-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a02-b04. Sem trilha prevista. |

**Estado inicial:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/comparacao-ambientes.md

**Passos de captura:**
1. Abrir uma sessão de exercício no desktop.
2. Identificar pasta local, modelo e ferramentas disponíveis.
3. Comparar com uma conversa web de teste.

**Saída e conferência:** O aluno sabe dizer onde a sessão executa e quais arquivos ela pode ler.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a02-b04; SHA-256 8b44d5fab72d6a5660e1590444a4de09937e217be27b19ccd2d9ba7e94ac36f1.

**Função visual:** Mostrar desktop, sessão Code e diagrama de superfícies, sem expor chats pessoais.


## m01-a02-b02 — Resposta e entrega

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar pedido de orientação com pedido de gerar arquivo usando apoio/pedidos-demo.csv. A execução e a saída precisam ser ensaiadas. | slides/m01-a02.pptx e slides/m01-a02.pdf, página 3, ID m01-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a02-b02. Sem trilha prevista. |

**Estado inicial:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/comparacao-ambientes.md

**Passos de captura:**
1. Comparar pedido de orientação com pedido de gerar arquivo usando apoio/pedidos-demo.csv. A execução e a saída precisam ser ensaiadas.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** A resposta explicativa é distinguida de um arquivo realmente gerado e aberto.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a02-b02; SHA-256 36fd98b38230900e6fdd915645da847d61caa9372ef7ab786d2283747c07a523.

**Função visual:** Comparar pedido de orientação com pedido de gerar arquivo usando apoio/pedidos-demo.csv. A execução e a saída precisam ser ensaiadas.


## m01-a02-b05 — O que mudou em Chat e Cowork

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar o mesmo pedido com pedidos-demo.csv; anotar diferenças observadas entre as superfícies. | slides/m01-a02.pptx e slides/m01-a02.pdf, página 4, ID m01-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a02-b05. Sem trilha prevista. |

**Estado inicial:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/comparacao-ambientes.md

**Passos de captura:**
1. Anexar ou abrir a mesma entrada nas duas sessões.
2. Pedir resumo salvo e conferir a existência do arquivo em cada ambiente.
3. Registrar diferenças reais em comparacao-ambientes.md.

**Saída e conferência:** Comparação baseada em acessos e resultado, sem afirmar que todo chat apenas responde.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a02-b05; SHA-256 813583c4c86c1f4a262e356d3ce599ecbe0ba1883163cdb8e5a54355927c6dd4.

**Função visual:** Comparar o mesmo pedido com pedidos-demo.csv; anotar diferenças observadas entre as superfícies.


## m01-a02-b06 — Especialização sem complicar o time

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Apresentar três falhas distintas no caso e associar cada uma à etapa responsável. | slides/m01-a02.pptx e slides/m01-a02.pdf, página 5, ID m01-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a02-b06. Sem trilha prevista. |

**Estado inicial:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/comparacao-ambientes.md

**Passos de captura:**
1. Mostrar prazo inventado, preço errado e documento ausente como exemplos preparados.
2. Pedir ao aluno que identifique a etapa a investigar em cada caso.

**Saída e conferência:** Prazo: extração; preço: regra/tabela; documento ausente: acesso/entrega.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a02-b06; SHA-256 6bdc5a272db4f011f340eaa7320af7bd993186bb34a0e2eed8d2536f9da25131.

**Função visual:** Apresentar três falhas distintas no caso e associar cada uma à etapa responsável.


## m01-a02-b03 — O mesmo serviço em superfícies diferentes

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar apenas um mapa verbal das superfícies; não fazer tour completo. | slides/m01-a02.pptx e slides/m01-a02.pdf, página 6, ID m01-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a02-b03. Sem trilha prevista. |

**Estado inicial:** Preparar duas conversas vazias, lista fictícia e pasta de saída. Conferir se a conta já tem a unificação Chat/Cowork.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/comparacao-ambientes.md

**Passos de captura:**
1. Apresentar apenas um mapa verbal das superfícies; não fazer tour completo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Uma orientação e uma entrega de arquivo distinguidas pela evidência; diferenças de superfície registradas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a02-b03; SHA-256 713d6627f97eecf104d6ce4563d8b8c8b9b4f5edb8640fd27f8d6df865e08efb.

**Função visual:** Apresentar apenas um mapa verbal das superfícies; não fazer tour completo.


## Atividade e solução

Executar os dois pedidos com pedidos-demo.csv, abrir a saída e registrar acesso, ação e resultado.

Uma orientação e uma entrega de arquivo distinguidas pela evidência; diferenças de superfície registradas.

## Materiais

- pedidos-demo.csv
- comparacao-ambientes.md

# 1.3 — Setup ideal para usar o Claude / m01-a03

**Objetivo:** Preparar ambiente e GitHub de exercício e verificar os requisitos de plano e celular.

**Preparação:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Ensaio:** Instalação Windows/Linux, login GitHub e acesso móvel precisam de ensaio nas respectivas superfícies.

### m01-a03-b01 — Um setup que permite começar

Slide m01-a03-s01

Nesta aula, você vai preparar o ambiente para fazer os exercícios da formação. Setup é a palavra em inglês para essa preparação: o aplicativo instalado, a conta funcionando e uma pasta onde o trabalho acontece. Ao final, você terá cinco coisas conferidas: o aplicativo com a sua conta, a pasta de exercício, um repositório de teste no GitHub, o plano com os recursos que vamos usar e o celular com a mesma conta.

Por que começar pelo mínimo? Porque, quando algo falha em um ambiente cheio de ferramentas, fica difícil saber qual delas causou o problema. Por isso, o setup precisa permitir apenas três coisas: abrir o ambiente, trabalhar na pasta certa e executar os recursos que o exemplo usa. Não vamos instalar nenhuma coleção de ferramentas antes de precisar delas.

O primeiro passo é baixar o aplicativo oficial do Claude, na versão para o seu sistema operacional, que é o Mac, o Windows ou o Linux do seu computador. Depois, entre na sua conta e procure o Code. O Code é o recurso do aplicativo para trabalhar com os arquivos de uma pasta do seu computador. Nos exercícios, é ele que vai ler, criar e organizar esses arquivos. Confira se ele aparece no seu plano e no seu ambiente. Planos, requisitos e versões mudam com o tempo. Por isso, a página oficial do fornecedor é a referência, e o que a sua conta mostra hoje vale mais do que esta gravação.

Se algum bloqueio aparecer durante a instalação, não improvise. Na próxima parte, vou mostrar como ler o aviso e o que fazer.

### m01-a03-b04 — Instalação em Mac, Windows e Linux

Slide m01-a03-s04

Vamos à instalação. Comece pela página oficial de download, no site claude.com, e confira o endereço na barra do navegador antes de baixar qualquer coisa. Depois, veja os requisitos do seu sistema na página de ajuda de instalação do Claude Desktop, que é o nome do aplicativo para computador. Baixe apenas do fornecedor, nunca de um link recebido por mensagem nem de um site de terceiros.

No Mac, escolha a versão compatível com o seu computador e siga a instalação do aplicativo. No Windows, baixe o instalador oficial, conclua a instalação e entre na sua conta. No Linux, o aplicativo de desktop está em versão beta, ou seja, ainda em fase de teste. Confira essa opção e os requisitos atuais da sua distribuição, que é a variante de Linux que você usa. Se o aplicativo não atender ao seu ambiente, consulte o caminho oficial do Claude Code para terminal, que é a janela onde se digitam comandos em texto.

Você não precisa fazer as três instalações. Nesta gravação, vou executar o caminho do Mac e mostrar Windows e Linux pelo guia oficial, sem instalar. Acompanhe o caminho do seu computador e use o guia de apoio para os demais sistemas.

Se o aplicativo já estiver instalado, confira se há atualização antes de procurar uma função que não aparece. Uma versão antiga, uma restrição da organização ou um plano sem aquele recurso podem produzir telas diferentes das que você vê aqui.

Quando aparecer um alerta, leia a mensagem inteira e confirme de onde veio o arquivo. Observe três coisas: a origem do instalador, o que o aviso diz e o que o fornecedor orienta. Se o computador é da empresa, uma política de segurança pode exigir a ajuda da equipe responsável pela tecnologia. Desativar o antivírus não é o caminho, e não faça isso para continuar a aula. Anote o sistema, a versão do aplicativo e o texto do erro. Assim, você consegue procurar a orientação correta ou pedir ajuda com informação suficiente.

O teste da instalação termina quando o aplicativo abre e a conta entra, não apenas quando o download acaba.

### m01-a03-b02 — Conta, pasta e dependências

Slide m01-a03-s02

Agora, a pasta. Crie uma pasta só para os exercícios da formação. Vou chamá-la de Agentic Pro. Deixe-a em um lugar fácil de achar, como a pasta Documentos. No Code, escolha essa pasta como a pasta de trabalho. Em seguida, coloque nela o arquivo de exemplo da aula, o pedidos-demo.csv, que é uma planilha fictícia de pedidos.

Agora peça à IA, por escrito, algo simples, como: liste os arquivos desta pasta e salve a lista em um arquivo chamado teste-setup.md, dentro dela. O Code pode pedir a sua autorização antes de criar o arquivo. Por enquanto, deixe as permissões no modo padrão, leia o que ele quer fazer e autorize só o que estiver dentro da pasta de exercício. Com isso você confere duas coisas: se a sessão enxerga a pasta, porque o pedidos-demo.csv deve aparecer na lista, e se o resultado vai para onde você pediu. Além disso, o exercício fica separado dos seus outros projetos. Não precisamos abrir pastas pessoais para fazer esse teste.

Agora, duas dependências que costumam gerar confusão. A primeira: Git e GitHub não são a mesma coisa. O Git registra as versões do seu trabalho. O GitHub é um serviço que guarda e compartilha projetos que usam o Git. Para uma tarefa local, você não precisa de conta no GitHub. Vamos usá-lo quando o projeto pedir.

A segunda: Node e npm. O Node é um ambiente que roda programas escritos em JavaScript, e o npm é o gerenciador que baixa pacotes para ele. Eles também entram só quando o exemplo exigir. Algumas ferramentas que instalam skills usam o npx, que faz parte desse ecossistema e executa um pacote sem instalá-lo de forma permanente. Skills são pacotes de instruções que ensinam a IA a seguir um procedimento, e vamos vê-las com calma mais adiante. Já a instalação nativa do Claude Code, a que o próprio fornecedor oferece, é outro caminho. Quando um exemplo precisar de uma dependência, vamos dizer qual é e testar se ela funciona. Não vamos instalar tudo por precaução.

### m01-a03-b05 — GitHub: para que serve e como conectar

Slide m01-a03-s05

Vamos recuperar uma peça que muita gente pula: o GitHub. Ele ajuda a guardar versões e a compartilhar um projeto. Um repositório é o lugar onde ficam os arquivos e o histórico de mudanças daquele trabalho. O Git é o mecanismo que registra as versões, e o GitHub é o serviço que hospeda esses repositórios na internet. Ele aparece em exemplos da formação, por isso vamos conectá-lo agora com um repositório de teste.

Primeiro, crie na sua conta do GitHub um repositório privado de exercício, que só você enxerga. Ele precisa ter um README, que é o arquivo de apresentação do projeto, com uma frase simples, como: repositório de exercício. Confira se a tela de criação oferece a opção de começar já com um README. Se a tela da sua conta for diferente, siga a ajuda do GitHub. Use um repositório descartável, sem nada importante dentro.

Depois, no ambiente que vai usá-lo, procure a integração de GitHub e siga o login oficial. Faça o login só na tela do próprio GitHub, e nunca digite senha ou chave de acesso na conversa com a IA. Confira qual conta está autorizando. Confira também o escopo da autorização, que é o que a integração poderá ver e fazer. Quando essa opção existir, limite o acesso ao repositório de exercício. Conectar o GitHub no navegador não garante que as outras superfícies, como o aplicativo de computador, herdaram a conexão. Verifique em cada uma que você for usar.

Peça primeiro uma leitura: localizar o repositório e abrir o README. Compare o nome e o conteúdo com o que você vê no site do GitHub. Quando um exercício exigir alteração, revise o que será modificado antes de salvar uma nova versão. Nada será publicado para outras pessoas sem a sua aprovação, e não vamos mexer em repositórios que não sejam o de exercício. Também não precisamos aprender agora todo o fluxo de desenvolvimento. O objetivo é reconhecer por que o serviço aparece na formação e conseguir conferir a conexão.

Uma tarefa inteiramente local pode continuar sem GitHub. Já uma sessão de nuvem, que roda nos servidores do fornecedor e não no seu computador, só enxerga o que você enviar ou conectar. Se ela trabalha com um repositório, você precisa preparar esse acesso antes.

### m01-a03-b06 — Plano, computador, celular e a conta do trabalho

Slide m01-a03-s06

Para acompanhar, você precisa de um computador compatível, conexão com a internet e uma conta com acesso aos recursos que vamos usar. Comece pelo plano que comporte o seu ensaio e confira a tabela atual de planos na página oficial antes de contratar. Se você já tem um plano, teste os exercícios básicos antes de aumentar o gasto. Limites e recursos variam, e uma aula gravada não substitui o que a sua conta mostra hoje.

Dois pontos de custo merecem atenção. O primeiro são os limites de uso. Existe um limite por sessão de cinco horas e outro semanal, e eles são compartilhados entre o aplicativo, o Code e o celular. Algumas contas têm exceções, e há planos que podem não ter o limite de cinco horas. Para saber como está a sua conta, abra Configurações, na área de uso, ou digite o comando barra usage dentro do Code. O segundo ponto são os modelos mais avançados. Os da família Fable, por exemplo, podem estar incluídos com um limite em alguns planos e exigir créditos em outros. Créditos adicionais são cobrados conforme o uso, e não existe uma proporção fixa que valha para todos. Confira a sua conta antes de escolher um modelo.

Instale também o aplicativo oficial no celular e entre na mesma conta. Primeiro, confira se você consegue abrir uma conversa de teste, sem dados reais da empresa. Controlar de longe uma sessão que roda no seu computador é uma função separada, com condições próprias, como o computador ligado e o processo ativo. Ela não transfere seus arquivos nem a execução para a nuvem. Instalar o aplicativo não liga esse acesso automaticamente.

Para avaliar o custo, compare com o trabalho que você quer realizar. Muita gente compara o Claude com um funcionário. A comparação só ajuda a perguntar quanto tempo, qualidade e supervisão a solução exige. Ela não quer dizer que a assinatura substitui uma pessoa nem que haverá retorno financeiro. Faça uma conta simples com os seus próprios dados: o tempo gasto antes, o tempo de revisão depois e o custo das ferramentas. Se o resultado precisa de uma hora de correção, essa hora entra na conta.

Agora, abra o checklist de setup, nos materiais da aula, e preencha a matriz de contas e custos. Anote o computador, a conta, a pasta, o arquivo de saída, o GitHub, o celular e o custo de cada item. Não coloque dados de pagamento nem informações pessoais. No fim do setup, guarde o comprovante do teste, os caminhos dos arquivos e o lugar onde você acompanha o consumo. Isso vale mais do que instalar recursos que você ainda não usa.

### m01-a03-b03 — Conferir o ambiente

Slide m01-a03-s03

Chegamos à conferência. O teste do setup tem quatro pontos: o aplicativo abre, a conta está conectada, a sessão acessa a pasta escolhida e o resultado aparece onde você pediu. Se algum deles falhar, resolva esse ponto antes de acrescentar outra ferramenta. Com um problema de cada vez, é mais fácil descobrir a causa.

Dois itens completam o checklist. O primeiro é o GitHub: o README do repositório de teste, lido pela integração, precisa ser igual ao que aparece no site. O segundo é o celular: o aplicativo entra na mesma conta e abre uma conversa de teste. Uma observação sobre o celular. O aplicativo pode ajudar a acompanhar o trabalho, mas isso não faz da sessão um acesso remoto ao seu computador. Esse uso depende do recurso próprio e das condições de execução que vimos antes.

Agora é com você. Pause o vídeo e siga os passos com o guia de setup, nos materiais da aula. Confira os quatro pontos, inclusive o arquivo de saída. Depois, leia o README do repositório de teste e abra o arquivo que o Code criou na pasta local. Anote o resultado de cada item no checklist.

Com a pasta preparada e o primeiro arquivo conferido, você tem um ambiente de exercício. Na próxima aula, vamos dar nome às peças que vão trabalhar dentro dele.

# 1.3 — Setup ideal para usar o Claude

ID m01-a03. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Dependências e ensaio:** Instalação Windows/Linux, login GitHub e acesso móvel precisam de ensaio nas respectivas superfícies.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m01-a03-b01 | m01-a03-s01 / p. 1 | Mostrar o download oficial e identificar o sistema operacional. Não executar instalação no computador do usuário durante a preparação do roteiro. | Requisitos da plataforma e caminho oficial de instalação identificados. |
| m01-a03-b04 | m01-a03-s04 / p. 2 | Mostrar o download oficial e os caminhos dos três sistemas; executar apenas o sistema disponível. | Instalação do ambiente disponível comprovada; orientações dos demais identificadas como documentais. |
| m01-a03-b02 | m01-a03-s02 / p. 3 | Demonstrar criação da pasta Agentic Pro e abertura no Code. Exibir verificações de acesso sem explorar pastas pessoais. | Pasta correta aberta, permissões limitadas e dependências necessárias identificadas. |
| m01-a03-b05 | m01-a03-s05 / p. 4 | Conectar GitHub a um repositório privado de teste e demonstrar leitura do README. | Repositório correto e README lido; acesso documentado por superfície. |
| m01-a03-b06 | m01-a03-s06 / p. 5 | Abrir checklist de setup e preencher recursos/custo sem mostrar cobrança ou dados pessoais. | Checklist com computador, conta, pasta, saída, GitHub e celular; custos identificados, sem ROI prometido. |
| m01-a03-b03 | m01-a03-s03 / p. 6 | Usar apoio/setup.md e conferir arquivo de saída do teste. | App e conta funcionam; arquivo local existe; README correto é lido; acesso móvel conferido sem supor controle remoto. |

## m01-a03-b01 — Um setup que permite começar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar o download oficial e identificar o sistema operacional. Não executar instalação no computador do usuário durante a preparação do roteiro. | slides/m01-a03.pptx e slides/m01-a03.pdf, página 1, ID m01-a03-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a03-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a03-b01. Sem trilha prevista. |

**Estado inicial:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Entrada/material:** apoio/setup-completo.md, apoio/matriz-contas-custos.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Mostrar o download oficial e identificar o sistema operacional. Não executar instalação no computador do usuário durante a preparação do roteiro.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Requisitos da plataforma e caminho oficial de instalação identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a03-b01; SHA-256 6bb8c62264835187a4fd0ba8b92284cc05fc64d72be41b84f67395b23b000b25.

**Função visual:** Mostrar o download oficial e identificar o sistema operacional. Não executar instalação no computador do usuário durante a preparação do roteiro.


## m01-a03-b04 — Instalação em Mac, Windows e Linux

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar o download oficial e os caminhos dos três sistemas; executar apenas o sistema disponível. | slides/m01-a03.pptx e slides/m01-a03.pdf, página 2, ID m01-a03-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a03-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a03-b04. Sem trilha prevista. |

**Estado inicial:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Entrada/material:** apoio/setup-completo.md, apoio/matriz-contas-custos.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Conferir domínio oficial e requisito do sistema.
2. Instalar/atualizar no Mac do professor.
3. Usar guia documentado para Windows/Linux; marcar esses ambientes como não ensaiados se indisponíveis.

**Saída e conferência:** Instalação do ambiente disponível comprovada; orientações dos demais identificadas como documentais.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a03-b04; SHA-256 b9c9deaf8b6125b754ba16026daed587f9f1dc8ed7a363a12d5f831d2b7878bd.

**Função visual:** Mostrar o download oficial e os caminhos dos três sistemas; executar apenas o sistema disponível.


## m01-a03-b02 — Conta, pasta e dependências

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Demonstrar criação da pasta Agentic Pro e abertura no Code. Exibir verificações de acesso sem explorar pastas pessoais. | slides/m01-a03.pptx e slides/m01-a03.pdf, página 3, ID m01-a03-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a03-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a03-b02. Sem trilha prevista. |

**Estado inicial:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Entrada/material:** apoio/setup-completo.md, apoio/matriz-contas-custos.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Demonstrar criação da pasta Agentic Pro e abertura no Code. Exibir verificações de acesso sem explorar pastas pessoais.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Pasta correta aberta, permissões limitadas e dependências necessárias identificadas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a03-b02; SHA-256 9c661ee25ca6f86999d5156b0784ab491af34501e320cc036de01eeeeafb6352.

**Função visual:** Demonstrar criação da pasta Agentic Pro e abertura no Code. Exibir verificações de acesso sem explorar pastas pessoais.


## m01-a03-b05 — GitHub: para que serve e como conectar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conectar GitHub a um repositório privado de teste e demonstrar leitura do README. | slides/m01-a03.pptx e slides/m01-a03.pdf, página 4, ID m01-a03-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a03-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a03-b05. Sem trilha prevista. |

**Estado inicial:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Entrada/material:** apoio/setup-completo.md, apoio/matriz-contas-custos.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Criar repositório privado vazio de exercício.
2. Autorizar a integração oficial no cliente usado, conferindo escopo.
3. Ler README e comparar com o GitHub.
4. Não publicar nem alterar repositórios do usuário.

**Saída e conferência:** Repositório correto e README lido; acesso documentado por superfície.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a03-b05; SHA-256 e32189c288972776d154097a4d66225091066b5d6d2274d1a6e6e45b579d1f61.

**Função visual:** Conectar GitHub a um repositório privado de teste e demonstrar leitura do README.


## m01-a03-b06 — Plano, computador, celular e a conta do trabalho

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir checklist de setup e preencher recursos/custo sem mostrar cobrança ou dados pessoais. | slides/m01-a03.pptx e slides/m01-a03.pdf, página 5, ID m01-a03-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a03-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a03-b06. Sem trilha prevista. |

**Estado inicial:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Entrada/material:** apoio/setup-completo.md, apoio/matriz-contas-custos.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Conferir plano e recursos na página oficial.
2. Instalar app móvel e abrir conversa fictícia.
3. Preencher matriz de contas e custo, sem dados de pagamento.

**Saída e conferência:** Checklist com computador, conta, pasta, saída, GitHub e celular; custos identificados, sem ROI prometido.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a03-b06; SHA-256 d69f6ce9068112bcac2f4581eb0e01011ad5318b8f123d2287c20ac0228553a1.

**Função visual:** Abrir checklist de setup e preencher recursos/custo sem mostrar cobrança ou dados pessoais.


## m01-a03-b03 — Conferir o ambiente

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar apoio/setup.md e conferir arquivo de saída do teste. | slides/m01-a03.pptx e slides/m01-a03.pdf, página 6, ID m01-a03-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a03-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a03-b03. Sem trilha prevista. |

**Estado inicial:** Preparar repositório privado descartável, app atualizado e checklist por sistema; autenticar fora da captura.

**Entrada/material:** apoio/setup-completo.md, apoio/matriz-contas-custos.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Usar apoio/setup.md e conferir arquivo de saída do teste.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** App e conta funcionam; arquivo local existe; README correto é lido; acesso móvel conferido sem supor controle remoto.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a03-b03; SHA-256 d6612e64ff56b54275d9859a38655312287b9a03edd1bd81512d6eaa57bc67cf.

**Função visual:** Usar apoio/setup.md e conferir arquivo de saída do teste.


## Atividade e solução

Concluir checklist de setup, ler o README do repositório de teste e abrir um arquivo criado na pasta local.

App e conta funcionam; arquivo local existe; README correto é lido; acesso móvel conferido sem supor controle remoto.

## Materiais

- setup-completo.md
- matriz-contas-custos.md
- pedidos-demo.csv

# 1.4 — As peças de um time de IA / m01-a04

**Objetivo:** Identificar skill, MCP/conector e plugin por meio de exemplos e diagnosticar falhas de cada peça.

**Preparação:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Ensaio:** Leitura por conector depende da conta de exercício; não usar documento de cliente.

### m01-a04-b01 — Um mapa para as próximas aulas

Slide m01-a04-s01

Nesta aula vamos separar cinco nomes que aparecem o tempo todo quando se fala de IA no trabalho: modelo, agente, skill, MCP e plugin. Para não ficar abstrato, vou usar o mesmo exemplo do começo ao fim: resumir uma conversa.

O modelo é o recurso que interpreta o seu pedido e produz o raciocínio e as respostas. No exemplo, é ele que entende o que é uma decisão e escreve o resumo.

O agente é o sistema que conduz o trabalho, usando o modelo e as ferramentas disponíveis. No exemplo, é o agente que abre o arquivo da conversa, aplica o procedimento e entrega o resultado.

A skill guarda um procedimento que pode ser reutilizado. Na prática, é um arquivo de instruções, com um nome, uma descrição e as regras do trabalho. No exemplo, é a regra de como resumir: quais seções entram e o que fazer quando uma informação não aparece.

O MCP, sigla de Model Context Protocol, é um padrão aberto para acessar ferramentas e dados externos. Padrão, aqui, quer dizer um combinado sobre como um programa pede uma operação a outro. A integração que aparece na tela da ferramenta costuma se chamar conector, e ela pode usar MCP por baixo. No exemplo, seria o acesso para buscar a conversa num serviço fora do seu computador.

E o plugin pode reunir vários desses recursos num pacote, para facilitar a instalação e o uso.

Por que separar assim? Porque cada peça responde por uma parte do trabalho. Se a resposta saiu ruim, talvez falte critério na instrução, e aí o ajuste é no procedimento. Se a ferramenta nem chegou a ser acessada, o problema pode estar na conexão ou na permissão. Trocar o modelo, ou pedir que ele pense mais, nem sempre resolve. Por isso, antes de mexer no modelo, vamos aprender a perguntar qual peça falhou.

### m01-a04-b04 — Uma skill em ação, com conferência

Slide m01-a04-s04

Agora vamos ver uma skill funcionando, com a mesma entrada do começo ao fim. Pense na skill como um manual escrito: o procedimento fica registrado uma vez, e o agente consulta quando precisa.

Primeiro, a entrada. Esta é a conversa fictícia, no arquivo conversa-demo.txt. Ela tem uma decisão, uma pessoa responsável e uma informação que ficou faltando. Repare que não estamos usando nenhuma conversa de cliente: tudo aqui é inventado para o exercício.

Depois, o manual. Abra o arquivo criterios-resumo.md e leia a regra antes de executar qualquer coisa. O procedimento de resumo pede três seções: decisões, ações e perguntas abertas. Ele também manda marcar como não informado o que o texto não diz. Ler a regra antes é o que permite saber o que esperar do resultado.

Agora, peça para aplicar a skill de exemplo, a skill-resumo-exemplo.md, à conversa-demo.txt. Quando o resumo aparecer, não o aceite pela aparência. Compare com a fonte, ponto a ponto. A pessoa responsável foi mantida? A pendência continuou como pendência, ou virou uma decisão que ninguém tomou? O prazo que não aparece na conversa foi reconhecido como ausente, ou alguém inventou uma data? Esses critérios explicam por que o resumo serve ao trabalho: ele só vale se bater com a origem.

Em seguida, a segunda entrada. Abra o arquivo conversa-incompleta.txt. Ele é a mesma conversa, com uma única diferença: sem a frase que diz quem é o responsável. Execute a skill de novo e confira se o procedimento resiste à informação faltante. O esperado é que o resumo marque o responsável como não informado, e não escolha um nome por conta própria. Se aparecer um nome que não está no texto, o problema é de conferência, e é isso que vamos treinar.

Escrever o manual uma vez evita repetir toda a orientação a cada pedido, mas não transforma a IA numa máquina que obedece perfeitamente para sempre. Você continua testando e atualizando o procedimento quando o processo muda. Esse é o sentido útil da comparação com o manual do funcionário novo: ele orienta o trabalho e pode ser consultado, mas o resultado ainda precisa de supervisão.

### m01-a04-b02 — Manual e acesso

Slide m01-a04-s02

Vamos completar essa comparação. Pense numa pessoa nova entrando na equipe. Você explica o que ela precisa fazer e também dá acesso às ferramentas de que ela precisa. Manual e acesso são coisas diferentes: ela pode ter o melhor manual e ainda assim não conseguir abrir o sistema.

No nosso exemplo, o arquivo conversa-demo.txt, que está na tela, é a entrada. A skill é o manual: orienta como identificar decisões, responsáveis e pendências, e como apresentar o resumo. Aqui, a conversa já está na pasta de exercícios, então não precisamos de nenhum acesso especial. Agora, se eu quiser buscar essa conversa num serviço externo, preciso de um meio de acesso.

Esse acesso pode vir de um conector. Quando o conector usa MCP, as operações ficam disponíveis de um jeito padronizado, e a ferramenta consegue descobrir o que pode pedir. Vou fazer agora uma consulta por um conector, só para você ver o acesso acontecendo. O que ela devolver só conta depois que conferirmos a origem, e isso vem logo a seguir.

Mas conectar não decide qual conversa escolher, o que extrair ou quando pedir aprovação. Essas decisões fazem parte do processo que vamos desenhar nas próximas aulas. O conector abre a porta; quem decide o que entra por ela é o processo.

Um detalhe importante: o agente também pode agir por outros caminhos, como ferramentas locais e navegador. A comparação com o acesso ajuda a entender o MCP, mas ele é um dos caminhos possíveis, não o único.

### m01-a04-b05 — Uma ferramenta conectada em ação

Slide m01-a04-s05

A skill sabe como resumir, mas precisa receber a conversa. Se o texto está numa pasta local, uma ferramenta de arquivo pode lê-lo, e foi isso que fizemos até agora. Se está num serviço externo, precisamos de uma conexão adequada. Vamos usar uma operação de leitura, que só consulta e não altera nada, para observar essa diferença.

Vou usar um conector de leitura que já esteja disponível na conta de exercício, e um documento fictício. Se na sua conta não houver um conector assim, acompanhe a demonstração e depois repita o resumo com o arquivo local. O objetivo é enxergar o caminho, e não conectar um serviço seu agora.

Primeiro, localize o recurso pelo nome e confira o identificador dele, o ID. Dois documentos podem ter nomes parecidos; o ID é o que diz de qual se trata. Anote o nome do conector, a operação usada e o ID. Isso é o registro da origem. Depois, peça para abrir somente aquele arquivo, pelo ID. Antes de resumir, veja se o conteúdo corresponde ao documento escolhido. Só então aplique o mesmo procedimento de resumo que usamos antes.

O caminho completo é: localizar, ler, interpretar e conferir. Uma resposta plausível, sem origem identificada, não comprova que o serviço foi acessado. Um texto bem escrito pode vir da leitura de verdade ou de uma suposição do modelo, e só o registro de origem separa as duas coisas.

MCP padroniza como um cliente, o programa que você está usando, descobre e chama operações. Ele não substitui o login, nem concede permissão por conta própria. Um conector pode mostrar várias ferramentas, mas você libera apenas as necessárias. Ler um arquivo já pode envolver informação sensível; por isso nosso exercício usa dados fictícios e uma pasta de teste, e nunca um documento de cliente. Qualquer operação que altere algo ou envie algo para fora exige aprovação sua antes de acontecer. Aqui, só lemos.

Mais adiante você vai conectar serviços concretos. Por enquanto, observe a separação: o acesso traz a informação, a skill orienta o tratamento e você confere o resultado.

### m01-a04-b06 — Plugin e diagnóstico da peça que falta

Slide m01-a04-s06

Um plugin pode facilitar a instalação de um conjunto de recursos. Vamos olhar a descrição de um pacote de exemplo, sem dados de conta. Separe o que ele inclui: instruções, conexões e outros recursos. Depois, confira o que ainda precisa de autorização. Um kit instalado pode continuar sem acesso à conta de um serviço, porque instalar não é o mesmo que autorizar. Essa autorização é feita à parte, por você.

Agora vamos usar um quadro com três colunas: procedimento, acesso e conferência. A pergunta é sempre a mesma: qual dessas três coisas falhou? Vamos fazer um diagnóstico rápido com três situações.

Primeira: a IA leu a conversa, mas não separou decisões de sugestões. O texto chegou; o que faltou foi critério. Olhe para o procedimento e para seus critérios, e acrescente a regra que está faltando.

Segunda: a IA conhece o procedimento, mas não encontra a reunião. Aqui o critério pode estar certo, e o problema é chegar até o material. Olhe para o identificador, a conexão e a permissão.

Terceira: o arquivo foi criado, mas o conteúdo está errado. Confira a entrada e a regra antes de aumentar o esforço do modelo. Muitas vezes a entrada estava incompleta, ou a regra não dizia o que você esperava, e mais esforço não corrige isso.

Agora explique o seu próprio processo usando essas peças. Qual é o manual? Qual acesso externo ele exige? O que um pacote poderia instalar? Onde alguém confere? Se você consegue responder, já tem o índice do resto da formação. Nos próximos módulos vamos aprofundar a escolha, a criação e a combinação dessas peças. Não precisa instalar um pacote para cada problema: comece identificando o que está faltando para aquela tarefa acontecer.

### m01-a04-b03 — Cada peça resolve uma parte

Slide m01-a04-s03

Vamos juntar tudo numa linha só: entrada, regra, ferramenta e saída. No nosso exemplo, a entrada é a conversa. A regra é a skill, com seus critérios. A ferramenta é o que dá acesso ao que está fora, como um conector que pode usar MCP. A saída é o resumo, e a conferência fica com você. O modelo trabalha no meio disso, e o agente conduz o conjunto. O plugin, quando existe, é só a embalagem que traz algumas dessas peças juntas.

Por isso, ao instalar um plugin, olhe o que o pacote inclui de fato antes de assumir que o nome cobre tudo de que você precisa. Ele pode trazer skills, conectores e outros recursos de uma vez, mas o acesso à sua conta continua dependendo da sua autorização.

Fique com esta pergunta: o que está faltando para a tarefa acontecer? Pode ser capacidade de execução, procedimento, acesso ou um critério para conferir o resultado. Ao longo da formação, você vai aprender a identificar essas partes e combiná-las.

Antes de construir o procedimento, vamos entender como escolher os recursos de modelo e acompanhar o consumo. O que está disponível depende do produto e do plano que você usa, e é isso que vamos ver na próxima aula.

# 1.4 — As peças de um time de IA

ID m01-a04. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Dependências e ensaio:** Leitura por conector depende da conta de exercício; não usar documento de cliente.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m01-a04-b01 | m01-a04-s01 / p. 1 | Apresentar a função de cada peça por meio do mesmo exemplo de resumo. | Modelo, agente, skill, MCP e plugin recebem funções distintas no exemplo. |
| m01-a04-b04 | m01-a04-s04 / p. 2 | Aplicar skill-resumo-exemplo.md à conversa completa e à incompleta. | Resumo preserva fatos e marca ausência; não inventa responsável ou prazo. |
| m01-a04-b02 | m01-a04-s02 / p. 3 | Mostrar apoio/conversa-demo.txt e o procedimento de resumo. Depois, demonstrar uma consulta com conector; não afirmar resultado antes da conferência. | Resumo usa procedimento; consulta usa acesso real e retorna dado conferível. |
| m01-a04-b05 | m01-a04-s05 / p. 4 | Demonstrar leitura de documento fictício por conector disponível; registrar origem e operação. | Origem do documento e operação observadas; resumo comparado com a entrada. |
| m01-a04-b06 | m01-a04-s06 / p. 5 | Inspecionar a descrição de um plugin e classificar três falhas do exemplo. | Aluno associa cada falha à peça correta, sem assumir que plugin libera o serviço. |
| m01-a04-b03 | m01-a04-s03 / p. 6 | Relacionar entrada, regra, ferramenta e saída, sem criar novos visuais nesta etapa. | Manual, acesso e pacote distinguidos; resumo não inventa fatos; leitura mostra origem. |

## m01-a04-b01 — Um mapa para as próximas aulas

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar a função de cada peça por meio do mesmo exemplo de resumo. | slides/m01-a04.pptx e slides/m01-a04.pdf, página 1, ID m01-a04-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a04-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a04-b01. Sem trilha prevista. |

**Estado inicial:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/criterios-resumo.md

**Passos de captura:**
1. Apresentar a função de cada peça por meio do mesmo exemplo de resumo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Modelo, agente, skill, MCP e plugin recebem funções distintas no exemplo.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a04-b01; SHA-256 54521bbcf9fd9e21364533b2e5defcefb8b815ec729578a32706ac9292542da8.

**Função visual:** Apresentar a função de cada peça por meio do mesmo exemplo de resumo.


## m01-a04-b04 — Uma skill em ação, com conferência

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Aplicar skill-resumo-exemplo.md à conversa completa e à incompleta. | slides/m01-a04.pptx e slides/m01-a04.pdf, página 2, ID m01-a04-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a04-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a04-b04. Sem trilha prevista. |

**Estado inicial:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/criterios-resumo.md

**Passos de captura:**
1. Ler critérios-resumo.md.
2. Executar a skill com conversa-demo.txt.
3. Repetir com conversa-incompleta.txt.
4. Comparar decisão, responsável, pendência e prazo.

**Saída e conferência:** Resumo preserva fatos e marca ausência; não inventa responsável ou prazo.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a04-b04; SHA-256 ec5673a3a4685cab92c391ea327493e3bd0be88f7d51a373e8b11de5b38067cf.

**Função visual:** Aplicar skill-resumo-exemplo.md à conversa completa e à incompleta.


## m01-a04-b02 — Manual e acesso

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar apoio/conversa-demo.txt e o procedimento de resumo. Depois, demonstrar uma consulta com conector; não afirmar resultado antes da conferência. | slides/m01-a04.pptx e slides/m01-a04.pdf, página 3, ID m01-a04-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a04-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a04-b02. Sem trilha prevista. |

**Estado inicial:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/criterios-resumo.md

**Passos de captura:**
1. Mostrar apoio/conversa-demo.txt e o procedimento de resumo. Depois, demonstrar uma consulta com conector; não afirmar resultado antes da conferência.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Resumo usa procedimento; consulta usa acesso real e retorna dado conferível.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a04-b02; SHA-256 eac383004860c35e14315e222edc796b1b52134bdc7804509f092622f0a9d485.

**Função visual:** Mostrar apoio/conversa-demo.txt e o procedimento de resumo. Depois, demonstrar uma consulta com conector; não afirmar resultado antes da conferência.


## m01-a04-b05 — Uma ferramenta conectada em ação

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Demonstrar leitura de documento fictício por conector disponível; registrar origem e operação. | slides/m01-a04.pptx e slides/m01-a04.pdf, página 4, ID m01-a04-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a04-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a04-b05. Sem trilha prevista. |

**Estado inicial:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/criterios-resumo.md

**Passos de captura:**
1. Escolher conector de leitura já disponível na conta de exercício.
2. Localizar documento fictício por ID e abrir o conteúdo.
3. Aplicar o mesmo procedimento de resumo.

**Saída e conferência:** Origem do documento e operação observadas; resumo comparado com a entrada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a04-b05; SHA-256 9f982963c8680f3333757679d35f00504c9199cc7e0afc759ede18c84c4b3d5f.

**Função visual:** Demonstrar leitura de documento fictício por conector disponível; registrar origem e operação.


## m01-a04-b06 — Plugin e diagnóstico da peça que falta

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Inspecionar a descrição de um plugin e classificar três falhas do exemplo. | slides/m01-a04.pptx e slides/m01-a04.pdf, página 5, ID m01-a04-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a04-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a04-b06. Sem trilha prevista. |

**Estado inicial:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/criterios-resumo.md

**Passos de captura:**
1. Mostrar recursos incluídos no pacote e autenticação separada.
2. Aplicar o quadro procedimento/acesso/conferência a três falhas.

**Saída e conferência:** Aluno associa cada falha à peça correta, sem assumir que plugin libera o serviço.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a04-b06; SHA-256 e83a44535785cb63093cb2aecca3cbb9c9b9d9a189c94e9f8c6684d6293b55bc.

**Função visual:** Inspecionar a descrição de um plugin e classificar três falhas do exemplo.


## m01-a04-b03 — Cada peça resolve uma parte

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Relacionar entrada, regra, ferramenta e saída, sem criar novos visuais nesta etapa. | slides/m01-a04.pptx e slides/m01-a04.pdf, página 6, ID m01-a04-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a04-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a04-b03. Sem trilha prevista. |

**Estado inicial:** Instalar somente a skill de exercício; preparar documento fictício legível no conector e descrição de plugin sem dados de conta.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/criterios-resumo.md

**Passos de captura:**
1. Relacionar entrada, regra, ferramenta e saída, sem criar novos visuais nesta etapa.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Manual, acesso e pacote distinguidos; resumo não inventa fatos; leitura mostra origem.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a04-b03; SHA-256 3b587f6f17658a56deaa7ba35f14fce219a6990867be989ec9c20554fc3f7659.

**Função visual:** Relacionar entrada, regra, ferramenta e saída, sem criar novos visuais nesta etapa.


## Atividade e solução

Executar o resumo com duas entradas, observar uma leitura por conector e classificar as três falhas do quadro.

Manual, acesso e pacote distinguidos; resumo não inventa fatos; leitura mostra origem.

## Materiais

- skill-resumo-exemplo.md
- conversa-demo.txt
- conversa-incompleta.txt
- criterios-resumo.md

# 1.5 — Modelos, esforço, planos e limites / m01-a05

**Objetivo:** Escolher modelo e esforço com critério e localizar limites/cobranças da própria conta.

**Preparação:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Ensaio:** Seletor, esforço e painel devem ser conferidos novamente na data da gravação.

### m01-a05-b01 — Escolher recursos com intenção

Slide m01-a05-s01

Você não precisa usar o recurso mais caro em toda tarefa para trabalhar bem com IA. Precisa escolher um recurso adequado ao problema e conferir se ele entregou a qualidade necessária. Nesta aula, você vai aprender a fazer essa escolha e a encontrar, na sua própria conta, quanto já usou e o que pode ser cobrado a mais.

Dois controles definem esse recurso. O primeiro é o modelo, o sistema que lê o seu pedido e produz a resposta. O segundo é o esforço, que indica quanto raciocínio esse modelo dedica à tarefa antes de responder. Mais esforço pode significar mais tempo de espera e mais consumo.

Os modelos vêm em famílias, que são grupos de modelos com o mesmo nome de base: Fable, Opus, Sonnet e Haiku. Quais delas aparecem para você depende da sua conta, do seu plano e do produto que você está usando. Como ponto de partida para testar: Opus ou Fable podem ser considerados para planejar algo complexo ou longo; Sonnet, para executar etapas bem definidas; Haiku, para uma tarefa simples. São critérios iniciais, não uma hierarquia que vale sempre.

Um cuidado com o Fable. Dependendo do plano e do tipo de assento, ele pode estar incluído, com um limite próprio, ou pode exigir créditos. Assento é a vaga de cada pessoa numa conta de equipe ou de empresa, e créditos são um saldo adicional, cobrado conforme o uso. Por isso, leia o que a sua conta informa antes de selecioná-lo.

Nomes, níveis de esforço e disponibilidade mudam. Então, em vez de decorar uma lista de hoje, vamos olhar o que aparece na conta usada nesta demonstração. Vou abrir o seletor, que é o menu em que se escolhe o modelo e o nível de esforço, e mostrar o que está listado: quais famílias aparecem e quais níveis de esforço existem.

Agora compare com a sua tela. Veja se as mesmas famílias estão lá, quais níveis de esforço você tem e se algum modelo traz um aviso de crédito. A sua lista pode ser diferente da minha, e isso é esperado. Para conferir o que vale hoje, consulte a referência atual da aula.

### m01-a05-b04 — Escolher modelo por um teste pequeno

Slide m01-a05-s04

Agora vamos escolher um modelo com um teste pequeno, em vez de escolher pelo nome. Abra o seletor e veja as opções realmente disponíveis. As famílias Fable, Opus, Sonnet e Haiku ajudam a localizar capacidades, mas o nome sozinho não basta para decidir.

Antes de testar, anote três informações: o modelo que você vai usar, o seu plano e a data de hoje. Não anote preço. Preços mudam, e o que vale é a página oficial de preços no dia em que você decidir.

Vamos usar duas tarefas em que já conhecemos a entrada. A primeira é classificar a lista do arquivo pedidos-demo.csv, que é uma planilha em texto simples, com uma regra explícita: separar pedidos aprovados e pendentes. A segunda é planejar um processo com informações faltando: transformar uma reunião em proposta comercial.

Comece pela classificação. A saída esperada já está definida, então use uma opção de menor consumo, execute e confira cada linha contra a regra. Se todas as linhas estiverem certas, essa opção atende a esta tarefa.

Agora o planejamento. Aqui existem decisões sobre escopo, acesso e aprovação que ainda não foram tomadas. Use uma opção mais capaz e avalie o resultado por um critério: ela identificou essas decisões e apontou o que está faltando? Um plano que apenas parece bom não responde a essa pergunta.

Você vai ouvir a regra “Fable ou Opus planeja, Opus ou Sonnet executa”. Trate-a como uma hipótese de trabalho, parecida com o ponto de partida que vimos há pouco. Ela não dispensa o teste e não obriga você a pagar por um modelo específico.

Sobre o Fable, a referência verificada em 2 de novembro de 2026 mostra condições de uso diferentes por plano e tipo de assento. Em alguns, está incluído com limite próprio; em outros, exige créditos. Antes de selecionar, leia o que a sua conta informa. E lembre que o resultado de um teste simples pode mostrar que o recurso já incluído atende ao seu processo.

Para fechar, escreva no arquivo comparacao-modelos.md uma frase com a sua decisão: qual modelo, para qual tarefa e por quê. O importante é ligar a escolha à tarefa, à qualidade que você observou e ao custo total de corrigir a saída, que inclui o tempo que você gasta revisando.

### m01-a05-b02 — Dois tipos de decisão

Slide m01-a05-s02

Os dois pedidos do teste mostram dois tipos de decisão. No primeiro, separar pedidos aprovados e pendentes de uma planilha, eu já defini a regra e a saída. Esse é um bom candidato a um recurso mais simples, com esforço baixo ou médio. No segundo, desenhar o processo que vai transformar uma reunião em proposta, com acesso a sistemas e aprovação, existem escolhas que precisam ser examinadas antes da execução. Ali vale testar mais capacidade.

Uma estratégia possível é planejar com mais capacidade e executar etapas claras com um recurso mais econômico. Mas essa é uma escolha de trabalho, não uma garantia de economia. Se a execução exigir muitas correções, a conta pode mudar.

Agora vamos localizar onde a ferramenta mostra o uso e os limites. No Claude Code, o ambiente de trabalho mais técnico da família Claude, quando o comando estiver disponível, digite /usage. Nas telas do Claude, procure Settings e, dentro dela, Usage. Ao abrir, cuide para não deixar visíveis na tela dados da conta, como e-mail, fatura ou cartão.

Nessa tela, diferencie três coisas. A primeira é o que está incluído na assinatura, que é o valor que você paga por período, com um limite de uso. A segunda é o consumo de API, que é quando um programa usa o modelo e você paga pelo volume usado, separadamente da assinatura. A terceira são os créditos adicionais, um saldo extra cobrado conforme o uso, que algumas contas oferecem. São regras de cobrança diferentes, então não compare um número com o outro como se fossem a mesma conta. E não ative uma cobrança extra sem entender qual é a regra e como acompanhar o gasto.

Pause o vídeo e faça isso na sua conta. Você terminou quando conseguir dizer duas coisas: onde vê o seu uso e qual cobrança vale para o recurso que escolheu.

### m01-a05-b05 — Esforço e limites sem confundir as contas

Slide m01-a05-s05

Agora vamos ao esforço e, depois, ao painel de uso.

Esforço é um orçamento de raciocínio: ajusta quanto o modelo pensa sobre a tarefa, dentro das opções daquele modelo. Como critério para começar, e não como regra do fornecedor: para uma tarefa bem definida, comece no padrão ou em médio; para algo simples, baixo pode bastar. Aumente quando encontrar um problema que merece mais análise, não apenas porque o nível alto está disponível.

Vamos fazer uma comparação controlada, passo a passo. Primeiro, escolha uma tarefa e fixe três coisas: a mesma entrada, a mesma regra e o mesmo formato de saída. Segundo, rode a tarefa com um nível de esforço. Terceiro, rode de novo com outro nível, sem mudar mais nada. Agora anote, no arquivo de comparação, se houve melhora, quanto tempo você esperou e quanto retrabalho foi necessário. Com um único exemplo, não dá para concluir que uma opção vence em tudo.

Agora abra o painel de uso da conta, de novo sem deixar à mostra dados de cobrança. Procure primeiro a janela de sessão, que é o período de uso que, em muitos planos, reinicia após cinco horas. Depois procure o limite semanal. Os dois são limites diferentes: o reinício de um não implica o reinício do outro. Há exceções por plano e conta. Em um plano Ultra verificado, por exemplo, pode não existir limite de cinco horas. Por isso, leia o painel atual em vez de supor.

O consumo das diferentes telas do Claude pode compartilhar o mesmo saldo. Abrir uma nova conversa não cria outra assinatura nem zera o que você já usou.

Por fim, localize os créditos adicionais, se a sua conta os oferece. Confira se estão ligados, qual é o limite de gasto que você definiu e qual regra de preço se aplica. Você pode ouvir que “crédito extra sempre custa três ou quatro vezes mais”. Essa frase não é uma comparação válida para todos os planos e tarefas, porque não há uma razão universal: o que vale é a regra da sua conta.

Registre na matriz de contas e custos o que você encontrou: limite de sessão, limite semanal e créditos. Se você consegue separar o modelo, o esforço, o saldo da assinatura e o crédito adicional, a atividade desta aula está cumprida.

### m01-a05-b06 — A conta do funcionário com números seus

Slide m01-a05-s06

Vamos usar uma conta hipotética para entender a comparação. Os números a seguir servem apenas para explicar o raciocínio. Se uma tarefa levava trinta minutos e, com a solução, passa a exigir dez minutos de revisão, há vinte minutos disponíveis por execução. Isso ainda não é lucro. Você precisa considerar a frequência, a qualidade e o custo de preparar e manter o processo.

A frequência muda o quadro. Se a tarefa acontece quatro vezes por mês, são oitenta minutos disponíveis por mês. Uma tarefa que acontece todos os dias é uma oportunidade bem diferente. E, se um erro tem consequência alta, a revisão pode continuar ocupando bastante tempo, e a diferença de vinte minutos encolhe.

Agora, o passo a passo no formulário de custo, que é a matriz de contas e custos. Primeiro, separe quatro linhas: assinatura, créditos, serviços externos e o seu tempo de supervisão. Serviços externos têm regras próprias. O WhatsApp oficial, por exemplo, cobra conforme a entrega da mensagem, a categoria e o mercado, com algumas isenções, e vamos tratar disso na aula certa. Segundo, calcule o tempo antes e depois, sem chamar o resultado de lucro. Terceiro, compare o valor do trabalho entregue com o que você soma nas quatro linhas.

Preencha primeiro com esta conta hipotética. Depois, troque pelos números seus e peça ao Claude que refaça o cálculo com eles. Confira a conta você mesmo, e não cole dados de cobrança ou de cartão na conversa.

Antes de mudar de plano, anote onde o atual deixou de atender: faltou recurso, faltou qualidade ou faltou capacidade de uso? São problemas diferentes. Um plano maior pode ampliar a capacidade, mas não corrige uma entrada errada. Registre esse motivo concreto na matriz. Também não existe razão para ativar cobrança extra só para terminar um exercício que pode esperar.

Ao final desta aula, quero que você saiba escolher um ponto de partida, observar o limite e explicar por que um gasto faz sentido para o seu processo.

### m01-a05-b03 — Usar a qualidade como critério

Slide m01-a05-s03

Depois de cada tarefa, faça três perguntas. O resultado ficou correto? Quanto retrabalho houve? O recurso usado fazia sentido para aquela dificuldade? Essa comparação é mais útil do que escolher um modelo só pelo nome.

Também não basta trocar o modelo se o pedido continua vago ou se a entrada está errada. Primeiro, deixe o objetivo verificável, isto é, descreva o que você vai conferir no resultado. Depois, ajuste a capacidade quando houver motivo.

Preços e disponibilidade mudam. Por isso, não vou citar tarifa fixa. Quando precisar decidir, abra o arquivo apoio/referencias.md, que reúne as páginas oficiais, e consulte o preço atual no dia da decisão.

Na próxima aula, vamos cuidar de três coisas que influenciam esse trabalho: o que a IA pode fazer, quais informações ela recebe e o que você precisa guardar para continuar depois.

# 1.5 — Modelos, esforço, planos e limites

ID m01-a05. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Dependências e ensaio:** Seletor, esforço e painel devem ser conferidos novamente na data da gravação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m01-a05-b01 | m01-a05-s01 / p. 1 | Abrir seletor de modelo e esforço da versão usada na gravação; registrar versão nas notas do professor. | Opções realmente disponíveis são mostradas, sem prometer modelos ausentes. |
| m01-a05-b04 | m01-a05-s04 / p. 2 | Abrir seletor atual e comparar classificação simples com planejamento do caso. | Escolha de modelo justificada pelo teste, com condição de crédito do Fable identificada. |
| m01-a05-b02 | m01-a05-s02 / p. 3 | Comparar uma classificação simples com o planejamento do caso comercial. Consultar uso sem expor dados de conta. | As duas saídas são comparadas por qualidade e necessidade; consumo é localizado. |
| m01-a05-b05 | m01-a05-s05 / p. 4 | Mostrar /usage ou Settings > Usage e registrar limite de sessão, semanal e créditos. | Aluno distingue modelo, esforço, saldo de assinatura e crédito adicional. |
| m01-a05-b06 | m01-a05-s06 / p. 5 | Preencher uma conta hipotética no formulário e depois pedir cálculo com dados do aluno. | Avaliação inclui frequência, qualidade e revisão; nenhum retorno financeiro é prometido. |
| m01-a05-b03 | m01-a05-s03 / p. 6 | Indicar apoio/referencias.md e orientar consulta de preço atual sem citar tarifa fixa. | Entrada controlada, resultado conferido, diferença de esforço descrita e consumo/custo corretamente separados. |

## m01-a05-b01 — Escolher recursos com intenção

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir seletor de modelo e esforço da versão usada na gravação; registrar versão nas notas do professor. | slides/m01-a05.pptx e slides/m01-a05.pdf, página 1, ID m01-a05-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a05-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a05-b01. Sem trilha prevista. |

**Estado inicial:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/matriz-contas-custos.md, apoio/comparacao-modelos.md

**Passos de captura:**
1. Abrir seletor de modelo e esforço da versão usada na gravação; registrar versão nas notas do professor.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Opções realmente disponíveis são mostradas, sem prometer modelos ausentes.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a05-b01; SHA-256 27216a09cb146bcc7b5f908a87d0c28cee18e792f88ef6484416524a83e8afce.

**Função visual:** Abrir seletor de modelo e esforço da versão usada na gravação; registrar versão nas notas do professor.


## m01-a05-b04 — Escolher modelo por um teste pequeno

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir seletor atual e comparar classificação simples com planejamento do caso. | slides/m01-a05.pptx e slides/m01-a05.pdf, página 2, ID m01-a05-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a05-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a05-b04. Sem trilha prevista. |

**Estado inicial:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/matriz-contas-custos.md, apoio/comparacao-modelos.md

**Passos de captura:**
1. Anotar modelo/plano/data sem preço fixo em fala.
2. Executar duas tarefas com entrada conhecida.
3. Conferir classificação e lacunas do plano.

**Saída e conferência:** Escolha de modelo justificada pelo teste, com condição de crédito do Fable identificada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a05-b04; SHA-256 a77a7ae34913eedd6e00b066f2496b13fed9e84ae891f3ce44705a5134c8efe1.

**Função visual:** Abrir seletor atual e comparar classificação simples com planejamento do caso.


## m01-a05-b02 — Dois tipos de decisão

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar uma classificação simples com o planejamento do caso comercial. Consultar uso sem expor dados de conta. | slides/m01-a05.pptx e slides/m01-a05.pdf, página 3, ID m01-a05-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a05-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a05-b02. Sem trilha prevista. |

**Estado inicial:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/matriz-contas-custos.md, apoio/comparacao-modelos.md

**Passos de captura:**
1. Comparar uma classificação simples com o planejamento do caso comercial. Consultar uso sem expor dados de conta.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** As duas saídas são comparadas por qualidade e necessidade; consumo é localizado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a05-b02; SHA-256 3625eec6a652e336bcaf8de627f388fbb09dfc245654d6eaea1ed3632fdeea22.

**Função visual:** Comparar uma classificação simples com o planejamento do caso comercial. Consultar uso sem expor dados de conta.


## m01-a05-b05 — Esforço e limites sem confundir as contas

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar /usage ou Settings > Usage e registrar limite de sessão, semanal e créditos. | slides/m01-a05.pptx e slides/m01-a05.pdf, página 4, ID m01-a05-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a05-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a05-b05. Sem trilha prevista. |

**Estado inicial:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/matriz-contas-custos.md, apoio/comparacao-modelos.md

**Passos de captura:**
1. Executar comparação de esforço com entrada idêntica.
2. Abrir painel de uso sem expor cobrança.
3. Distinguir os resets e localizar limite de gasto adicional.

**Saída e conferência:** Aluno distingue modelo, esforço, saldo de assinatura e crédito adicional.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a05-b05; SHA-256 b28311e3cfed30874ca1d07422c11948b9490f08f04fad4a74c426adb80b9648.

**Função visual:** Mostrar /usage ou Settings > Usage e registrar limite de sessão, semanal e créditos.


## m01-a05-b06 — A conta do funcionário com números seus

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Preencher uma conta hipotética no formulário e depois pedir cálculo com dados do aluno. | slides/m01-a05.pptx e slides/m01-a05.pdf, página 5, ID m01-a05-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a05-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a05-b06. Sem trilha prevista. |

**Estado inicial:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/matriz-contas-custos.md, apoio/comparacao-modelos.md

**Passos de captura:**
1. Separar custo de assinatura, créditos, serviços e supervisão.
2. Calcular tempo antes/depois sem chamar o resultado de lucro.
3. Registrar motivo concreto para eventual mudança de plano.

**Saída e conferência:** Avaliação inclui frequência, qualidade e revisão; nenhum retorno financeiro é prometido.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a05-b06; SHA-256 bbf63758259efd08717e5f0289156e95788bccca637203cc37b670092020a91d.

**Função visual:** Preencher uma conta hipotética no formulário e depois pedir cálculo com dados do aluno.


## m01-a05-b03 — Usar a qualidade como critério

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Indicar apoio/referencias.md e orientar consulta de preço atual sem citar tarifa fixa. | slides/m01-a05.pptx e slides/m01-a05.pdf, página 6, ID m01-a05-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a05-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a05-b03. Sem trilha prevista. |

**Estado inicial:** Preparar duas tarefas conhecidas, consulta ao painel de uso e formulário de custo sem dados de cobrança.

**Entrada/material:** apoio/pedidos-demo.csv, apoio/matriz-contas-custos.md, apoio/comparacao-modelos.md

**Passos de captura:**
1. Indicar apoio/referencias.md e orientar consulta de preço atual sem citar tarifa fixa.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Entrada controlada, resultado conferido, diferença de esforço descrita e consumo/custo corretamente separados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a05-b03; SHA-256 f69ee260ac324c2c9c7aad3ed4b307d26b19adbb19f5fc04965575efec132b19.

**Função visual:** Indicar apoio/referencias.md e orientar consulta de preço atual sem citar tarifa fixa.


## Atividade e solução

Comparar duas rodadas da mesma tarefa e preencher a matriz de custo e uso.

Entrada controlada, resultado conferido, diferença de esforço descrita e consumo/custo corretamente separados.

## Materiais

- pedidos-demo.csv
- matriz-contas-custos.md
- comparacao-modelos.md

# 1.6 — Permissões, memória e contexto / m01-a06

**Objetivo:** Controlar permissões, preparar memória/contexto útil e usar comandos e celular com entendimento do ambiente.

**Preparação:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Ensaio:** Controle remoto e telas de privacidade precisam de captura na conta e versão usadas na gravação.

### m01-a06-b01 — Dar autonomia com limites claros

Slide m01-a06-s01

Antes de deixar a IA executar uma tarefa, defina três coisas. Primeiro, o que ela pode acessar. Segundo, o que ela pode alterar. Terceiro, em que momento ela precisa parar e esperar a sua decisão. Essas três respostas formam o limite da tarefa, e é ele que permite dar autonomia sem perder o controle.

Esse limite muda conforme a tarefa. Se o trabalho ainda está mal definido, peça primeiro um plano, sem nenhuma alteração: a IA lê, analisa e propõe, e você decide se o caminho faz sentido. Se já existe uma etapa pequena e clara, você pode autorizar a execução só dentro dessa etapa, por exemplo, editar arquivos da pasta de teste. Compare os impactos. Mexer em um arquivo de exercício é muito diferente de enviar uma proposta a um cliente ou apagar uma base de dados. Por isso, quanto maior o impacto, mais cedo você quer ser consultado.

Na demonstração, vou usar uma tarefa de exercício para mostrar essas duas situações. Primeiro, peço à IA um plano de como organizar a lista de pedidos e deixo escrito que nada deve ser alterado. Depois, faço um segundo pedido, agora de edição, com o escopo escrito na própria mensagem: pode editar somente os arquivos da pasta de teste. Em seguida, abro o resultado e comparo com o critério da aula. A IA ficou dentro da pasta? Parou no ponto em que eu pedi?

Existem modos de permissão que ajudam a controlar esse comportamento, mas quem define o limite é o escopo que você escreve. O modo é uma configuração da ferramenta; o escopo é a sua instrução. Automático e bypass não são a mesma coisa. Bypass é o modo de contornar as perguntas de permissão, e o automático tem outra lógica. Por isso, confira na sua ferramenta o que cada um libera antes de ativar. Nenhum modo serve para toda situação. Se a dúvida é sobre uma ação importante, peça que a IA explique o que vai fazer antes de seguir.

O controle remoto é outro ponto de acesso. Ele permite continuar uma sessão a partir de outro aparelho, como o celular, e depende de ativação, de acesso à sua conta e do ambiente onde a sessão está rodando. Trate como um recurso específico, que você confere e liga por conta própria. Instalar o aplicativo no celular não liga esse recurso sozinho.

### m01-a06-b04 — Quatro modos e uma decisão concreta

Slide m01-a06-s04

Vamos olhar os modos de permissão com uma tarefa pequena. São quatro. No modo padrão, chamado de default em algumas telas, algumas ações pedem confirmação. Em aceitar edições, o acceptEdits, alterações de arquivo dentro das condições permitidas podem avançar com menos interrupções. Planejamento, ou plan, serve para entender e propor antes de executar alterações. E o automático, ou auto, avalia as ações e pode deixar avançar as que passam pelos controles disponíveis. Na demonstração, vou comparar esses modos no ambiente que estiver disponível para mim.

Os rótulos podem variar entre superfícies, mas a pergunta é sempre a mesma: o que esta sessão pode fazer e o que precisa de decisão minha? Automático não significa desligar todas as proteções, não é sinônimo de bypass e também não garante que a IA acerte. Regras da organização e restrições do ambiente continuam existindo.

Agora, o exercício, em três passos. No primeiro, peça um plano para organizar a lista de pedidos, o arquivo pedidos-demo.csv, que é uma planilha em texto simples, sem alterar arquivo. Leia o plano antes de seguir. No segundo, autorize criar um resumo apenas na pasta de saída. Aqui você define as três coisas do começo desta aula para uma ação concreta: o acesso é a lista de pedidos, a alteração é criar um arquivo novo de resumo, e o ponto de aprovação é a revisão do resultado. No terceiro passo, apresente uma ação com outro impacto: enviar a proposta para o cliente. Na gravação, eu só identifico essa ação como uma aprovação separada; não vou executá-la. A autorização de criar um arquivo não é autorização para enviar. Cada ação com um efeito diferente pede a sua própria decisão.

Quando ainda houver dúvida sobre uma consequência importante, esclareça o escopo antes de executar. Essa é a regra que fica no lugar do hábito de escolher automático sempre que bater a dúvida.

### m01-a06-b02 — Contexto, memória e arquivos

Slide m01-a06-s02

Contexto é o conjunto de informações que a IA tem disponível naquela tarefa: a conversa, os arquivos lidos e as ferramentas usadas. Memória persistida e arquivos de instrução são outro caminho, porque levam informações para trabalhos futuros. São coisas diferentes, e vale saber em qual delas cada informação está: se ela só vive na conversa de hoje ou se ficou escrita em um lugar que você pode abrir e revisar.

Dependendo da versão que você usa, existem comandos como /context e /compact. Aqui, comando é uma instrução curta, começada por barra, que você digita na caixa de conversa. O /context permite inspecionar o que está ocupando o contexto, e o /compact compacta a conversa atual, ou seja, resume o que já foi dito para liberar espaço. Os dois agem sobre a sessão em andamento. Eles não substituem escrever e revisar um arquivo com as decisões e as instruções do trabalho. A ferramenta pode manter registros internos da sessão, mas isso é diferente de uma instrução durável que você mesmo leu e aprovou. Por isso, mesmo usando esses comandos, as decisões importantes precisam estar em um arquivo seu.

No exemplo, vou usar um arquivo de contexto mínimo na pasta do exercício, o contexto-minimo.md. A terminação .md indica um arquivo de texto simples, que você abre em qualquer editor. Nele entra apenas o que ajuda o trabalho: qual é o processo, quais arquivos usamos, quais decisões já foram tomadas e o que falta. Para resumir uma reunião, a IA não precisa de mais do que isso. Os dados do exemplo são fictícios.

Se você vem do ChatGPT e tem lá informações úteis, daqui a pouco vamos ver como trazê-las com cuidado. Já adianto a regra: nada é importado automaticamente, e dados sensíveis ficam de fora.

Agora, uma pasta real do computador é diferente de um grupo de conversas na interface. Organizar chats em um grupo não prova que os arquivos foram colocados naquela pasta. Para conferir, abra o caminho no computador, pelo gerenciador de arquivos, e veja o que foi salvo. Na demonstração, vou mostrar os dois lados, o agrupamento na interface e o caminho real no disco, para você ver que são coisas separadas.

Conversas longas e muitas ferramentas carregadas aumentam o contexto. Existem cache e compactação, que ajudam a lidar com isso, mas eles não tornam todo o histórico gratuito, nem garantem que cada detalhe seja preservado. Decisões importantes ficam melhor em arquivos que você consegue revisar.

### m01-a06-b05 — Memória, privacidade e uma passagem de contexto

Slide m01-a06-s05

Se você já usa o ChatGPT, pode pedir lá um resumo das preferências e das informações úteis para o processo que vai estudar. Leia esse resumo antes de levar para outro ambiente. Retire senhas, tokens, que são chaves de acesso a um serviço, dados de clientes e qualquer informação que não ajude aquela tarefa. Transferir tudo aumenta o risco e pode aumentar a confusão. Na demonstração, uso o contexto-minimo.md com dados fictícios.

Transforme o que for durável em instruções curtas: objetivo do projeto, arquivos de referência, critérios e decisões. No Claude Code, o CLAUDE.md é um dos arquivos usados para orientar o trabalho. Memória e instruções persistentes não são a mesma coisa que todo o histórico da conversa, e o que você disse numa conversa não vira memória garantida. Por isso, abra o arquivo salvo para conferir o que ficou registrado e separe o que está guardado do que só existe na conversa.

Agora, a privacidade. Nas configurações, procure o controle de melhoria do modelo e confira como ele se aplica ao seu plano. Desligar o uso para melhoria, quando disponível, é diferente de apagar histórico ou de revogar o acesso a uma ferramenta; são ajustes separados. Contas de empresa podem ter políticas próprias, então verifique também a política da sua conta. Faça o ajuste adequado antes de usar dados de trabalho e continue enviando somente o necessário. Na gravação, mostro esses controles sem expor nenhuma conta pessoal.

Para terminar este bloco, prepare uma passagem de contexto, um texto curto com cinco itens: objetivo, estado atual, decisões, arquivos e próximo passo. Abra uma conversa de teste, vazia, cole esse texto e peça para a IA explicar o que entendeu. Compare a explicação com o que você queria. Se ela perdeu uma decisão importante, corrija o arquivo e teste de novo. O resultado esperado é uma retomada que preserva o objetivo e as decisões, sem levar informação sensível. É a conferência do conteúdo que torna a retomada útil.

### m01-a06-b06 — Comandos, controle remoto e missão do módulo

Slide m01-a06-s06

Abra a ajuda, digitando /help, para ver os comandos disponíveis na sua versão. Depois, consulte alguns deles. Use /model para localizar a escolha de modelo; /usage para acompanhar os limites de uso; /permissions para revisar as permissões; /context para entender a ocupação; e /compact quando precisar resumir o contexto da sessão. O efeito de compactar não é guardar todos os detalhes para sempre, por isso as decisões importantes ficam em arquivos revisados.

O contexto combina instruções, conversa, arquivos e resultados de ferramentas, e tem um limite. Cache e compactação mudam a forma como esse material é tratado. Cache, em linhas gerais, é um jeito de reaproveitar material já enviado. Por isso, não é correto imaginar que cada mensagem necessariamente cobra todos os bytes de toda a conversa pelo mesmo preço. Para trabalhar melhor, mantenha a entrada relevante e registre as decisões duráveis.

Agora, o controle remoto. Em uma sessão local compatível, o comando /remote-control permite continuar a interação pelo navegador ou pelo celular. A execução permanece no seu computador: ele precisa ficar ligado e o processo precisa continuar ativo. Isso é diferente de uma sessão em nuvem, que roda em outro ambiente, com outros arquivos. O controle remoto, por si só, não leva seus arquivos nem a execução para a nuvem. Na demonstração, se o recurso estiver disponível na conta e na versão que uso, inicio o controle remoto em uma sessão de teste e conecto o celular na mesma conta, sem mostrar dados de acesso. Depois, encerro a sessão remota e registro a condição: o computador precisou ficar ligado durante todo o uso.

A missão do módulo tem duas partes. A primeira é explorar as configurações, e a segunda é instalar o app oficial no celular. Confirme a conta, abra uma conversa fictícia e, se tiver acesso ao controle remoto, ensaie com a pasta de exercício. Feche o acesso quando terminar. Você conclui esta parte quando consegue retomar o processo, apontar seus arquivos e explicar o limite de autorização.

### m01-a06-b03 — Continuar sem recomeçar tudo

Slide m01-a06-s03

Quando for retomar um trabalho, informe quatro coisas: o objetivo, o estado atual, os arquivos relevantes e o próximo passo. Se pedir um resumo de passagem para abrir uma nova conversa, abra o arquivo e confira se ele guardou as decisões que realmente importam antes de seguir. Na demonstração, peço esse resumo com objetivo, decisões, arquivos e próximo passo, e leio o arquivo antes de abrir a nova conversa.

Para fechar a visita às configurações, veja quais controles de privacidade existem na sua conta e o que cada um permite. Em seguida, instale o aplicativo no celular. Senhas e tokens não entram na conversa, porque uma configuração depois não resolve esse problema: o dado já foi enviado.

Juntando tudo, a missão deste módulo é deixar uma pasta de exercício funcionando e escrever um contexto mínimo do processo que você escolheu. Ao final, você deve conseguir explicar o que entra, o que deve sair e em que ponto precisa de uma decisão sua.

Agora vamos transformar uma parte desse processo em uma skill.

# 1.6 — Permissões, memória e contexto

ID m01-a06. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Dependências e ensaio:** Controle remoto e telas de privacidade precisam de captura na conta e versão usadas na gravação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m01-a06-b01 | m01-a06-s01 / p. 1 | Mostrar uma tarefa de exercício em modo de planejamento e um pedido de edição limitado à pasta de teste. | Planejamento e alteração autorizada são diferenciados; somente o escopo previsto é alterado. |
| m01-a06-b04 | m01-a06-s04 / p. 2 | Comparar plan/default/acceptEdits/auto no ambiente disponível e separar criar arquivo de enviar proposta. | Aluno define acesso, alteração e ponto de aprovação para uma ação concreta. |
| m01-a06-b02 | m01-a06-s02 / p. 3 | Usar um arquivo de contexto mínimo na pasta do exercício. Mostrar a diferença entre agrupamento da interface e caminho real no disco. | Aluno localiza o arquivo real e distingue contexto, memória, agrupamento e persistência. |
| m01-a06-b05 | m01-a06-s05 / p. 4 | Escrever contexto mínimo e mostrar controles de privacidade sem expor conta pessoal. | Retomada preserva objetivo/decisões sem transportar informação sensível. |
| m01-a06-b06 | m01-a06-s06 / p. 5 | Usar comandos de inspeção e demonstrar Remote Control apenas numa sessão de teste. | Missão inclui configurações e celular; execução remota/local distinguida e sessão encerrada. |
| m01-a06-b03 | m01-a06-s03 / p. 6 | Pedir um resumo de passagem com objetivo, decisões, arquivos e próximo passo. Conferir o arquivo antes de abrir nova conversa. | Objetivo e decisões preservados, permissões limitadas à tarefa, privacidade localizada e condição do Remote Control explicada. |

## m01-a06-b01 — Dar autonomia com limites claros

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar uma tarefa de exercício em modo de planejamento e um pedido de edição limitado à pasta de teste. | slides/m01-a06.pptx e slides/m01-a06.pdf, página 1, ID m01-a06-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a06-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a06-b01. Sem trilha prevista. |

**Estado inicial:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Entrada/material:** apoio/contexto-minimo.md, apoio/setup-completo.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Mostrar uma tarefa de exercício em modo de planejamento e um pedido de edição limitado à pasta de teste.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Planejamento e alteração autorizada são diferenciados; somente o escopo previsto é alterado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a06-b01; SHA-256 1e35883919f60cd793ab0fb8c2b3b8218b3b1af59e07a340019950eccce0f8dc.

**Função visual:** Mostrar uma tarefa de exercício em modo de planejamento e um pedido de edição limitado à pasta de teste.


## m01-a06-b04 — Quatro modos e uma decisão concreta

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar plan/default/acceptEdits/auto no ambiente disponível e separar criar arquivo de enviar proposta. | slides/m01-a06.pptx e slides/m01-a06.pdf, página 2, ID m01-a06-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a06-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a06-b04. Sem trilha prevista. |

**Estado inicial:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Entrada/material:** apoio/contexto-minimo.md, apoio/setup-completo.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Pedir plano sem alterações.
2. Autorizar arquivo apenas na pasta de teste.
3. Identificar envio externo como aprovação separada; não executar.

**Saída e conferência:** Aluno define acesso, alteração e ponto de aprovação para uma ação concreta.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a06-b04; SHA-256 903d6b27e0fb7969586d061e2ec5877a12677f4d38ce723ea573a0abda178e17.

**Função visual:** Comparar plan/default/acceptEdits/auto no ambiente disponível e separar criar arquivo de enviar proposta.


## m01-a06-b02 — Contexto, memória e arquivos

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar um arquivo de contexto mínimo na pasta do exercício. Mostrar a diferença entre agrupamento da interface e caminho real no disco. | slides/m01-a06.pptx e slides/m01-a06.pdf, página 3, ID m01-a06-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a06-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a06-b02. Sem trilha prevista. |

**Estado inicial:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Entrada/material:** apoio/contexto-minimo.md, apoio/setup-completo.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Usar um arquivo de contexto mínimo na pasta do exercício. Mostrar a diferença entre agrupamento da interface e caminho real no disco.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Aluno localiza o arquivo real e distingue contexto, memória, agrupamento e persistência.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a06-b02; SHA-256 ba714aa10e321ab074e3d5fbd5d292ff7c47649cde531f390536d556f17fdc6a.

**Função visual:** Usar um arquivo de contexto mínimo na pasta do exercício. Mostrar a diferença entre agrupamento da interface e caminho real no disco.


## m01-a06-b05 — Memória, privacidade e uma passagem de contexto

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Escrever contexto mínimo e mostrar controles de privacidade sem expor conta pessoal. | slides/m01-a06.pptx e slides/m01-a06.pdf, página 4, ID m01-a06-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a06-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a06-b05. Sem trilha prevista. |

**Estado inicial:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Entrada/material:** apoio/contexto-minimo.md, apoio/setup-completo.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Usar contexto-minimo.md com dados fictícios.
2. Conferir o que é persistido e o que só está na conversa.
3. Localizar controle de melhoria de modelo e política da conta.
4. Testar retomada em conversa vazia.

**Saída e conferência:** Retomada preserva objetivo/decisões sem transportar informação sensível.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a06-b05; SHA-256 3ea91124c0830a5a6e368794e0cc529c2cf4fd3c44c21d3ba3983007ed6a4612.

**Função visual:** Escrever contexto mínimo e mostrar controles de privacidade sem expor conta pessoal.


## m01-a06-b06 — Comandos, controle remoto e missão do módulo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar comandos de inspeção e demonstrar Remote Control apenas numa sessão de teste. | slides/m01-a06.pptx e slides/m01-a06.pdf, página 5, ID m01-a06-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a06-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a06-b06. Sem trilha prevista. |

**Estado inicial:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Entrada/material:** apoio/contexto-minimo.md, apoio/setup-completo.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Abrir /help e conferir comandos da versão.
2. Consultar uso, contexto e permissões.
3. Se disponível, iniciar /remote-control e conectar celular na mesma conta.
4. Encerrar sessão remota e registrar condição de máquina ligada.

**Saída e conferência:** Missão inclui configurações e celular; execução remota/local distinguida e sessão encerrada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a06-b06; SHA-256 0037860d04c8d1b7ca7aa21fc3595e30541fc8fd341401c6dd0f9631569c61e6.

**Função visual:** Usar comandos de inspeção e demonstrar Remote Control apenas numa sessão de teste.


## m01-a06-b03 — Continuar sem recomeçar tudo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Pedir um resumo de passagem com objetivo, decisões, arquivos e próximo passo. Conferir o arquivo antes de abrir nova conversa. | slides/m01-a06.pptx e slides/m01-a06.pdf, página 6, ID m01-a06-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m01-a06-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m01-a06-b03. Sem trilha prevista. |

**Estado inicial:** Usar conta de exercício, arquivo mínimo e celular do professor; não mostrar dados de autenticação ou QR de acesso.

**Entrada/material:** apoio/contexto-minimo.md, apoio/setup-completo.md, apoio/pedidos-demo.csv

**Passos de captura:**
1. Pedir um resumo de passagem com objetivo, decisões, arquivos e próximo passo. Conferir o arquivo antes de abrir nova conversa.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Objetivo e decisões preservados, permissões limitadas à tarefa, privacidade localizada e condição do Remote Control explicada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m01-a06-b03; SHA-256 64bdf4fca74e0f910de1841dd1233602b63f5b0553036023e13be15be7a1a08e.

**Função visual:** Pedir um resumo de passagem com objetivo, decisões, arquivos e próximo passo. Conferir o arquivo antes de abrir nova conversa.


## Atividade e solução

Criar contexto mínimo, testar retomada, localizar privacidade e instalar o app móvel; ensaiar controle remoto se disponível.

Objetivo e decisões preservados, permissões limitadas à tarefa, privacidade localizada e condição do Remote Control explicada.

## Materiais

- contexto-minimo.md
- setup-completo.md
- pedidos-demo.csv

# 2.1 — O que é uma skill + banco de skills prontas / m02-a01

**Objetivo:** Encontrar, inspecionar e instalar uma skill no escopo correto, com teste de comportamento.

**Preparação:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Ensaio:** Instalação e execução da skill de catálogo devem ser ensaiadas na versão escolhida.

### m02-a01-b01 — Um procedimento que você não precisa repetir

Slide m02-a01-s01

Se você explica a mesma tarefa a cada nova conversa com a IA, essa explicação pode virar uma skill.

Uma skill é uma pasta com as instruções de um procedimento e, quando necessário, arquivos de apoio. O arquivo principal dessa pasta se chama SKILL.md. Nele, a skill pode dizer quando deve ser usada, que entrada precisa receber, quais critérios seguir e como entregar o resultado. Com isso, o agente, que é o assistente de IA que executa a tarefa para você, reconhece o pedido e parte de um padrão, em vez de começar do zero. A variação diminui, mas o resultado continua pedindo a sua conferência.

Pense num resumo de reunião. “Faça um resumo bom” deixa muita coisa em aberto. O que é importante? A decisão aparece junto de quem ficou responsável? Como registrar um prazo que ninguém definiu? Uma skill útil responde a essas perguntas antes da execução.

O caminho desta aula tem quatro passos: encontrar uma skill pronta, inspecionar antes de instalar, instalar só uma, no lugar certo, e testar com uma entrada de exemplo. Para começar, veja na tela a pasta e o arquivo de uma skill de exemplo, o skill-resumo-exemplo.md. Ele serve apenas como material didático, para mostrar a forma que uma skill tem por dentro.

### m02-a01-b04 — Procurar e inspecionar antes de instalar

Slide m02-a01-s04

Agora vamos procurar uma opção pronta. Abra skills.sh, com esse s no final de skills. É um diretório, isto é, uma lista de skills publicadas por outras pessoas. Procure uma tarefa, como trabalhar com documentos, em vez de procurar uma skill que prometa fazer tudo. Vamos escolher uma opção e seguir até o repositório de origem, que é o lugar onde o projeto está publicado, com todos os arquivos. O diretório ajuda a descobrir; a origem mostra o que você está instalando.

No repositório, abra o SKILL.md. Peça ao Claude para ler esse arquivo e explicar a entrada, o procedimento e a saída. Depois peça para apontar scripts, dependências, acesso à rede e instruções de instalação. Script é um arquivo de comandos que o computador executa. Dependência é outro programa ou pacote de que a skill precisa para funcionar. Compare a explicação do Claude com os arquivos. Um script pode fazer mais do que o nome sugere, então não execute só porque apareceu uma recomendação bem escrita.

Veja também quem mantém o projeto, quando ele mudou pela última vez e qual é a licença, que define em que condições você pode usar o material. Número de instalações, estrelas e análises do diretório ajudam a orientar a investigação, mas nenhum deles garante que a skill seja segura ou adequada ao seu processo. Se aparecer selo ou auditoria, leia o que foi avaliado. Uma inspeção automática pode ter escopo limitado.

Vá registrando tudo no arquivo ficha-inspecao-skill.md, antes de instalar: a tarefa, a origem, os riscos concretos que você encontrou e como pretende testar. Para começar, prefira uma tarefa pequena, uma fonte identificável e uma instalação que você consiga remover. Anote também o repositório e a versão, ou o commit, usados no exercício. O commit é o registro de uma versão específica do projeto, e permite que você volte a olhar exatamente o que usou.

### m02-a01-b02 — Encontrar e inspecionar uma opção

Slide m02-a01-s02

Com a ficha em andamento, falta decidir qual opção seguir. O objetivo desta aula é aprender a escolher e instalar uma só skill. Escolha uma compatível com o exemplo do resumo de reunião e releia, na ficha, de onde ela vem, o que ela orienta e quais recursos usa. Ela executa scripts? Acessa a rede? Depende de uma conta ou de outra ferramenta? O nome e o número de instalações não respondem a nada disso. Popularidade não é garantia de confiança.

Pode acontecer de a skill vir dentro de um plugin. Plugin é um pacote que pode reunir skills, conexões com serviços e outros recursos. Instalar um plugin não significa que você autorizou o acesso a um serviço: essa autorização é um passo à parte, e vale conceder só o acesso de que a tarefa precisa.

Depois, escolha o escopo, que é o alcance da instalação. Dependendo do agente e do local de instalação, a skill fica restrita a um projeto ou disponível em outros trabalhos. Para um procedimento específico de um cliente, comece pelo projeto: fica mais fácil de organizar. Para algo de uso frequente, vale avaliar uma instalação mais ampla, depois de testar no projeto.

Depois de instalar, vamos conferir a pasta e o arquivo SKILL.md e ver se o agente reconhece a skill. Isso mostra que ela está instalada e visível. O teste só termina quando executamos uma entrada de exemplo.

### m02-a01-b05 — Projeto e instalação global na prática

Slide m02-a01-s05

Vamos instalar somente a skill escolhida no projeto de exercício. A documentação atual da CLI skills usa o comando npx skills add com a origem do repositório. CLI é uma ferramenta que você usa digitando comandos. Você pode pedir ao Claude para preparar o comando com a origem, o nome da skill e o agente que está usando. Leia a seleção antes de executar. Se o Claude pedir permissão para rodar o comando, confira se ele corresponde ao que você preparou e só então aprove. Instalar uma coleção inteira torna mais difícil entender o que entrou.

Por padrão, essa CLI instala no projeto. Por isso, no primeiro ensaio, vamos rodar sem a opção -g. A opção global, o -g, amplia a disponibilidade para outros projetos do usuário. No Claude Code, confira a pasta de skills do projeto, que é .claude/skills, e a pasta de skills do usuário. Em outros agentes, o caminho pode mudar: o Codex, por exemplo, também lê a pasta .agents/skills. Não confunda uma pasta que apenas guarda arquivos de referência com uma pasta que o agente realmente descobre.

Organize o exercício com entrada, saída e procedimento em lugares claros: onde fica o arquivo que a skill vai ler, onde a saída será salva e onde está a skill. Depois da instalação, peça ao Claude para localizar a skill e explicar quando ela deve ser usada. Se não aparecer, confira o agente escolhido, o escopo, a estrutura da pasta e se a sessão precisa ser reiniciada ou atualizada para descobrir a skill nova. Só então execute uma entrada fictícia. Ver a skill listada pelo agente prova que ela foi descoberta; abrir e conferir a entrega é o teste do comportamento. Guarde também como desabilitar ou remover a instalação, para voltar ao estado anterior se necessário.

### m02-a01-b06 — Um manual com critérios e limites

Slide m02-a01-s06

Olhe novamente para o resumo de reunião. Uma instrução como “faça um bom resumo” não diz o que bom significa. O manual precisa tornar essa expectativa observável: separar decisões de sugestões, preservar responsáveis e registrar ausência de prazo.

Agora imagine duas skills com o mesmo nome. Uma exige inventar uma prioridade para toda ação; outra permite marcar prioridade não definida. Qual serve ao seu processo? Depende do que você precisa decidir e do que a entrada informa. É por isso que a inspeção não termina na confiança do autor. Você também avalia se a skill se adequa ao seu trabalho.

Para isso, monte dois testes para a skill escolhida e escreva o resultado esperado antes de rodar. O primeiro usa uma entrada normal, como uma reunião com decisões, responsáveis e prazos claros. O segundo usa uma entrada incompleta, como uma reunião em que ninguém definiu o prazo. Os materiais da aula trazem dois arquivos fictícios, conversa-demo.txt e conversa-incompleta.txt, que você pode usar nesses papéis. Para cada teste, defina duas condições de aceite e uma condição de falha. Por exemplo: aceite, se as decisões vierem separadas das sugestões e se cada responsável for preservado; falha, se a skill inventar um prazo que ninguém combinou.

Depois de rodar, abra a saída e compare com essas condições, não só com a aparência do texto. Registre a entrada, a expectativa, a saída observada e a decisão: manter, ajustar ou remover a skill. Se o teste falhar, guarde a saída e a regra que não foi atendida. Você pode corrigir o procedimento, escolher outra skill ou concluir que a tarefa precisa de uma ferramenta adicional. Uma boa seleção inclui a capacidade de dizer “esta opção não serve para este caso”.

### m02-a01-b03 — O que precisa ficar claro

Slide m02-a01-s03

Para fechar, vale ter à mão um roteiro de leitura que serve para qualquer skill. Ao ler uma, procure quatro coisas. O nome identifica a skill. A descrição ajuda o agente a perceber quando usá-la. O corpo apresenta o procedimento. E os arquivos extras, se existirem, guardam exemplos, referências ou scripts, quando a tarefa realmente precisa deles.

Uma pasta cheia não é melhor por isso. O que importa é se o material ajuda a executar a tarefa sem deixar decisões importantes ao acaso.

Agora é com você. A atividade desta aula reúne tudo o que vimos, e as orientações estão no arquivo exercicios.md, na pasta de apoio. Pause o vídeo, escolha uma skill relacionada ao processo que você anotou nas aulas anteriores e explique, com suas palavras, o que ela recebe e o que entrega. Se, lendo o material, você não consegue responder, ainda falta clareza. E isso vem antes de instalar. Em seguida, preencha a ficha de inspeção, instale só essa skill e teste uma entrada normal e outra incompleta.

Você terminou quando a origem e o escopo estiverem documentados, quando a entrega observada tiver sido comparada com os critérios que você definiu antes de rodar, e quando a decisão não tiver se apoiado em popularidade.

Na próxima aula, vamos experimentar opções prontas, ver o que acontece quando uma skill pronta encontra uma necessidade específica e comparar o seu diagnóstico de hoje com o resultado real.

# 2.1 — O que é uma skill + banco de skills prontas

ID m02-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Dependências e ensaio:** Instalação e execução da skill de catálogo devem ser ensaiadas na versão escolhida.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m02-a01-b01 | m02-a01-s01 / p. 1 | Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático. | Pasta e SKILL.md são localizados e sua finalidade é explicada. |
| m02-a01-b04 | m02-a01-s04 / p. 2 | Inspecionar uma skill de documentos no diretório e no repositório de origem. | Ficha identifica tarefa, origem, riscos concretos e critérios de teste. |
| m02-a01-b02 | m02-a01-s02 / p. 3 | Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio. | Origem e dependências são lidas antes da instalação; caminho instalado é conferido. |
| m02-a01-b05 | m02-a01-s05 / p. 4 | Instalar uma única skill no projeto e conferir pasta, descoberta e saída. | Skill correta instalada no escopo escolhido e saída conferida; sem instalação indiscriminada. |
| m02-a01-b06 | m02-a01-s06 / p. 5 | Montar dois testes para a skill escolhida e registrar resultado esperado antes de rodar. | Teste contém entrada, expectativa, saída observada e decisão de manter/ajustar/remover. |
| m02-a01-b03 | m02-a01-s03 / p. 6 | Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md. | Origem e escopo documentados; entrega observada confrontada com critérios prévios; popularidade não usada como certificado. |

## m02-a01-b01 — Um procedimento que você não precisa repetir

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 1, ID m02-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b01. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Pasta e SKILL.md são localizados e sua finalidade é explicada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b01; SHA-256 16a9fce770819d95c6044f00205f023a296ca0692a650ac801400c0e6ce0743b.

**Função visual:** Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático.


## m02-a01-b04 — Procurar e inspecionar antes de instalar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Inspecionar uma skill de documentos no diretório e no repositório de origem. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 2, ID m02-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b04. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Pesquisar em skills.sh e abrir origem.
2. Ler SKILL.md, scripts, dependências e licença.
3. Preencher ficha-inspecao-skill.md antes de instalar.

**Saída e conferência:** Ficha identifica tarefa, origem, riscos concretos e critérios de teste.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b04; SHA-256 fabc162f242a573166c3fde9d014cc8b3becf9d9ec74921cc09264f558577010.

**Função visual:** Inspecionar uma skill de documentos no diretório e no repositório de origem.


## m02-a01-b02 — Encontrar e inspecionar uma opção

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 3, ID m02-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b02. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Origem e dependências são lidas antes da instalação; caminho instalado é conferido.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b02; SHA-256 c64ea71fe6bd6fb62c5d4ec9d0848c66ebbe820056cfa006b665e5cdba074404.

**Função visual:** Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio.


## m02-a01-b05 — Projeto e instalação global na prática

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Instalar uma única skill no projeto e conferir pasta, descoberta e saída. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 4, ID m02-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b05. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Preparar comando com origem/skill/agente explícitos.
2. Instalar no projeto, sem -g no primeiro ensaio.
3. Conferir diretório real e descoberta numa sessão de exercício.
4. Executar entrada fictícia e abrir saída.

**Saída e conferência:** Skill correta instalada no escopo escolhido e saída conferida; sem instalação indiscriminada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b05; SHA-256 9d51aea5977a5afe6eaffb68811bf7dfe269ad367169f5c4e5e5a79d2ee7c346.

**Função visual:** Instalar uma única skill no projeto e conferir pasta, descoberta e saída.


## m02-a01-b06 — Um manual com critérios e limites

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Montar dois testes para a skill escolhida e registrar resultado esperado antes de rodar. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 5, ID m02-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b06. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Escrever entrada normal e incompleta.
2. Definir duas condições de aceite e uma condição de falha.
3. Comparar a entrega com essas condições, não só com aparência.

**Saída e conferência:** Teste contém entrada, expectativa, saída observada e decisão de manter/ajustar/remover.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b06; SHA-256 61f5374e780966d497667beee62d37b97865bb9395cfc7640254500eac7ac94b.

**Função visual:** Montar dois testes para a skill escolhida e registrar resultado esperado antes de rodar.


## m02-a01-b03 — O que precisa ficar claro

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 6, ID m02-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b03. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Origem e escopo documentados; entrega observada confrontada com critérios prévios; popularidade não usada como certificado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b03; SHA-256 7e5cc5c7a4b56f48054e53f91322022ab6bcecb7d6ae8e2235342334cb842be6.

**Função visual:** Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md.


## Atividade e solução

Escolher uma skill, preencher a inspeção, instalar só ela e testar uma entrada normal e outra incompleta.

Origem e escopo documentados; entrega observada confrontada com critérios prévios; popularidade não usada como certificado.

## Materiais

- ficha-inspecao-skill.md
- skill-resumo-exemplo.md
- conversa-demo.txt
- conversa-incompleta.txt

# 2.2 — Explorando skills prontas / m02-a02

**Objetivo:** Testar mais de uma skill pronta e executar uma adaptação com comparação controlada.

**Preparação:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Ensaio:** Ensaiar geração e abertura de ambos os formatos no ambiente da aula.

### m02-a02-b01 — Testar com uma entrada conhecida

Slide m02-a02-s01

Uma skill pode parecer ótima na descrição e, mesmo assim, não servir para o seu trabalho. Skill, aqui, é uma pasta com um arquivo de instruções escrito em texto, que o agente segue para fazer um tipo de tarefa, como resumir uma conversa. Para descobrir se uma skill serve, use uma entrada que você já conhece e compare o resultado com um critério claro.

Neste exercício, a entrada é uma conversa fictícia e curta, que está no arquivo conversa-demo.txt, na pasta de apoio. Abra esse arquivo e leia com calma. Nele existem quatro elementos que eu conheço de antemão: uma decisão, uma pessoa responsável, uma pendência e um prazo que ninguém definiu. Como sei o que está no texto, consigo conferir se o resumo manteve cada um deles.

Antes de executar qualquer coisa, escreva o que você espera encontrar no resultado. Por exemplo: qual é a decisão, quem é o responsável e que o prazo não foi informado. Assim você não avalia só pela aparência ou pelo tamanho da resposta. Um resumo bem organizado ainda pode omitir uma decisão ou transformar uma sugestão em compromisso.

E use sempre esta mesma conversa, em todas as comparações. Se a entrada muda, você deixa de saber o que causou a diferença. Por isso, deixe o arquivo original como está e trabalhe só na pasta de exercício.

### m02-a02-b04 — Duas skills prontas, duas entregas verificáveis

Slide m02-a02-s04

Vamos experimentar duas opções concretas do repositório de skills da Anthropic. Repositório é o espaço público onde ficam as pastas das skills. As duas opções são PDF e DOCX, que é o formato dos documentos do Word, quando estiverem disponíveis para o agente usado no exercício.

Antes de instalar, inspecione. Abra o arquivo de instruções de cada skill, o SKILL.md, e olhe também os scripts, que são pequenos programas que ela pode executar. Veja as dependências, ou seja, o que precisa existir no computador para ela funcionar, e as permissões que ela pede. Anote tudo na ficha de inspeção. Muitas instalações ou estrelas indicam popularidade, não segurança. E instale só essas duas skills, escolhendo o agente que você usa, sem baixar a coleção inteira. O nome do formato também não garante que todos os recursos funcionem em toda superfície.

Vamos usar a mesma conversa fictícia como conteúdo. Na primeira rodada, o pedido é produzir um documento de resumo em DOCX. Na segunda, gerar uma versão PDF com as mesmas informações. Peça que os dois arquivos sejam salvos na pasta de exercício. O procedimento de resumo define o que extrair; a skill do formato ajuda a construir o arquivo. São responsabilidades diferentes, mesmo quando o pedido reúne as duas.

Agora abra os arquivos fora da conversa, no aplicativo que abre cada formato. No DOCX, confira se o texto é editável e se os títulos e listas ficaram legíveis. No PDF, percorra todas as páginas e procure cortes e quebras estranhas. Nos dois, compare os fatos com o que você escreveu antes: decisão, responsável, pendência e prazo ausente. Um arquivo bonito com uma decisão inventada continua errado.

Se a sua conta não oferece essa skill, use a inspeção para identificar o recurso que falta e procure uma instalação compatível. Não marque o teste como concluído só porque a ferramenta descreveu como faria. O teste só vale quando o arquivo real foi aberto e conferido.

### m02-a02-b02 — Um ajuste que tem motivo

Slide m02-a02-s02

Agora vamos executar a skill de resumo com a conversa e conferir o resultado com quatro perguntas, que estão no arquivo de critérios do resumo. A decisão apareceu? O responsável é a pessoa certa? A pendência continua como pendência? E o prazo, que ninguém definiu, aparece como não informado, e não como uma data inventada?

Se alguma resposta for não, olhe o procedimento da skill, porque é nele que está a causa. Por exemplo: uma skill que ordena tudo por urgência, sem explicar o que é urgente, deixa a escolha escondida dentro do procedimento. No nosso trabalho, pode ser mais útil separar decisões, ações e perguntas abertas. Esse tipo de ajuste muda a utilidade da saída.

Antes de alterar, guarde uma cópia do procedimento original. Se o resultado piorar, você compara e volta para a regra anterior.

Depois mude um critério por vez e repita o teste com a mesma conversa. Assim você liga a mudança à diferença no resultado. Se trocar a entrada, o formato e a regra ao mesmo tempo, não dá para saber o que melhorou. No próximo bloco, o critério que vamos mudar é o do responsável.

### m02-a02-b05 — Comparar sem trocar todas as variáveis

Slide m02-a02-s05

Agora vamos olhar para uma adaptação de processo, além do formato. Uma skill genérica pode organizar o resumo por assunto; no seu trabalho, talvez seja essencial destacar ações com responsável. Não precisamos reescrever tudo para testar essa mudança.

Guarde a versão original. Depois faça uma cópia dentro da pasta de exercício e trabalhe só nela. Nessa cópia, acrescente uma regra, escrita em português, como em qualquer texto: toda ação deve trazer responsável explícito ou a indicação de que ele não foi informado. Mantenha a mesma conversa e o mesmo formato de saída. Execute novamente e compare. Se a primeira versão deixou uma ação sem responsável e a segunda marcou a ausência corretamente, temos uma diferença observável ligada à regra.

Depois use a conversa incompleta, que é a versão do texto em que falta alguma informação, como o responsável por uma ação. Essa segunda rodada evita aceitar uma mudança que só funciona no exemplo que inspirou a correção. Aqui o resultado certo é a ausência indicada, sem nome inventado.

Registre os dois resultados no registro de testes. O objetivo não é provar que a skill ficou perfeita: é mostrar o caminho de adaptar, testar e conferir. Você passa a ter um procedimento que pode evoluir com seu trabalho, em vez de depender de uma avaliação vaga como “parece melhor”.

### m02-a02-b06 — Decidir o que aproveitar e o que criar

Slide m02-a02-s06

Depois dos testes, separe três coisas. O que a skill pronta faz bem? O que depende de um critério específico da sua empresa? E o que exige um acesso que ainda não existe? Essa separação ajuda a decidir o próximo passo.

No nosso exemplo, construir um DOCX editável pode ser um recurso genérico útil. Já decidir o que entra numa proposta, de onde vem o preço e quando parar para aprovação é processo da empresa. Não esperamos que uma skill pública conheça essas regras sem receber referência.

O acesso a um serviço externo é outra coisa. Instalar uma skill não dá, por si só, permissão para usar um serviço da sua empresa. Essa permissão vem de uma conexão específica, que você autoriza, só com o que for necessário. E qualquer envio para fora, como mandar a proposta a um cliente, continua dependendo da aprovação de uma pessoa.

Agora preencha a decisão para cada skill testada: manter, adaptar ou substituir, sempre com o motivo. Ligue cada decisão a uma saída que você observou, e não a uma impressão. Por fim, liste o acesso externo separado do procedimento. Uma recomendação curta serve: manter a skill de formato, adaptar o procedimento de resumo e deixar a entrega externa para uma conexão específica. Compare os resultados e diga por que aceita ou rejeita a mudança.

Falta um passo: levar isso para o seu processo, e é o que faremos agora.

### m02-a02-b03 — O limite da skill genérica

Slide m02-a02-s03

Uma skill pronta é um ponto de partida. Ela foi feita para um conjunto de situações que pode ser diferente do seu. Você pode aproveitar a estrutura e adaptar o procedimento, desde que saiba o que está mudando. E não precisa programar para isso: a regra é um texto em português.

Agora escolha um ajuste que faria diferença no seu processo: uma informação obrigatória, uma regra de prioridade ou um formato de entrega. Escreva por que ele importa e como você vai conferir se a skill o respeitou. Execute o ajuste na cópia de exercício, com a conversa completa e com a incompleta, e confira os dois testes antes de encerrar. Se algum resultado trouxer informação inventada, o ajuste ainda não está pronto.

Na próxima aula, deixamos a adaptação pontual e criamos um procedimento nosso, com entrada, regras, saída e exemplos de teste. Vamos usar o que já existe como apoio, sem tratar uma solução genérica como se conhecesse todo o seu trabalho.

# 2.2 — Explorando skills prontas

ID m02-a02. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Dependências e ensaio:** Ensaiar geração e abertura de ambos os formatos no ambiente da aula.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m02-a02-b01 | m02-a02-s01 / p. 1 | Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações. | Entrada de referência e critérios são visíveis antes de executar. |
| m02-a02-b04 | m02-a02-s04 / p. 2 | Testar skills pdf e docx com a mesma conversa fictícia, abrindo os arquivos reais. | Dois arquivos reais comparados com a mesma fonte; capacidades do formato e conteúdo distinguidas. |
| m02-a02-b02 | m02-a02-s02 / p. 3 | Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada. | Um único critério é alterado e a segunda saída é comparada com a primeira. |
| m02-a02-b05 | m02-a02-s05 / p. 4 | Modificar uma regra numa cópia da skill de resumo e repetir dois testes. | Mudança isolada melhora critério observado sem inventar informação no segundo caso. |
| m02-a02-b06 | m02-a02-s06 / p. 5 | Registrar decisão de uso para cada skill e vincular ao teste executado. | Decisão sobre skill pronta sustentada por teste e requisito concreto. |
| m02-a02-b03 | m02-a02-s03 / p. 6 | Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código. | Arquivos reais abertos, fatos conferidos, cópia original preservada e adaptação executada com evidência antes/depois. |

## m02-a02-b01 — Testar com uma entrada conhecida

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 1, ID m02-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b01. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Entrada/material:** apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/ficha-inspecao-skill.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Entrada de referência e critérios são visíveis antes de executar.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a02-b01; SHA-256 08ae4239ffcbeb96f02d80b3fc4a689a342d65e0213a4584d236c16d0d6a5160.

**Função visual:** Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações.


## m02-a02-b04 — Duas skills prontas, duas entregas verificáveis

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Testar skills pdf e docx com a mesma conversa fictícia, abrindo os arquivos reais. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 2, ID m02-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b04. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Entrada/material:** apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/ficha-inspecao-skill.md, apoio/registro-testes.md

**Passos de captura:**
1. Inspecionar duas skills em anthropics/skills e suas dependências.
2. Pedir DOCX e PDF do mesmo resumo, em saída de exercício.
3. Abrir cada formato e conferir conteúdo e edição/legibilidade.

**Saída e conferência:** Dois arquivos reais comparados com a mesma fonte; capacidades do formato e conteúdo distinguidas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a02-b04; SHA-256 f1c68ba6e4d778f8dac6b694b7d4d2cc59b121b77c3f6a15f0e919e4edd825dc.

**Função visual:** Testar skills pdf e docx com a mesma conversa fictícia, abrindo os arquivos reais.


## m02-a02-b02 — Um ajuste que tem motivo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 3, ID m02-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b02. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Entrada/material:** apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/ficha-inspecao-skill.md, apoio/registro-testes.md

**Passos de captura:**
1. Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Um único critério é alterado e a segunda saída é comparada com a primeira.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a02-b02; SHA-256 97e502ff5e82c5bf590325ba6b9caf692c96e477d5825c045bc85c5d4764444d.

**Função visual:** Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada.


## m02-a02-b05 — Comparar sem trocar todas as variáveis

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Modificar uma regra numa cópia da skill de resumo e repetir dois testes. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 4, ID m02-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b05. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Entrada/material:** apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/ficha-inspecao-skill.md, apoio/registro-testes.md

**Passos de captura:**
1. Preservar original e criar cópia local.
2. Alterar somente a regra de responsável.
3. Executar conversa completa e incompleta.
4. Comparar resultados no registro de testes.

**Saída e conferência:** Mudança isolada melhora critério observado sem inventar informação no segundo caso.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a02-b05; SHA-256 c0d386c74392fe9afe06bf980e3365e88eba33ff8c458934867578a4a58d8bc2.

**Função visual:** Modificar uma regra numa cópia da skill de resumo e repetir dois testes.


## m02-a02-b06 — Decidir o que aproveitar e o que criar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Registrar decisão de uso para cada skill e vincular ao teste executado. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 5, ID m02-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b06. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Entrada/material:** apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/ficha-inspecao-skill.md, apoio/registro-testes.md

**Passos de captura:**
1. Preencher manter/adaptar/substituir com motivo.
2. Vincular cada decisão a uma saída observada.
3. Listar acesso externo separado do procedimento.

**Saída e conferência:** Decisão sobre skill pronta sustentada por teste e requisito concreto.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a02-b06; SHA-256 543f22920c3254ce8514c4eb10f5a1521549f9df033115a144e12db76c01743b.

**Função visual:** Registrar decisão de uso para cada skill e vincular ao teste executado.


## m02-a02-b03 — O limite da skill genérica

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 6, ID m02-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b03. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Entrada/material:** apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/ficha-inspecao-skill.md, apoio/registro-testes.md

**Passos de captura:**
1. Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Arquivos reais abertos, fatos conferidos, cópia original preservada e adaptação executada com evidência antes/depois.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a02-b03; SHA-256 99afbc73a63498a13f025021fc7d35bc42f5d0366e653ebac67ce7eb30697c1a.

**Função visual:** Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código.


## Atividade e solução

Produzir DOCX/PDF com a mesma entrada e executar uma alteração de regra na skill de resumo, com dois testes.

Arquivos reais abertos, fatos conferidos, cópia original preservada e adaptação executada com evidência antes/depois.

## Materiais

- conversa-demo.txt
- conversa-incompleta.txt
- ficha-inspecao-skill.md
- registro-testes.md

# 2.2 — Como criar suas próprias skills / m02-a03

**Objetivo:** Criar uma skill própria com Skill Creator, estrutura adequada e dois testes verificáveis.

**Preparação:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Ensaio:** A skill criada em aula precisa ser instalada e ensaiada no projeto de exercício.

### m02-a03-b01 — Escrever o processo antes do arquivo

Slide m02-a03-s01

Para criar uma skill, comece pelo processo, não pelo arquivo. Uma skill é uma instrução reutilizável: você escreve uma vez como o trabalho deve ser feito, e o assistente passa a consultar essa instrução sempre que um pedido combina com ela. Pense num manual de procedimento para uma pessoa nova na equipe. Ninguém escreve um bom manual sem antes saber como o trabalho é feito.

Por isso, antes de escrever qualquer coisa, responda quatro perguntas. Primeira: quando ela deve ser usada? Segunda: o que ela precisa receber? Terceira: o que deve fazer com essa entrada? Quarta: como alguém vai conferir a saída? A quarta é a que mais se esquece, e é ela que permite dizer, depois, se a skill funcionou ou não.

Nosso exemplo é resumir uma conversa de trabalho. Vamos responder às quatro perguntas. Quando usar: quando eu pedir o resumo de uma conversa de trabalho. O que receber: o texto da conversa. O que fazer: separar o conteúdo em três partes, que são as decisões, as ações com os responsáveis e as perguntas abertas. E como conferir: se uma informação não aparece na conversa, ela fica marcada como não informada. Por exemplo, se ninguém falou o prazo de uma tarefa, a skill não escolhe um prazo só para o resumo parecer completo. Um resumo com lacuna assumida é mais útil do que um resumo bonito com prazo inventado, porque você passaria a confiar em algo que ninguém decidiu.

Esse é o manual que vamos construir. A ferramenta ajuda a montar o arquivo, mas o critério vem de quem conhece o trabalho, e essa pessoa é você. Por isso vamos usar três materiais do exercício. O primeiro é o arquivo de critérios, o criterios-resumo.md, que registra essas respostas. O segundo é uma conversa completa, em que todas as informações aparecem. O terceiro é uma conversa incompleta, a conversa-incompleta.txt, em que alguma informação falta de propósito.

Abra o arquivo de critérios e leia. Depois leia a conversa incompleta e procure o que ela não informa, como um responsável ou um prazo. Anote o que o resumo deveria fazer em cada lacuna. Essa anotação será o nosso gabarito, ou seja, a resposta esperada, para conferir a skill mais adiante.

### m02-a03-b04 — A pasta e a etiqueta que orientam a descoberta

Slide m02-a03-s04

Antes de criar a nossa skill, vamos olhar como uma skill é organizada por dentro. Vou abrir o exemplo de skill de resumo que está nos materiais da aula e percorrer a estrutura.

O arquivo principal se chama SKILL.md. No começo dele há um cabeçalho com o nome e a descrição. Pense nesse cabeçalho como uma etiqueta: ela ajuda o assistente a descobrir qual procedimento combina com o pedido que você fez. Abaixo do cabeçalho vem o corpo, que explica como trabalhar, passo a passo. Depois, só quando a tarefa precisa, entram as referências, que são arquivos de apoio com consulta, e os scripts, que são pequenos programas que a skill pode executar.

Agora compare duas descrições. Uma descrição como “ajuda com coisas” não diferencia a skill de nenhuma outra, então o assistente não tem como saber quando usá-la. Uma descrição como “organiza decisões, ações e perguntas de uma conversa de trabalho” liga o nome a pedidos que você realmente faz, como “organize as decisões desta reunião”. Mas a etiqueta só ajuda na descoberta. Quem explica os critérios são as instruções do corpo, e é nelas que você vai investir o seu esforço.

Dentro da pasta, mantenha só o necessário para a tarefa. Um exemplo bom de entrada e de saída pode esclarecer mais do que páginas de regras abstratas. Um script pode ajudar numa operação em que o resultado precisa ser sempre igual para a mesma entrada, como validar uma soma. Mas ele também traz dependências, isto é, outros programas dos quais ele precisa, e efeitos no seu computador que você precisa entender antes de aceitar. Se um dia você instalar uma skill feita por outra pessoa, leia o SKILL.md, os scripts e as permissões que ela pede. Número de instalações e estrelas num diretório são sinais de uso, não prova de segurança. Instruções curtas também ajudam por outro motivo: a conversa tem um limite de contexto, e quanto mais texto a skill carrega, menos espaço sobra para o seu trabalho.

Para o nosso resumo, vamos começar só com instruções e exemplos.

Por fim, depois de criar, confira onde a pasta foi salva e se a sessão consegue encontrá-la. O Claude Code procura skills no diretório .claude/skills, e o Codex também lê o diretório .agents/skills. O caminho faz parte da instalação: escrever um arquivo em qualquer lugar do computador não garante que ele será descoberto. A forma de conferir é abrir uma sessão nova e pedir um resumo no estilo da descrição, para ver se o assistente reconhece a skill.

### m02-a03-b02 — Criar com o Skill Creator

Slide m02-a03-s02

Agora vou passar esse procedimento ao Skill Creator, o recurso que ajuda a montar skills, desde que ele esteja disponível no seu ambiente. Vamos conferir isso no próximo bloco. O pedido que faremos é: criar uma skill de resumo com os critérios do exercício, usando a conversa de exemplo e a conversa com informações incompletas. Vamos criar no escopo do exercício, ou seja, dentro do projeto de exercício, e não em uma pasta que afete o resto do seu computador.

Seja específico no pedido. Diga qual problema a skill resolve, quando ela deve ser chamada, qual é o formato da entrada e o que precisa aparecer na saída. Diga também o que ela não deve inventar e o que fazer quando uma informação faltar. Se você deixar essas partes de fora, a ferramenta vai preencher com suposições dela, e a skill deixa de refletir o seu critério.

Uma observação sobre o modelo: para esta tarefa, comece no modelo e no esforço padrão do seu plano. Só aumente o esforço se aparecer uma dificuldade que você consiga verificar no resultado. Alguns modelos, como o Fable, podem exigir créditos, dependendo do plano. Por isso confira o seu consumo em Settings, na área de Usage, antes de escolher o modelo mais caro.

Quando a skill for criada, confira três coisas: o nome, a descrição e as instruções. A descrição deve ajudar a reconhecer pedidos reais, como “organize as decisões desta reunião”. As instruções devem deixar claro como analisar o conteúdo e como apresentar o resultado.

Confira também os arquivos que foram criados. Arquivos de referência e scripts só entram se ajudarem o procedimento. Para um resumo simples, uma estrutura com muitas partes só atrapalha a leitura. Se o processo crescer, dá para separar quem pesquisa, quem redige e quem entrega. Isso vai fazer mais sentido quando montarmos o time.

### m02-a03-b05 — Criar com Skill Creator e um exemplo bom

Slide m02-a03-s05

Agora vamos fazer isso na prática, pedindo ajuda a uma skill que cria skills. O primeiro passo é conferir se o Skill Creator está instalado e disponível no seu ambiente. Se ele não aparecer, resolva isso antes de seguir, e não tente montar a skill de outro jeito.

O segundo passo é entregar um pedido completo. Usaremos o arquivo prompt-skill-creator.md, que reúne o pedido: queremos resumir conversas de trabalho, separando decisões, ações e perguntas abertas. Responsável e prazo só aparecem quando a fonte informa; quando faltam, a saída registra a ausência. Anexe os critérios, a conversa completa e a incompleta. Peça um procedimento curto, exemplos de uso e dois testes.

A ferramenta pode perguntar detalhes do processo. Responda com o que você sabe ou marque o que ainda precisa definir. Não invente uma política da empresa só para concluir o arquivo, porque uma regra inventada passa a valer em todos os resumos futuros.

O terceiro passo é ler os arquivos criados e conferir o nome e a descrição. Leia a skill como se estivesse orientando uma pessoa nova. Dá para entender quando usar, o que receber, o que fazer e o que entregar? Os exemplos obedecem às regras que você deu?

O quarto passo é executar. Rode a skill com a conversa completa e depois com a conversa incompleta. Não aceite “os testes devem passar” como resultado. Abra as saídas dos dois casos e compare com o gabarito que montamos no primeiro bloco. Se um prazo foi inventado, registre o erro, porque o ciclo de correção vem no último bloco. A criação só fica útil quando o procedimento encontra uma entrada real de teste e produz algo que você consegue avaliar.

### m02-a03-b06 — Separar um processo grande e concluir a missão

Slide m02-a03-s06

Se o processo começa a misturar responsabilidades, divida pelo resultado de cada etapa. Veja o exemplo da produção de conteúdo. Pesquisar a pauta, escrever a mensagem e criar a peça visual podem ter entradas, critérios e ferramentas diferentes. Cada uma pode virar uma skill. Você pode usar essas skills isoladamente ou coordená-las depois.

Isso não significa transformar cada frase em uma skill. Procure uma entrega útil e testável. “Pesquisar uma pauta com fontes e perguntas abertas” é uma unidade mais clara do que “pensar”. “Produzir uma proposta a partir do escopo confirmado e da tabela” é outra unidade. A passagem entre elas precisa dizer qual arquivo ou informação sai de uma e entra na seguinte. Por exemplo, a pesquisa entrega a pauta com as fontes, e a escrita recebe exatamente esse arquivo. Se a passagem não estiver clara, a segunda skill vai trabalhar com o que não foi combinado.

Agora é a sua vez. Escolha um processo repetitivo do seu trabalho e crie a sua própria skill. Abra o arquivo projeto-final.md e preencha. Escreva os passos que você já conhece, uma entrada fictícia normal, outra com uma informação faltando e os critérios de aceite. Use dados fictícios, sem informação real de clientes. Use o Skill Creator como apoio e execute as duas entradas. Guarde a evidência de cada execução, isto é, o texto que a skill produziu.

Se o resultado for algo que sairia da sua empresa, como um e-mail ou uma mensagem, a skill prepara o texto e o envio continua sujeito à sua aprovação.

Essa é a missão do módulo. Uma skill boa não é a que tem mais regras: é a que resolve um problema relevante, mantém o seu critério e permite perceber quando precisa da sua decisão. O último bloco mostra como testar e corrigir, para você aplicar na sua skill.

### m02-a03-b03 — Testar o comportamento

Slide m02-a03-s03

Agora vamos aprender a testar o comportamento da skill com os dois exemplos. Voltamos à skill de resumo e olhamos o que ela produz. No texto completo, conferimos as decisões, os responsáveis e as perguntas abertas. No texto incompleto, o teste é ver se a skill mantém a informação como não informada, em vez de inventar uma resposta.

Anote o resultado de cada rodada no arquivo registro-testes.md: qual entrada você usou, o que a skill entregou e se cumpriu cada critério. Esse registro é a sua evidência de que a skill funciona.

Pedir a um modelo que avalie o arquivo pode ajudar na revisão, mas isso não vale como teste. Um comentário do modelo dizendo que a skill está boa não é aceite. O teste é o que a skill entrega com uma entrada do exercício.

Se aparecer um erro, descreva o erro e a regra que precisa mudar. Por exemplo: “a skill escreveu um prazo que a conversa não informou; a regra sobre dados ausentes precisa ficar mais explícita”. Ajuste essa regra e rode de novo a mesma entrada, para comparar antes e depois. Em seguida, repita também a outra entrada, porque a melhoria em um caso pode estragar o outro. Só então decida: a skill é aceita ou volta para outro ajuste.

A missão do módulo é criar uma skill para uma tarefa repetitiva do seu trabalho e testá-la com pelo menos uma entrada normal e uma incompleta. Entregue o SKILL.md, os exemplos, os resultados e a sua decisão de aceite.

Com o procedimento claro e testado, o próximo passo é dar à skill acesso às ferramentas que esse trabalho exige. Lá, vamos conceder apenas o acesso necessário, porque até uma leitura pode envolver informação sensível. Só depois de aprovar o resultado é que faz sentido pensar em deixar o trabalho rodando sozinho em horário marcado. E aí importa saber se ele roda na nuvem ou só com o seu computador ligado.

# 2.2 — Como criar suas próprias skills

ID m02-a03. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Dependências e ensaio:** A skill criada em aula precisa ser instalada e ensaiada no projeto de exercício.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m02-a03-b01 | m02-a03-s01 / p. 1 | Usar apoio/criterios-resumo.md e comparar entrada positiva com apoio/conversa-incompleta.txt. | Processo define entrada, passos, saída e o que fazer quando faltam dados. |
| m02-a03-b04 | m02-a03-s04 / p. 2 | Abrir a árvore da skill e apontar cabeçalho, instruções, referências e scripts opcionais. | Aluno identifica metadados e corpo e sabe explicar quando adicionar referências/scripts. |
| m02-a03-b02 | m02-a03-s02 / p. 3 | Invocar o Skill Creator disponível no ambiente. Fornecer requisitos e os dois exemplos, criar no escopo de exercício e conferir os arquivos produzidos. | Skill é criada e seus arquivos são inspecionados no local correto. |
| m02-a03-b05 | m02-a03-s05 / p. 4 | Usar Skill Creator para criar uma skill de resumo com critérios e dois exemplos. | Skill descoberta e executada; dois resultados conferidos contra critérios. |
| m02-a03-b06 | m02-a03-s06 / p. 5 | Mapear pesquisa/copy/design e orientar entrega da skill pessoal com dois casos. | Skill pessoal possui entrada, procedimento, saída e dois testes reais, com lacunas preservadas. |
| m02-a03-b03 | m02-a03-s03 / p. 6 | Rodar a skill criada com as duas entradas e registrar os resultados. Nota editorial do modelo não é aceite. | Descrição reconhece o uso; casos normal/incompleto executados; saída cumpre critérios e mantém dados ausentes. |

## m02-a03-b01 — Escrever o processo antes do arquivo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar apoio/criterios-resumo.md e comparar entrada positiva com apoio/conversa-incompleta.txt. | slides/m02-a03.pptx e slides/m02-a03.pdf, página 1, ID m02-a03-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a03-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a03-b01. Sem trilha prevista. |

**Estado inicial:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Entrada/material:** apoio/prompt-skill-creator.md, apoio/skill-resumo-exemplo.md, apoio/criterios-resumo.md, apoio/registro-testes.md, apoio/projeto-final.md

**Passos de captura:**
1. Usar apoio/criterios-resumo.md e comparar entrada positiva com apoio/conversa-incompleta.txt.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Processo define entrada, passos, saída e o que fazer quando faltam dados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a03-b01; SHA-256 042cae30e6738af6ae3a38fa24377f36512ef6e5c38e714b142364330175c6e5.

**Função visual:** Usar apoio/criterios-resumo.md e comparar entrada positiva com apoio/conversa-incompleta.txt.


## m02-a03-b04 — A pasta e a etiqueta que orientam a descoberta

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir a árvore da skill e apontar cabeçalho, instruções, referências e scripts opcionais. | slides/m02-a03.pptx e slides/m02-a03.pdf, página 2, ID m02-a03-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a03-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a03-b04. Sem trilha prevista. |

**Estado inicial:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Entrada/material:** apoio/prompt-skill-creator.md, apoio/skill-resumo-exemplo.md, apoio/criterios-resumo.md, apoio/registro-testes.md, apoio/projeto-final.md

**Passos de captura:**
1. Mostrar exemplo de SKILL.md válido.
2. Comparar descrição vaga com descrição ligada a pedido real.
3. Conferir diretório de descoberta do agente.

**Saída e conferência:** Aluno identifica metadados e corpo e sabe explicar quando adicionar referências/scripts.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a03-b04; SHA-256 0bfede86c2164783c25a760c0bbf603e369f6ac23b08398b61ef63cde4b31fe4.

**Função visual:** Abrir a árvore da skill e apontar cabeçalho, instruções, referências e scripts opcionais.


## m02-a03-b02 — Criar com o Skill Creator

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Invocar o Skill Creator disponível no ambiente. Fornecer requisitos e os dois exemplos, criar no escopo de exercício e conferir os arquivos produzidos. | slides/m02-a03.pptx e slides/m02-a03.pdf, página 3, ID m02-a03-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a03-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a03-b02. Sem trilha prevista. |

**Estado inicial:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Entrada/material:** apoio/prompt-skill-creator.md, apoio/skill-resumo-exemplo.md, apoio/criterios-resumo.md, apoio/registro-testes.md, apoio/projeto-final.md

**Passos de captura:**
1. Invocar o Skill Creator disponível no ambiente. Fornecer requisitos e os dois exemplos, criar no escopo de exercício e conferir os arquivos produzidos.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Skill é criada e seus arquivos são inspecionados no local correto.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a03-b02; SHA-256 5d0eb7609e8821a31ad910faff0bb8fc965a421b28d5c7ee6249f4f5d84b2922.

**Função visual:** Invocar o Skill Creator disponível no ambiente. Fornecer requisitos e os dois exemplos, criar no escopo de exercício e conferir os arquivos produzidos.


## m02-a03-b05 — Criar com Skill Creator e um exemplo bom

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar Skill Creator para criar uma skill de resumo com critérios e dois exemplos. | slides/m02-a03.pptx e slides/m02-a03.pdf, página 4, ID m02-a03-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a03-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a03-b05. Sem trilha prevista. |

**Estado inicial:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Entrada/material:** apoio/prompt-skill-creator.md, apoio/skill-resumo-exemplo.md, apoio/criterios-resumo.md, apoio/registro-testes.md, apoio/projeto-final.md

**Passos de captura:**
1. Confirmar disponibilidade do Skill Creator.
2. Enviar prompt-skill-creator.md e os dois textos.
3. Ler os arquivos criados e conferir nome/descrição.
4. Executar e registrar os dois casos.

**Saída e conferência:** Skill descoberta e executada; dois resultados conferidos contra critérios.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a03-b05; SHA-256 17601d7de93aec9b52c2ba51b3fc17583d0e791740f763e36968809b03db9fd6.

**Função visual:** Usar Skill Creator para criar uma skill de resumo com critérios e dois exemplos.


## m02-a03-b06 — Separar um processo grande e concluir a missão

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Mapear pesquisa/copy/design e orientar entrega da skill pessoal com dois casos. | slides/m02-a03.pptx e slides/m02-a03.pdf, página 5, ID m02-a03-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a03-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a03-b06. Sem trilha prevista. |

**Estado inicial:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Entrada/material:** apoio/prompt-skill-creator.md, apoio/skill-resumo-exemplo.md, apoio/criterios-resumo.md, apoio/registro-testes.md, apoio/projeto-final.md

**Passos de captura:**
1. Identificar entregas independentes no exemplo de conteúdo.
2. Preencher projeto-final.md com a skill pessoal.
3. Executar caso normal e incompleto e guardar evidência.

**Saída e conferência:** Skill pessoal possui entrada, procedimento, saída e dois testes reais, com lacunas preservadas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a03-b06; SHA-256 5beaef78cf28db41bcc7c02512f6be83fb19279126a5368f9b98f48f8de60dbd.

**Função visual:** Mapear pesquisa/copy/design e orientar entrega da skill pessoal com dois casos.


## m02-a03-b03 — Testar o comportamento

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Rodar a skill criada com as duas entradas e registrar os resultados. Nota editorial do modelo não é aceite. | slides/m02-a03.pptx e slides/m02-a03.pdf, página 6, ID m02-a03-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a03-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a03-b03. Sem trilha prevista. |

**Estado inicial:** Preparar Skill Creator disponível, critérios e exemplos; reservar tempo para ler a saída e corrigir uma regra.

**Entrada/material:** apoio/prompt-skill-creator.md, apoio/skill-resumo-exemplo.md, apoio/criterios-resumo.md, apoio/registro-testes.md, apoio/projeto-final.md

**Passos de captura:**
1. Rodar a skill criada com as duas entradas e registrar os resultados. Nota editorial do modelo não é aceite.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Descrição reconhece o uso; casos normal/incompleto executados; saída cumpre critérios e mantém dados ausentes.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a03-b03; SHA-256 2fb7f092e3e69fcf4fccdf50527c39157fa647c2cf4f13e02f2bef7fb7242fb7.

**Função visual:** Rodar a skill criada com as duas entradas e registrar os resultados. Nota editorial do modelo não é aceite.


## Atividade e solução

Criar e testar uma skill do próprio processo; entregar SKILL.md, exemplos, resultados e decisão de aceite.

Descrição reconhece o uso; casos normal/incompleto executados; saída cumpre critérios e mantém dados ausentes.

## Materiais

- prompt-skill-creator.md
- skill-resumo-exemplo.md
- criterios-resumo.md
- registro-testes.md
- projeto-final.md

# 3.1 — O que é MCP / m03-a01

**Objetivo:** Conectar um serviço do catálogo e demonstrar leitura com origem e permissão verificadas.

**Preparação:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Ensaio:** Teste autenticado e captura da página Notion ainda precisam do ambiente de gravação.

### m03-a01-b01 — Quando a tarefa depende de um sistema

Slide m03-a01-s01

Até aqui, trabalhamos com informações que nós entregamos à IA: um arquivo, um texto, uma pasta de exercício. A skill do módulo anterior, por exemplo, recebia o material de entrada que estava no nosso próprio computador.

Mas muitos processos dependem de dados que estão em outro lugar: uma agenda, uma pasta compartilhada, um registro numa ferramenta de trabalho. Se a IA não consegue chegar a esse lugar, alguém precisa copiar o conteúdo e colar na conversa, toda vez.

Para a IA chegar a esses dados, entram os conectores. E por trás de muitos conectores existe o MCP, sigla de Model Context Protocol, em português, protocolo de contexto para modelos. Um protocolo é um combinado: uma forma padronizada de duas partes conversarem. O MCP é um padrão para um sistema, como o Notion, disponibilizar recursos e ferramentas que um agente pode usar. Agente, aqui, é a IA trabalhando por etapas e usando ferramentas para cumprir uma tarefa. Você não precisa decorar a sigla; precisa entender o que a conexão permite fazer.

Uma comparação ajuda: o USB-C é um encaixe padronizado, e o MCP busca algo parecido. A ideia é reduzir a necessidade de criar uma ligação diferente para cada combinação de sistema e agente. Mesmo com o padrão, continuam valendo três coisas: a autenticação, que é provar quem você é para o serviço; as permissões, que dizem o que essa conta pode fazer; e os limites do próprio serviço.

### m03-a01-b04 — MCP, conector e skill sem trocar as funções

Slide m03-a01-s04

No módulo anterior você deu ao agente um procedimento, a skill. Agora vamos dar acesso à informação de que o procedimento precisa. Algumas pessoas comparam o modelo a um cérebro e a ferramenta a mãos. A comparação é útil para lembrar a sequência, mas com um cuidado: a skill não é o modelo que raciocina. A skill é a orientação, o passo a passo escrito. A ferramenta faz uma operação, e o agente decide como usá-la dentro da tarefa.

Vamos ver como o MCP organiza isso, só no que importa para você. Ele é um padrão aberto, ou seja, publicado para qualquer sistema poder adotar. Um servidor, que é o programa ou serviço que guarda as operações, oferece essas operações com nomes, entradas e respostas. Pense numa operação chamada buscar página: ela recebe um texto de busca e devolve o resultado. Um cliente compatível, que é o aplicativo onde você conversa com a IA, descobre essas operações e pode chamá-las. A comparação com o USB-C explica a ideia de um encaixe comum. Ela não é a promessa de que qualquer ferramenta funciona em qualquer lugar sem preparação.

Conector é o nome que a interface pode dar à integração com um serviço, aquilo que aparece na lista e que você liga. Ele pode usar MCP e também pode depender de uma autorização própria.

Talvez você ouça a frase “MCP conecta, skill executa”. Ela resume o mapa, mas, com mais precisão: a skill descreve como trabalhar, e o agente usa as operações conectadas. No diagrama, o caminho vai do cliente à ferramenta e da ferramenta à fonte, com a skill e a aprovação separadas desse caminho.

Pense num resumo de reunião. A conexão busca a fonte. A skill orienta o que extrair dela. A aprovação define o que pode acontecer depois, como salvar o resumo em algum lugar ou enviá-lo a alguém. Vamos observar essas três coisas separadas no mesmo exemplo, que será uma página do Notion.

### m03-a01-b02 — Conectar e fazer uma consulta

Slide m03-a01-s02

Vamos começar pelos conectores que o próprio ambiente oferece, e o nosso exemplo é o Notion, com uma página de exercício. Abra a lista de conectores, encontre o Notion e confira quais operações ele disponibiliza. Operação é cada ação que o conector sabe fazer, como buscar, ler ou criar uma página. Se você usa outro serviço, o caminho é o mesmo. Os nomes dos botões podem variar conforme o plano e a versão; siga os nomes que aparecerem na sua tela.

Antes de autorizar, veja qual conta será conectada e qual acesso está sendo pedido. Quem tem mais de uma conta, uma pessoal e uma da empresa, por exemplo, pode conectar a errada sem perceber.

Depois de conectar, faça uma consulta de leitura à página de exercício. Leitura quer dizer que a IA apenas consulta, sem mudar nada. Um pedido possível é: "Busque no Notion a página do exercício e me mostre o título e os principais tópicos." Use o título que a página tiver no seu Notion. O pedido precisa dizer duas coisas: o que buscar e que a operação é só de leitura.

Quando a resposta chegar, compare com a página aberta no próprio Notion. Essa comparação é importante. Ter o conector listado não prova que a conta tem acesso à página certa. A consulta pode não encontrar nada, trazer outro documento ou mostrar só parte dos dados. Se isso acontecer, confira conta, permissão e identificação da entrada antes de alterar a skill, porque o problema costuma estar no acesso, e não no procedimento.

Para criar ou alterar informações, diga também o destino e o que está autorizado. Excluir dados ou executar uma ação de impacto pede uma decisão explícita. A conexão não é uma autorização geral para qualquer operação.

### m03-a01-b05 — Conector pronto: autorização e primeira leitura

Slide m03-a01-s05

Agora vamos percorrer a conexão do começo ao fim, parando em cada decisão. A página que vamos usar é fictícia, criada só para o exercício, sem nenhum dado real.

Abra a área de conectores do Claude e procure o serviço escolhido para o exercício. Vamos usar o Notion. Leia a descrição e identifique se aquela integração é mantida pelo próprio serviço, pela Anthropic ou por outro fornecedor. Estar no catálogo não torna todas as integrações iguais, e saber quem mantém ajuda você a decidir quanto confiar.

Siga o login oficial, confira a conta e autorize somente a página ou o espaço necessário, quando o serviço permitir essa escolha. Limitar faz diferença porque o que você autoriza agora é o que o agente poderá enxergar depois. Volte à sessão e confira quais operações ficaram disponíveis. Agora peça a leitura da página de exercício, pelo título completo ou pelo identificador que o conector mostrar, e abra a mesma página no Notion para comparar.

O teste tem três resultados possíveis, e vale reconhecer cada um. Se encontrou a página correta, compare título e conteúdo. Se não encontrou, confira conta, escopo e identificador. Se trouxe outra página parecida, refine a identificação; não aceite pelo nome aproximado. Isso importa porque uma informação pública ou um texto plausível não prova acesso à sua página: a IA pode escrever uma resposta com cara de certa sem ter lido o que você queria.

Depois registre a origem da informação junto do resumo, ou seja, de qual página ele veio. No registro de testes, anote o identificador da página e o resultado. Senhas, tokens e chaves de acesso nunca vão para a conversa nem para o registro; a autenticação acontece no fluxo oficial de login. Por isso, o que acompanhamos aqui não é a tela de login, e sim o resultado: a conta certa recebeu o acesso certo, e uma operação retornou a fonte esperada.

### m03-a01-b06 — Permissão de leitura também precisa de critério

Slide m03-a01-s06

Uma regra útil para o exercício é começar com leitura e reservar gravação e exclusão para decisões explícitas. Gravação é criar ou alterar informação; exclusão é apagar. Mas leitura liberada não significa acesso irrestrito a toda a empresa. Uma pasta pode conter contratos, dados pessoais ou informações que não são necessárias ao processo, e ler também expõe esse conteúdo.

Por isso, defina o menor conjunto de recursos que resolve a tarefa. Se o trabalho só precisa da transcrição de teste, não há motivo para abrir todas as reuniões. Se precisa salvar uma proposta, escolha a pasta de destino e deixe claro o que pode ser criado. Uma autorização anterior para ler não autoriza alterar ou apagar. O mesmo vale para enviar algo a alguém: é uma ação com efeito fora da conversa, e pede a sua aprovação antes.

Na atividade, preencha o contrato de conexão, o arquivo contrato-conexao.md, com quatro campos: serviço, recurso, operação e aprovação. Um exemplo preenchido: serviço, Notion; recurso, a página de exercício; operação, somente leitura; aprovação, nenhuma gravação ou exclusão sem eu pedir. Junte a isso o critério de conferência: o título e os tópicos que a IA mostrar precisam bater com a página aberta. Depois execute a leitura autorizada e compare com a origem.

Registre também como revogar a conexão, isto é, como encerrar ou limitar o acesso. Procure essa opção na área de conectores; o caminho exato pode mudar conforme o plano e a versão. Basta localizar e entender o que ela faz, sem alterar nenhum dado. Isso faz parte de saber administrar o acesso, mesmo que você não precise revogá-lo a cada exercício.

### m03-a01-b03 — O acesso e o procedimento se complementam

Slide m03-a01-s03

Agora fica mais fácil separar as funções. O conector dá acesso às operações do serviço. A skill orienta quando usá-las, quais informações procurar e como organizar a entrega. A consulta que você fez no Notion pode ser relacionada aos critérios da skill de resumo, sem montar outro fluxo: o conector trouxe o conteúdo, e os critérios da skill dizem o que dele entra no resumo e como apresentá-lo.

Um detalhe sobre onde isso funciona. Um conector pode rodar em um serviço remoto, na internet, ou depender de um processo local, um programa que precisa estar rodando no seu computador. Isso muda onde ele pode ser usado: uma sessão na nuvem não recebe automaticamente os recursos instalados no seu computador. Ao escolher um conector, vale perguntar se ele depende da sua máquina.

Seu exercício é fazer uma consulta pequena de leitura no Notion e conferir a resposta na origem. Na conferência, olhe a conta conectada, a permissão, a identificação da entrada e se o retorno bate com o conteúdo da página. Você terá terminado quando conseguir dizer de onde veio a informação, com qual conta e com qual permissão, e confirmar que nada foi criado, alterado ou apagado. Quando essa base funciona, podemos explorar conectores que não estavam no catálogo inicial, mantendo a mesma disciplina: origem identificada, permissão adequada, chamada pequena e resultado conferido.

# 3.1 — O que é MCP

ID m03-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Dependências e ensaio:** Teste autenticado e captura da página Notion ainda precisam do ambiente de gravação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m03-a01-b01 | m03-a01-s01 / p. 1 | Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo. | Necessidade de acesso externo é diferenciada de instrução local. |
| m03-a01-b04 | m03-a01-s04 / p. 2 | Exibir fluxo cliente → ferramenta → fonte, com skill e aprovação separadas. | Aluno distingue protocolo, integração apresentada no cliente e procedimento. |
| m03-a01-b02 | m03-a01-s02 / p. 3 | Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio. | Conector consulta o documento correto e a resposta é comparada com a origem. |
| m03-a01-b05 | m03-a01-s05 / p. 4 | Conectar Notion pela interface oficial e ler página fictícia por ID. | Leitura real conferida na origem; conta e recurso inequivocamente identificados. |
| m03-a01-b06 | m03-a01-s06 / p. 5 | Preencher um contrato mínimo de acesso e localizar revogação do conector. | Pedido limita escopo e resultado; aluno explica como encerrar o acesso. |
| m03-a01-b03 | m03-a01-s03 / p. 6 | Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo. | Origem e conteúdo coincidem; escopo limitado; gravação/exclusão têm decisão distinta. |

## m03-a01-b01 — Quando a tarefa depende de um sistema

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 1, ID m03-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b01. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Necessidade de acesso externo é diferenciada de instrução local.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b01; SHA-256 3655bec4da46b58d5e3b1e64b44cd5e5b8c92f85922a4728d16872ee071a9d9e.

**Função visual:** Mostrar uma skill com entrada local e depois a necessidade de buscar dados em um serviço externo.


## m03-a01-b04 — MCP, conector e skill sem trocar as funções

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Exibir fluxo cliente → ferramenta → fonte, com skill e aprovação separadas. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 2, ID m03-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b04. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Apontar cada peça no diagrama.
2. Relacionar uma consulta de documento ao procedimento de resumo.

**Saída e conferência:** Aluno distingue protocolo, integração apresentada no cliente e procedimento.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b04; SHA-256 dd5d801a3b213f810b20ce1e334615582a3f60036394fe16c59642ae85f75eb9.

**Função visual:** Exibir fluxo cliente → ferramenta → fonte, com skill e aprovação separadas.


## m03-a01-b02 — Conectar e fazer uma consulta

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 3, ID m03-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b02. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Conector consulta o documento correto e a resposta é comparada com a origem.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b02; SHA-256 3b92ee87aa1bad069a9b16ec8dd47322eeb1ebbcf7441b4d46306eb3031019ba.

**Função visual:** Abrir conectores disponíveis, conectar um serviço de exercício e fazer uma consulta de leitura. O exemplo preferencial é Notion, como na Fase 2; confirmar acesso no ensaio.


## m03-a01-b05 — Conector pronto: autorização e primeira leitura

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conectar Notion pela interface oficial e ler página fictícia por ID. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 4, ID m03-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b05. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Criar página de exercício sem dados reais.
2. Conferir mantenedor, conta e escopo.
3. Consultar a página e comparar com o Notion aberto.
4. Registrar ID e resultado, sem credenciais.

**Saída e conferência:** Leitura real conferida na origem; conta e recurso inequivocamente identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b05; SHA-256 693a0d7e9165dc4e55f642c6144881709153d2895b1aba937a59e5e4d30dead2.

**Função visual:** Conectar Notion pela interface oficial e ler página fictícia por ID.


## m03-a01-b06 — Permissão de leitura também precisa de critério

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preencher um contrato mínimo de acesso e localizar revogação do conector. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 5, ID m03-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b06. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Registrar serviço/recurso/operação/aprovação.
2. Executar leitura autorizada.
3. Localizar como remover ou limitar a conexão sem alterar dados.

**Saída e conferência:** Pedido limita escopo e resultado; aluno explica como encerrar o acesso.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b06; SHA-256 4cc7b46288f2dd1af0e77041a6186a6dcc0a385133402fe249d0ece7343c26f7.

**Função visual:** Preencher um contrato mínimo de acesso e localizar revogação do conector.


## m03-a01-b03 — O acesso e o procedimento se complementam

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo. | slides/m03-a01.pptx e slides/m03-a01.pdf, página 6, ID m03-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a01-b03. Sem trilha prevista. |

**Estado inicial:** Preparar página fictícia e conta de exercício com autorização do recurso; login fora da gravação.

**Entrada/material:** apoio/contrato-conexao.md, apoio/conversa-demo.txt, apoio/registro-testes.md

**Passos de captura:**
1. Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Origem e conteúdo coincidem; escopo limitado; gravação/exclusão têm decisão distinta.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a01-b03; SHA-256 4ab9e03c61b738f0a6f3c4444ee5c402011ec35d6dc2dd8bd7befb3762e3684b.

**Função visual:** Relacionar a consulta feita com os critérios da skill de resumo, sem construir outro fluxo.


## Atividade e solução

Conectar página fictícia do Notion, executar leitura e comparar conteúdo, conta e recurso.

Origem e conteúdo coincidem; escopo limitado; gravação/exclusão têm decisão distinta.

## Materiais

- contrato-conexao.md
- conversa-demo.txt
- registro-testes.md

# 3.2 — Explorando MCPs personalizados / m03-a02

**Objetivo:** Configurar MCP personalizado por URL e comparar Higgsfield com Apify em operações de leitura.

**Preparação:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Ensaio:** Higgsfield autenticado e chamada pelo cliente usado na gravação ainda exigem ensaio; geração paga fora do escopo.

### m03-a02-b01 — Ir além do catálogo inicial

Slide m03-a02-s01

O catálogo inicial de conectores do seu aplicativo não cobre todo serviço. Alguns serviços publicam o próprio servidor MCP, que é o endereço pelo qual o agente consulta e usa o serviço, e explicam na documentação como ligá-lo ao seu agente.

Vale separar dois nomes que vão aparecer o tempo todo. Cliente é o programa onde você conversa com o agente, como um aplicativo ou o terminal. Servidor é o lado do serviço, que recebe o pedido e responde. Quando o servidor é acessado por um endereço na internet, a URL, ele é chamado de remoto: ele funciona no próprio serviço, não no seu computador. Também existem servidores locais, que o seu computador inicia e mantém ligados. Os dois exemplos de hoje são remotos.

Vamos começar pelo Higgsfield, um serviço de imagem e vídeo. Primeiro, procuro a orientação oficial do serviço e vejo qual caminho vale para o ambiente que estou usando. Esse passo importa porque conectar pelo aplicativo, pelo terminal ou em outro agente são configurações diferentes, e a instrução de um não serve para o outro.

Quando o ambiente aceita conector por URL, a documentação traz o endereço do servidor. O percurso tem três movimentos: usar a URL oficial, autorizar no próprio serviço e voltar ao cliente para conferir se o acesso apareceu.

Nesta aula a regra é só leitura. Vamos consultar o que o serviço oferece, sem gerar mídia e sem executar coleta de dados. Nos próximos blocos fazemos cada movimento com calma, olhando uma decisão de cada vez.

### m03-a02-b04 — Higgsfield pela URL oficial

Slide m03-a02-s04

Vamos conectar o Higgsfield pela URL que o próprio serviço publica. A página oficial de configuração é higgsfield.ai/mcp. O endereço do conector é mcp.higgsfield.ai/mcp, com HTTPS, que é a conexão protegida. Repare que são dois endereços: a página é onde você lê as instruções, e o endereço do conector é o que vai dentro do cliente. Antes de autorizar qualquer coisa, abra a página oficial e confira o domínio na barra do navegador, letra por letra. Um endereço com nome parecido não é a mesma coisa.

Agora o passo a passo. Primeiro, abrir a página de configuração e conferir o domínio. Segundo, no cliente que aceita conectores personalizados por URL, procurar nas configurações a opção de adicionar um conector personalizado. O nome do botão muda conforme o plano e a versão, então siga o que aparece na sua tela. Dê um nome que você reconheça depois, cole o endereço do conector e crie a conexão. Terceiro, siga a autenticação oferecida. Ela acontece na página do próprio Higgsfield: senha e códigos você digita lá, nunca no chat com o agente e nunca num arquivo da aula.

Se você está no Claude Code, que funciona no terminal, use o procedimento de configuração para esse cliente. O mesmo servidor pode atender vários clientes compatíveis, mas a forma de guardar a conexão e de fazer o login muda de um para outro.

Quarto, volte ao cliente e confira se a conexão aparece como ativa. Quinto, peça uma consulta de catálogo ou de documentação disponível, sem iniciar geração. Se o cliente pedir permissão para usar a ferramenta, leia o que está sendo pedido antes de aprovar. Para uma consulta de leitura, aprovar é proporcional ao que está em jogo. Depois observe a chamada da ferramenta e o retorno.

Se a conexão falhar, separe os diagnósticos, nesta ordem: o endereço; a compatibilidade do transporte, que é a forma técnica como cliente e servidor conversam e que os dois precisam aceitar; a autorização; e, por último, a operação que você pediu. E não troque a URL por outra encontrada num comentário ou num fórum sem conferir o fornecedor.

### m03-a02-b02 — Provar a conexão com uma leitura

Slide m03-a02-s02

Com a conexão feita, peça algo que só o serviço consegue responder. Aqui, uma boa escolha é consultar o catálogo de modelos disponíveis. É uma leitura: mostra se houve uma chamada real ao Higgsfield, sem iniciar a geração de imagem ou vídeo. O que aparecer depende da sua conta, então não espere ver a mesma lista que a minha.

Isso importa porque a IA pode dizer que conhece o Higgsfield usando apenas conhecimento geral, e a resposta pode soar certa sem que o serviço tenha sido consultado. Por isso, na demonstração, vamos olhar duas coisas: o uso da ferramenta, isto é, se o cliente mostra que uma ferramenta do Higgsfield foi chamada, e o retorno da consulta, que tem de vir dessa ferramenta. Se só houver um texto explicativo, sem chamada visível, a conexão ainda não está provada.

Uma consulta de perfil também serve como prova, mas ela pode devolver dados pessoais da conta. Por isso prefiro o catálogo. Se você consultar o perfil, cubra nome, e-mail e identificadores antes de mostrar a tela a alguém. Mesmo uma leitura pode envolver informação sensível, então, ao autorizar, conceda só o escopo de que a tarefa precisa.

Vale separar também acesso e consumo. Consultar o catálogo é diferente de gerar mídia, que pode usar créditos e depende do modelo, das condições da conta e do contrato vigente. Antes de gerar, confira qual operação você está pedindo e como ela é cobrada.

Se você usa outro ambiente, siga a integração indicada para ele. Colar a mesma URL em qualquer tela nem sempre cria a mesma conexão. O caminho para levar daqui tem quatro passos: documentação oficial, ambiente compatível, autorização e uma chamada de conferência.

### m03-a02-b05 — Apify como segundo exemplo personalizado

Slide m03-a02-s05

Agora vamos ao Apify. Ele reúne programas de coleta e processamento de dados, chamados Actors. O MCP do Apify permite descobrir esses programas, ler o contrato de cada um e, quando você autoriza, executar e buscar os resultados. O contrato é a descrição do que o programa recebe, o que devolve e quanto custa. Isso é diferente de perguntar ao modelo quais ferramentas existem, porque aqui a lista vem do serviço.

O endereço do MCP remoto é mcp.apify.com. A documentação atual oferece também uma configuração de descoberta, que expõe somente a busca de Actors e a documentação. Use a URL de descoberta que está no guia de conexões. Esse caminho pode funcionar sem conta para essas duas operações. Já executar Actors e acessar os dados de uma execução exige autenticação. Na conexão remota autenticada, o serviço recomenda OAuth, que é a autorização feita na página do próprio serviço, sem você entregar a senha ao agente.

Vamos conectar em modo de descoberta e procurar um Actor relacionado à pesquisa de empresas. Abra os detalhes dele e observe quatro coisas: o que ele recebe de entrada, o que devolve de saída, como é cobrado e quais são as limitações. Anote o formato da entrada, que é o schema, e o preço. Não chamamos execução.

Encontrar um programa não significa que ele já pesquisou alguma coisa. A busca mostra que o Actor existe e como usá-lo; só a execução produz dados, e ela fica fora desta aula. Outro detalhe: a lista de ferramentas do servidor também pode ser reduzida, para que o agente não carregue operações que o exercício não usa.

### m03-a02-b06 — Diagnosticar e escolher a conexão do seu processo

Slide m03-a02-s06

Se a conexão aparece instalada mas uma chamada falha, não conclua que todo MCP deixou de funcionar. Leia o erro e veja em que etapa ele ocorreu. O servidor respondeu? A conta foi autorizada? A ferramenta existe? Os parâmetros obedecem ao contrato? Há alguma restrição do plano? Instalada não é o mesmo que executada: só uma chamada com retorno prova que a integração funciona.

Vamos comparar três tipos de erro, com exemplos sem nenhuma chave de acesso. Primeiro, erro de endereço: o servidor não responde ou não é reconhecido. Confira se você usou o endereço do conector e não o da página de instruções, que no Higgsfield é a diferença entre mcp.higgsfield.ai/mcp e higgsfield.ai/mcp, e confira o domínio e o HTTPS. Segundo, erro de autenticação: a chamada pede login ou é recusada. Isso pede revisar a autorização, não mudar o texto da skill. Terceiro, erro de parâmetro: o servidor entendeu o pedido, mas recusou os dados enviados. Isso pede comparar a entrada com o schema atual do contrato.

Uma ferramenta ausente é outro caso. Ela pode indicar catálogo desatualizado, uma configuração com poucas operações ou mudança de versão. Em todos os casos, mude uma coisa por vez. Mudar tudo ao mesmo tempo apaga as pistas.

Agora a atividade. Escolha um dos dois serviços e registre uma consulta real de leitura, nos arquivos do exercício, usando o registro de testes. Anote cinco informações. A origem: de onde veio o endereço, por exemplo a página oficial. O cliente: em que programa você conectou. A operação: o que você pediu, como uma consulta de catálogo. A entrada: o texto ou os parâmetros enviados. E o resultado: o que a ferramenta devolveu, em um trecho curto e sem dados pessoais. Inspecione também o contrato do serviço que você escolheu e compare com o que você viu na chamada.

Se não tiver acesso, registre precisamente o que falta, como a conta no serviço ou um cliente que aceite conector por URL, e mantenha o teste como não executado. Na demonstração, vou mostrar os dois exemplos para você ver as diferenças. Você não precisa contratar ferramentas que não fazem parte do seu processo só para preencher uma lista. Precisa aprender a verificar uma integração por URL e saber o que falta quando ela não chega ao resultado esperado.

### m03-a02-b03 — Um segundo exemplo com função diferente

Slide m03-a02-s03

Para fechar, vale olhar o que os dois exemplos mostram juntos. O Higgsfield conecta capacidades de mídia: o que ele entrega, no fim, é imagem ou vídeo gerados. O Apify conecta descoberta e execução de automações de coleta de dados: o que ele entrega são dados, depois que um Actor é executado. Funções diferentes, mas o método de conferência é o mesmo: consultar a documentação do fornecedor, configurar no cliente adequado e fazer uma chamada pequena de leitura.

Nos dois, a ação que consome é a etapa seguinte à que fizemos. No Higgsfield, é a geração, que pode gastar créditos. No Apify, é a execução do Actor, que depende de acesso e pode ter custo. Aqui ficamos na descoberta, em uma consulta pública que localiza o Actor e a documentação dele. A execução, com o limite de gasto e a leitura do resultado, fica para a aula em que ligamos uma skill de prospecção ao serviço.

Para acompanhar, você não precisa conectar dois serviços novos. Escolha um que faça sentido no seu processo e prove o acesso com uma ação pequena, como uma consulta. Na próxima aula, vamos ver como procurar uma alternativa quando você ainda não sabe qual conector usar.

# 3.2 — Explorando MCPs personalizados

ID m03-a02. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Dependências e ensaio:** Higgsfield autenticado e chamada pelo cliente usado na gravação ainda exigem ensaio; geração paga fora do escopo.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m03-a02-b01 | m03-a02-s01 / p. 1 | Abrir a documentação oficial do Higgsfield e o caminho de conector por URL em um ambiente compatível. | Compatibilidade do ambiente e endpoint são identificados. |
| m03-a02-b04 | m03-a02-s04 / p. 2 | Adicionar o MCP Higgsfield pela URL oficial e consultar catálogo sem geração. | URL oficial e ferramenta observadas, com resposta de leitura e nenhum crédito de geração usado. |
| m03-a02-b02 | m03-a02-s02 / p. 3 | Usar https://mcp.higgsfield.ai/mcp no caminho compatível. Testar consulta de perfil/catálogo, sem iniciar geração paga. Não mostrar dados pessoais da conta. | Consulta de perfil/catálogo responde; informações privadas ficam ocultas e nenhuma geração é iniciada. |
| m03-a02-b05 | m03-a02-s05 / p. 4 | Conectar Apify em modo discovery e buscar um Actor sem execução. | Discovery distinguido de execução; contrato do Actor identificado. |
| m03-a02-b06 | m03-a02-s06 / p. 5 | Comparar erro de URL, autenticação e parâmetro com os contratos dos serviços. | Diagnóstico identifica etapa e evidência, sem tratar instalação como execução. |
| m03-a02-b03 | m03-a02-s03 / p. 6 | Apresentar o Apify como segundo MCP e executar somente a descoberta pública já conferida; guardar execução de Actor para a aula própria. | URL oficial, cliente, autenticação e retorno documentados; descoberta não apresentada como geração/coleta. |

## m03-a02-b01 — Ir além do catálogo inicial

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir a documentação oficial do Higgsfield e o caminho de conector por URL em um ambiente compatível. | slides/m03-a02.pptx e slides/m03-a02.pdf, página 1, ID m03-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a02-b01. Sem trilha prevista. |

**Estado inicial:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Entrada/material:** apoio/guia-conexoes.md, apoio/contrato-conexao.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir a documentação oficial do Higgsfield e o caminho de conector por URL em um ambiente compatível.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Compatibilidade do ambiente e endpoint são identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a02-b01; SHA-256 e7ef8a512f9551d8c8814eac5eafb84eabd5851fe215d11910ecce0dec936b14.

**Função visual:** Abrir a documentação oficial do Higgsfield e o caminho de conector por URL em um ambiente compatível.


## m03-a02-b04 — Higgsfield pela URL oficial

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Adicionar o MCP Higgsfield pela URL oficial e consultar catálogo sem geração. | slides/m03-a02.pptx e slides/m03-a02.pdf, página 2, ID m03-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a02-b04. Sem trilha prevista. |

**Estado inicial:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Entrada/material:** apoio/guia-conexoes.md, apoio/contrato-conexao.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir setup oficial e conferir domínio.
2. Configurar conector compatível e autenticar fora da captura.
3. Fazer consulta de catálogo/documentação e observar chamada.
4. Não iniciar operação paga.

**Saída e conferência:** URL oficial e ferramenta observadas, com resposta de leitura e nenhum crédito de geração usado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a02-b04; SHA-256 7c7ab685a1224d1a0f2897a700fcdce63592c1dfafb1d198a0b2b21746e0c546.

**Função visual:** Adicionar o MCP Higgsfield pela URL oficial e consultar catálogo sem geração.


## m03-a02-b02 — Provar a conexão com uma leitura

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar https://mcp.higgsfield.ai/mcp no caminho compatível. Testar consulta de perfil/catálogo, sem iniciar geração paga. Não mostrar dados pessoais da conta. | slides/m03-a02.pptx e slides/m03-a02.pdf, página 3, ID m03-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a02-b02. Sem trilha prevista. |

**Estado inicial:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Entrada/material:** apoio/guia-conexoes.md, apoio/contrato-conexao.md, apoio/registro-testes.md

**Passos de captura:**
1. Usar https://mcp.higgsfield.ai/mcp no caminho compatível. Testar consulta de perfil/catálogo, sem iniciar geração paga. Não mostrar dados pessoais da conta.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Consulta de perfil/catálogo responde; informações privadas ficam ocultas e nenhuma geração é iniciada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a02-b02; SHA-256 3aee95690b6ec34b397a6f8944fb8526acecebae374b2bfd633dc83a4ca42f54.

**Função visual:** Usar https://mcp.higgsfield.ai/mcp no caminho compatível. Testar consulta de perfil/catálogo, sem iniciar geração paga. Não mostrar dados pessoais da conta.


## m03-a02-b05 — Apify como segundo exemplo personalizado

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conectar Apify em modo discovery e buscar um Actor sem execução. | slides/m03-a02.pptx e slides/m03-a02.pdf, página 4, ID m03-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a02-b05. Sem trilha prevista. |

**Estado inicial:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Entrada/material:** apoio/guia-conexoes.md, apoio/contrato-conexao.md, apoio/registro-testes.md

**Passos de captura:**
1. Usar a URL de discovery documentada no guia de conexões.
2. Buscar Actor e obter seus detalhes.
3. Identificar schema, preço e saída, sem chamar execução.

**Saída e conferência:** Discovery distinguido de execução; contrato do Actor identificado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a02-b05; SHA-256 bff116fb8188f61e6fc18920055e454ae73379037b73adcd0cd28e85b0731e04.

**Função visual:** Conectar Apify em modo discovery e buscar um Actor sem execução.


## m03-a02-b06 — Diagnosticar e escolher a conexão do seu processo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar erro de URL, autenticação e parâmetro com os contratos dos serviços. | slides/m03-a02.pptx e slides/m03-a02.pdf, página 5, ID m03-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a02-b06. Sem trilha prevista. |

**Estado inicial:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Entrada/material:** apoio/guia-conexoes.md, apoio/contrato-conexao.md, apoio/registro-testes.md

**Passos de captura:**
1. Preparar exemplos de erro sem tokens.
2. Relacionar cada erro ao ponto a investigar.
3. Registrar consulta real ou bloqueio específico.

**Saída e conferência:** Diagnóstico identifica etapa e evidência, sem tratar instalação como execução.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a02-b06; SHA-256 608e868ee3ca543e6ef1ae716853bc0b892108dbf088e74b24f132421f7c4bcf.

**Função visual:** Comparar erro de URL, autenticação e parâmetro com os contratos dos serviços.


## m03-a02-b03 — Um segundo exemplo com função diferente

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Apresentar o Apify como segundo MCP e executar somente a descoberta pública já conferida; guardar execução de Actor para a aula própria. | slides/m03-a02.pptx e slides/m03-a02.pdf, página 6, ID m03-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a02-b03. Sem trilha prevista. |

**Estado inicial:** Preparar autorização Higgsfield e discovery Apify. Consultar apenas catálogo, documentação e detalhes de Actor.

**Entrada/material:** apoio/guia-conexoes.md, apoio/contrato-conexao.md, apoio/registro-testes.md

**Passos de captura:**
1. Apresentar o Apify como segundo MCP e executar somente a descoberta pública já conferida; guardar execução de Actor para a aula própria.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** URL oficial, cliente, autenticação e retorno documentados; descoberta não apresentada como geração/coleta.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a02-b03; SHA-256 7875d5dc392345ce43a301a7c995a002a4a5c45f9d905f7f4652a9edc5b28a99.

**Função visual:** Apresentar o Apify como segundo MCP e executar somente a descoberta pública já conferida; guardar execução de Actor para a aula própria.


## Atividade e solução

Inspecionar os dois contratos e executar ao menos uma consulta real de leitura; professor ensaia ambos.

URL oficial, cliente, autenticação e retorno documentados; descoberta não apresentada como geração/coleta.

## Materiais

- guia-conexoes.md
- contrato-conexao.md
- registro-testes.md

# 3.3 — Onde procurar MCPs que executam seu trabalho / m03-a03

**Objetivo:** Encontrar, inspecionar, instalar e testar um MCP do GitHub com consulta cadastral verificável.

**Preparação:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Ensaio:** Consulta MCP Brasil precisa de ensaio no cliente da gravação; a verificação anterior teve falha de dependência e não comprova indisponibilidade global.

### m03-a03-b01 — Procurar a operação necessária

Slide m03-a03-s01

Quando for procurar um MCP, comece pela tarefa, não pela ferramenta. MCP é um protocolo aberto, isto é, um padrão público que permite a um assistente de IA se conectar a outro serviço e executar operações nele, como consultar uma base de dados. Na tela do programa que você usa, essa conexão costuma aparecer com o nome de conector. “Preciso consultar estes dados” é um ponto de partida melhor do que “quero instalar um conector interessante”, porque a tarefa lhe dá um critério para decidir se a ferramenta serve.

Vou mostrar o caminho na ordem em que eu faria. Primeiro, abro o site ou a documentação do próprio serviço e vejo se ele oferece uma integração com assistentes de IA. Quando é o fornecedor que mantém a integração, você sabe de onde ela vem. Se não houver, aí sim procuramos em um diretório de MCPs, que é um catálogo de projetos, e no GitHub, que é o site onde o código de cada projeto fica publicado. Esses lugares ajudam a descobrir opções, mas não avaliam por você a origem nem o funcionamento.

Em seguida, abro a página de um projeto para ver a fonte, e não só a descrição do catálogo. Para avaliar uma opção, olhe cinco pontos. Primeiro, quem mantém o projeto: uma empresa, uma organização ou uma pessoa, e se isso está claro. Segundo, quais operações ele expõe, ou seja, o que ele realmente consegue fazer, e se isso corresponde à sua tarefa. Terceiro, como ele autentica, isto é, como prova quem é você ao serviço: com login, com uma chave de acesso, ou sem nada. Quarto, de quais dependências precisa, que são os outros programas que têm de estar instalados para ele funcionar. E quinto, se a documentação explica a instalação com clareza.

Estrelas e atualizações recentes são sinais úteis, mas não garantem segurança, qualidade nem continuidade. Um projeto muito popular pode ser abandonado, e um projeto pequeno pode ser bem cuidado. Por isso, a leitura da fonte vem antes da decisão.

### m03-a03-b04 — Diretório descobre; origem explica

Slide m03-a03-s04

Antes de abrir um diretório, escreva a tarefa que você precisa resolver. No nosso exercício, queremos consultar dados cadastrais públicos de uma empresa a partir do CNPJ, que é o número de registro da empresa. Essa definição ajuda a avaliar se uma ferramenta serve, em vez de instalar um pacote pelo número de recursos que ele anuncia.

Agora vou seguir a busca na ordem. Procuro primeiro a integração do próprio fornecedor. Depois uso os diretórios de MCP e o GitHub para encontrar alternativas. Chegando ao repositório Mcp-Brasil/mcp-brasil, que é o espaço público onde o projeto guarda seus arquivos, abro o README, o texto de apresentação do projeto, e leio quatro coisas: como se instala, quais dependências ele pede, como autentica e quais operações oferece. O que mais me interessa é a ferramenta que consulta a BrasilAPI, porque é ela que atende à nossa tarefa. Também observo a manutenção e as mudanças recentes. Estrelas ajudam a descobrir projetos conhecidos, mas não substituem essa leitura.

Agora peço ao Claude Code uma inspeção antes da instalação. Pergunto: qual comando será executado, quais arquivos serão criados e quais acessos o servidor pode usar? Se o seu Claude Code tiver o modo de plano, que propõe as ações sem executá-las, ele serve bem aqui. Se não tiver, escreva no pedido que quer apenas o plano. O pedido de inspeção não deve autorizar a execução de qualquer comando encontrado no README. A documentação é referência; a autorização vem do escopo do seu exercício: esta pasta, esta tarefa e leitura de dados públicos. Mesmo uma leitura pode envolver informação sensível, então conceda só o acesso que a tarefa exige.

Por fim, registre a versão ou o commit, que é o registro de um ponto exato do código do projeto. Se o exemplo da aula usa uma versão e você instala outra, essa informação ajuda a explicar uma diferença. Também confirme qual projeto está usando: vários repositórios podem ter “Brasil” e “MCP” no nome e não expor as mesmas ferramentas.

### m03-a03-b02 — O exemplo do MCP Brasil

Slide m03-a03-s02

Vamos usar como exemplo o MCP Brasil, do repositório Mcp-Brasil/mcp-brasil, para consultar dados cadastrais públicos. É um projeto independente. O nome não significa que seja um serviço oficial do governo, e é por isso que conferimos o que ele faz em vez de confiar no nome.

O pedido leva um CNPJ público de exemplo e limita a saída aos campos que queremos conferir: razão social, que é o nome jurídico registrado da empresa; situação cadastral; município; a fonte da informação; e o que não veio na resposta. Na gravação, esse pedido só roda depois que o conector estiver instalado e conferido em um ambiente de exercício, que é uma pasta separada, usada só para o treino. É o que faremos no próximo passo.

Já deixo as regras da resposta combinadas. Se uma fonte falhar, a resposta precisa dizer isso. Se um campo estiver ausente, ele continua ausente. E não vamos pedir ao modelo uma conclusão jurídica sobre a empresa.

Depois da consulta, comparamos cada campo com a fonte de dados usada. Assim você separa três coisas: o que o conector devolveu, o que a IA interpretou e o que foi verificado de forma independente. Um valor que só aparece no texto da IA ainda não foi verificado.

Uma observação sobre o navegador. Se a consulta funcionar no navegador e falhar no conector, os dois resultados não valem o mesmo. O navegador mostra que a fonte respondeu por aquele caminho. Falta descobrir por que o cliente, ou a operação escolhida, não conseguiu consultar. Por isso, se eu abrir uma aba do navegador, será para conferir a fonte, e vou dizer isso em voz alta, sem substituir a execução do MCP.

### m03-a03-b05 — Instalar e fazer o raio-x de um CNPJ

Slide m03-a03-s05

Vamos instalar o MCP Brasil em um ambiente de exercício, seguindo o comando da versão que inspecionamos. A documentação do projeto indica um servidor local, iniciado com Python e com ferramentas de instalação como o uv. Local quer dizer que ele roda no seu computador, então a máquina precisa estar ligada enquanto você usa. Antes, confira na tela se Python e uv estão disponíveis e se o comando atual é o mesmo que lemos. Depois peça ao Claude Code para preparar a configuração apenas deste projeto, de modo que nada fique espalhado pelo resto do computador, e leia o que será feito antes de aprovar a execução.

Com a instalação feita, abra a lista real de ferramentas do conector. Localize a operação de consulta cadastral e veja qual parâmetro ela espera, que é o dado que você entrega a ela, no nosso caso o CNPJ. Não invente o nome da ferramenta a partir do título da aula; use o nome que aparece na lista. Envie um CNPJ público escolhido para o ensaio e peça somente razão social, situação cadastral, município, fonte e campos ausentes. Essa consulta é só de leitura, e não gravamos nada em nenhum serviço externo.

Agora abra a fonte que respondeu e compare os campos, um a um: razão social, situação e município. O que temos aqui é um retrato cadastral daquela fonte naquele momento. Não é uma conclusão sobre saúde financeira, idoneidade ou regularidade completa da empresa. Também não inferimos contato pessoal nem buscamos dados privados.

Se a API responder com erro, registre o status e a operação que foram executados. API é a porta pela qual um programa consulta outro. Uma página no navegador pode funcionar enquanto o cliente do MCP falha por dependência, por cabeçalho ou por limite de acesso. Dependência é um programa que faltou; cabeçalho é uma informação técnica enviada junto do pedido; limite de acesso é um teto de consultas que a fonte aceita. Não substitua silenciosamente a demonstração MCP por uma consulta na web. Mostre o que foi executado e qual parte ainda precisa de correção.

### m03-a03-b06 — Erro útil e critério de aceite

Slide m03-a03-s06

Um resultado útil também precisa saber explicar uma ausência. Se a fonte não informou um campo, o modelo não completa por plausibilidade. Se o CNPJ foi recusado por formato, a correção é ajustar a entrada, não inventar um cadastro. Se o servidor não iniciou, nem chegamos à consulta.

Por isso, faça um teste de erro controlado. Envie uma entrada inválida no ambiente de teste, por exemplo um CNPJ com números a menos, e observe como a integração responde. Confira que a resposta não fabrica um cadastro. O objetivo é ver se você consegue distinguir três situações: dado inválido, falha de acesso e dado ausente. Nenhum desses casos permite apresentar um relatório como consulta concluída.

Depois, registre o teste normal e o teste negativo, com o diagnóstico de cada um: o que foi enviado, o que voltou, qual fonte respondeu e o que ficou sem resposta. Esse registro é o critério de aceite. Um bom relatório diferencia a consulta correta, o erro e os campos ausentes, sem chegar a um parecer fiscal.

Com isso, fechamos a demonstração. Agora é a sua vez de aplicar o mesmo raciocínio ao seu processo.

### m03-a03-b03 — Instalar para resolver um problema

Slide m03-a03-s03

Agora o exercício. Escolha uma operação de leitura ligada ao seu processo, e não uma que altere ou envie algo. Registre três itens: a origem do conector, a operação que ele resolve e uma consulta de teste que possa ser comparada com a fonte.

Se for pedir que a IA instale um MCP a partir de um repositório, peça antes que ela explique o que será instalado e qual acesso será usado. Você não precisa ler cada linha de código para começar, mas precisa entender a função e o alcance.

Confira assim: a origem diz quem mantém o projeto; a operação corresponde à tarefa que você tem; e a consulta de teste pode ser comparada com a fonte. Se a documentação ou a autenticação não estiver clara, anote como pendência real. Não trate como detalhe.

Se você instalar o MCP, guarde a configuração sem credenciais, isto é, sem senhas nem chaves de acesso, e registre como removê-lo. Você conclui a atividade quando consegue mostrar a operação, a entrada e a conferência do resultado, ou indicar a dependência concreta que impediu o teste.

E se o serviço tem uma API, mas não existe um MCP adequado? Esse é o assunto da próxima aula: vamos criar uma conexão quando não existe uma opção pronta que sirva.

# 3.3 — Onde procurar MCPs que executam seu trabalho

ID m03-a03. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Dependências e ensaio:** Consulta MCP Brasil precisa de ensaio no cliente da gravação; a verificação anterior teve falha de dependência e não comprova indisponibilidade global.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m03-a03-b01 | m03-a03-s01 / p. 1 | Começar pelo site/documentação do serviço; depois mostrar um diretório e a fonte de um projeto. | Serviço, operação necessária, origem e manutenção do conector são identificados. |
| m03-a03-b04 | m03-a03-s04 / p. 2 | Inspecionar o repositório Mcp-Brasil/mcp-brasil e registrar versão/origem antes de instalar. | Escolha justificada por tarefa, operações, origem e acesso. |
| m03-a03-b02 | m03-a03-s02 / p. 3 | Identificar o projeto Mcp-Brasil/mcp-brasil e conferir a instalação em ambiente de exercício antes de consultar o CNPJ público do exemplo. Não substituir a execução MCP por uma aba de navegador sem explicar. | Chamada MCP retorna campos cadastrais conferidos com a referência; falha é registrada como falha. |
| m03-a03-b05 | m03-a03-s05 / p. 4 | Instalar MCP Brasil no projeto e consultar um CNPJ público, comparando campos com a origem. | Operação real e fonte identificadas; campos confrontados, falhas e ausências preservadas. |
| m03-a03-b06 | m03-a03-s06 / p. 5 | Executar erro de formato e preencher registro com resultado/fonte/limites. | Relatório distingue consulta correta, erro e campos ausentes sem concluir parecer fiscal. |
| m03-a03-b03 | m03-a03-s03 / p. 6 | Orientar a atividade com uma ferramenta relevante ao processo do aluno; registrar origem e teste. | Ferramenta real e versão registradas; saída coincide com fonte e erro não fabrica cadastro. |

## m03-a03-b01 — Procurar a operação necessária

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Começar pelo site/documentação do serviço; depois mostrar um diretório e a fonte de um projeto. | slides/m03-a03.pptx e slides/m03-a03.pdf, página 1, ID m03-a03-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a03-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a03-b01. Sem trilha prevista. |

**Estado inicial:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Entrada/material:** apoio/guia-conexoes.md, apoio/ficha-inspecao-mcp.md, apoio/registro-testes.md

**Passos de captura:**
1. Começar pelo site/documentação do serviço; depois mostrar um diretório e a fonte de um projeto.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Serviço, operação necessária, origem e manutenção do conector são identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a03-b01; SHA-256 0ef4b7f193e06a831f722514fa70a65f9176bff4cc4e29fa6d24b2eaf5b87091.

**Função visual:** Começar pelo site/documentação do serviço; depois mostrar um diretório e a fonte de um projeto.


## m03-a03-b04 — Diretório descobre; origem explica

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Inspecionar o repositório Mcp-Brasil/mcp-brasil e registrar versão/origem antes de instalar. | slides/m03-a03.pptx e slides/m03-a03.pdf, página 2, ID m03-a03-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a03-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a03-b04. Sem trilha prevista. |

**Estado inicial:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Entrada/material:** apoio/guia-conexoes.md, apoio/ficha-inspecao-mcp.md, apoio/registro-testes.md

**Passos de captura:**
1. Definir tarefa de consulta cadastral.
2. Ler README, dependências e ferramenta BrasilAPI.
3. Pedir plano de instalação limitado ao projeto.
4. Registrar versão ou commit.

**Saída e conferência:** Escolha justificada por tarefa, operações, origem e acesso.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a03-b04; SHA-256 c5955871a3eaffe3ff11e666db021e36e9b959b67f21ea89c65874e705d7cb37.

**Função visual:** Inspecionar o repositório Mcp-Brasil/mcp-brasil e registrar versão/origem antes de instalar.


## m03-a03-b02 — O exemplo do MCP Brasil

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Identificar o projeto Mcp-Brasil/mcp-brasil e conferir a instalação em ambiente de exercício antes de consultar o CNPJ público do exemplo. Não substituir a execução MCP por uma aba de navegador sem explicar. | slides/m03-a03.pptx e slides/m03-a03.pdf, página 3, ID m03-a03-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a03-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a03-b02. Sem trilha prevista. |

**Estado inicial:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Entrada/material:** apoio/guia-conexoes.md, apoio/ficha-inspecao-mcp.md, apoio/registro-testes.md

**Passos de captura:**
1. Identificar o projeto Mcp-Brasil/mcp-brasil e conferir a instalação em ambiente de exercício antes de consultar o CNPJ público do exemplo. Não substituir a execução MCP por uma aba de navegador sem explicar.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Chamada MCP retorna campos cadastrais conferidos com a referência; falha é registrada como falha.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a03-b02; SHA-256 c0d9a9245546357e1e94beea4d83c64eb97849950cd9bbf45ed1a98e6f092ad1.

**Função visual:** Identificar o projeto Mcp-Brasil/mcp-brasil e conferir a instalação em ambiente de exercício antes de consultar o CNPJ público do exemplo. Não substituir a execução MCP por uma aba de navegador sem explicar.


## m03-a03-b05 — Instalar e fazer o raio-x de um CNPJ

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Instalar MCP Brasil no projeto e consultar um CNPJ público, comparando campos com a origem. | slides/m03-a03.pptx e slides/m03-a03.pdf, página 4, ID m03-a03-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a03-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a03-b05. Sem trilha prevista. |

**Estado inicial:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Entrada/material:** apoio/guia-conexoes.md, apoio/ficha-inspecao-mcp.md, apoio/registro-testes.md

**Passos de captura:**
1. Conferir ambiente Python/uv e comando oficial atual.
2. Instalar isoladamente no projeto e descobrir ferramentas.
3. Consultar CNPJ público de ensaio sem gravação externa.
4. Comparar razão social, situação e município com a fonte.

**Saída e conferência:** Operação real e fonte identificadas; campos confrontados, falhas e ausências preservadas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a03-b05; SHA-256 d33ae6248aa715c4775e6e0827aab898a905b3e5d42b9b3196e02fac24257ddc.

**Função visual:** Instalar MCP Brasil no projeto e consultar um CNPJ público, comparando campos com a origem.


## m03-a03-b06 — Erro útil e critério de aceite

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar erro de formato e preencher registro com resultado/fonte/limites. | slides/m03-a03.pptx e slides/m03-a03.pdf, página 5, ID m03-a03-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a03-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a03-b06. Sem trilha prevista. |

**Estado inicial:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Entrada/material:** apoio/guia-conexoes.md, apoio/ficha-inspecao-mcp.md, apoio/registro-testes.md

**Passos de captura:**
1. Enviar entrada de CNPJ inválida no ambiente de teste.
2. Conferir que a resposta não fabrica cadastro.
3. Registrar teste normal e negativo e o diagnóstico.

**Saída e conferência:** Relatório distingue consulta correta, erro e campos ausentes sem concluir parecer fiscal.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a03-b06; SHA-256 f7fe9084cb8c0609309888b11b0d845a0662e42425c78ef00a8eb49c14a5c553.

**Função visual:** Executar erro de formato e preencher registro com resultado/fonte/limites.


## m03-a03-b03 — Instalar para resolver um problema

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Orientar a atividade com uma ferramenta relevante ao processo do aluno; registrar origem e teste. | slides/m03-a03.pptx e slides/m03-a03.pdf, página 6, ID m03-a03-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a03-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a03-b03. Sem trilha prevista. |

**Estado inicial:** Inspecionar versão atual, preparar ambiente isolado e escolher CNPJ público. Não usar dados privados ou tokens de APIs não necessárias.

**Entrada/material:** apoio/guia-conexoes.md, apoio/ficha-inspecao-mcp.md, apoio/registro-testes.md

**Passos de captura:**
1. Orientar a atividade com uma ferramenta relevante ao processo do aluno; registrar origem e teste.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Ferramenta real e versão registradas; saída coincide com fonte e erro não fabrica cadastro.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a03-b03; SHA-256 65d71032cd8042f3cfcdd39ad7351a307e0db9dc3f6aebbb1f9e92e284009d81.

**Função visual:** Orientar a atividade com uma ferramenta relevante ao processo do aluno; registrar origem e teste.


## Atividade e solução

Consultar CNPJ público por MCP Brasil e testar entrada inválida, guardando fonte e comparação de campos.

Ferramenta real e versão registradas; saída coincide com fonte e erro não fabrica cadastro.

## Materiais

- guia-conexoes.md
- ficha-inspecao-mcp.md
- registro-testes.md

# 3.4 — Criando seu próprio MCP (com api) / m03-a04

**Objetivo:** Criar e testar um MCP a partir de uma API documentada, incluindo autenticação e erros.

**Preparação:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Ensaio:** Teste automatizado local será registrado separadamente da captura no cliente e da integração com API externa.

### m03-a04-b01 — Quando faz sentido criar

Slide m03-a04-s01

Criar um MCP faz sentido em uma situação específica: você precisa que o agente use um sistema e não existe uma integração adequada. Antes de construir qualquer coisa, procure saber se o próprio serviço já mantém uma, ou se outra opção cobre a operação de que você precisa. Construir é o último passo dessa busca, não o primeiro.

Vamos começar pelos termos, porque eles se misturam com facilidade. API é a interface pela qual um programa conversa com outro. Um programa envia um pedido, por exemplo “qual foi a taxa de reembolso neste período”, e recebe uma resposta. MCP é um protocolo aberto de conexão. Ele apresenta operações, como as de uma API, de um jeito padronizado que o agente consegue descobrir e usar. “Descobrir” tem aqui um sentido bem prático: o agente enxerga a lista de ferramentas disponíveis, cada uma com um nome e uma descrição. Já conector é o nome que o aplicativo dá à integração que você vê e liga na tela, e ela pode usar MCP por baixo. Os três estão relacionados, mas não são a mesma coisa.

Neste exemplo, vamos usar um sistema de demonstração, com dados fictícios. Ele publica uma especificação OpenAPI. É um documento que descreve as operações disponíveis, os parâmetros que cada uma recebe, a autenticação, que é a forma de provar quem está pedindo, e as respostas possíveis. É esse documento que vamos entregar à ferramenta que cria o conector. Por isso a qualidade da documentação pesa tanto: ela é a base de tudo o que será construído.

Vou abrir a documentação do sistema de demonstração. Ela está aberta ao público, então podemos olhar as operações sem usar nenhum token, que é a chave de acesso do sistema. Nesta tela, observe só o que a documentação já nos diz sem precisar de acesso: o nome de cada operação, o que ela recebe e o que ela devolve. A credencial só vai importar mais adiante, quando formos chamar a API de verdade.

Com os termos esclarecidos, vamos ver de onde vem a ideia de construir um conector próprio e como decidir se vale a pena.

### m03-a04-b04 — Do caso Hotmart à decisão de construir

Slide m03-a04-s04

Um exemplo que vem da nossa equipe é o caso do Thales Laray. Segundo o relato dele, registrado na ementa e confirmado por mim para esta aula, foi criado um MCP interno para trabalhar com a Hotmart e, depois, houve um convite para colaborar no MCP oficial. Não tenho aqui datas nem números desse projeto, e não vou inventá-los. O caso é do Thales e do time dele; não vou transformá-lo em uma história minha.

O aprendizado que vamos aproveitar é a sequência da decisão. Primeiro existe uma necessidade real de acessar um sistema. Depois verificamos se já há uma integração adequada. Se não houver, procuramos a documentação da API e escolhemos uma operação pequena para começar. Criar uma conexão própria faz sentido quando resolve uma lacuna concreta, não apenas para ter mais uma ferramenta.

Na aula, vamos usar uma API local, que roda no seu computador, com dados fictícios. Isso permite repetir o procedimento sem uma conta comercial. Vou abrir a documentação OpenAPI dessa API local e apontar a única operação que vamos usar: uma consulta de leitura, que devolve a taxa de reembolso em um intervalo de datas definido. O objetivo é entender o caminho completo, da documentação à ferramenta criada e daí à resposta conferida.

Um cuidado de honestidade: esse exercício não reproduz nem comprova o projeto histórico da Hotmart. Ele é outro sistema, fictício, e dá a você uma forma controlada de praticar a mesma decisão de integração. Quando você levar o procedimento para o seu sistema, a conferência precisa ser refeita lá.

Agora que a decisão está clara, vamos definir exatamente o que o nosso conector vai fazer.

### m03-a04-b02 — Um conector pequeno e verificável

Slide m03-a04-s02

Não vamos expor todas as operações do sistema. Vamos começar por uma consulta pequena: a taxa de reembolso em um período definido. Um conector pequeno é mais fácil de conferir e dá menos acesso do que o necessário. A documentação já traz essa operação pronta, então não precisamos buscar todas as vendas e refazer a conta por conta própria.

Os dados deste ambiente são fictícios e têm datas fixas. Por isso, o intervalo será de treze de julho a onze de agosto de dois mil e vinte e seis. Se pedíssemos “últimos trinta dias” em outra data, a consulta poderia cair fora do período que a base cobre, e o resultado deixaria de ser comparável com o que está na aula.

Agora, o pedido ao criador de MCP. Ele precisa dizer quatro coisas. Primeira: qual documentação ler, que é o endereço do arquivo openapi.json do sistema de demonstração. Segunda: qual operação disponibilizar, só a consulta de taxa de reembolso. Terceira: onde o MCP vai rodar, que aqui é o seu computador. Quarta: como a credencial será recebida. Em palavras, o pedido fica assim: “Leia esta documentação. Crie uma ferramenta que apenas consulta a taxa de reembolso entre treze de julho e onze de agosto de dois mil e vinte e seis. Não crie nenhuma operação de escrita. O servidor roda localmente, e a credencial será recebida por configuração do ambiente.”

Sobre a credencial: o token entra fora do chat. Ele não aparece no texto da skill, numa captura de tela da aula, nem em arquivo que você vá distribuir. No pedido, você escreve apenas que a credencial virá da configuração, nunca o valor dela.

Com o conector preparado, conferimos duas coisas: os parâmetros que ele envia e a resposta que recebe. Uma ferramenta gerada sem erro não prova que a consulta está certa. E o número final precisa vir da fonte, não de um cálculo ou de um palpite do modelo.

Mesmo uma consulta de leitura pode envolver informação sensível, então conceda só o acesso necessário para essa operação. No próximo bloco, vamos ver a skill que faz essa construção a partir da documentação.

### m03-a04-b05 — A skill que constrói a partir da documentação

Slide m03-a04-s05

Uma skill é um conjunto de instruções, guardado em um arquivo chamado SKILL.md, que ensina o agente a seguir um procedimento. A divisão de papéis é esta: a skill descreve o procedimento, o modelo decide o que fazer em cada passo e a ferramenta executa. Vamos usar a skill de criação de MCP que vem no material da aula.

Antes, uma frase que circula e ajuda a lembrar: “API é a comida do MCP”. Ela mostra de onde vêm as operações, mas é só um jeito de lembrar. Uma API também pode ser usada por outros programas, sem MCP. O nosso conector vai transformar uma operação documentada em uma ferramenta que o agente consegue descobrir.

Primeiro passo: abra o arquivo SKILL.md da pasta criar-mcp-api e o openapi.json. Leia o que a skill pede como entrada. Ela recebe a documentação, a operação escolhida, o ambiente onde o servidor vai rodar e os critérios de teste.

Segundo passo: peça a criação de uma única ferramenta, sem escrita. Peça também que o agente leia a especificação antes de gerar o programa do servidor. Ler primeiro evita que ele invente parâmetros. O trabalho precisa preservar os parâmetros de data e o formato da resposta. Não há motivo para expor operações de escrita ou exclusão, e é por isso que o pedido diz que elas não existem.

Sobre a credencial: a do exercício é fictícia e serve apenas para testar a autorização local. Num sistema real, o segredo fica na configuração protegida do ambiente, fora do chat e dos materiais.

Terceiro passo: inicie a API local e o servidor MCP em um ambiente isolado, ou seja, separado do restante do seu computador, para que o teste não toque em nada que não seja do exercício. Quando o aplicativo pedir permissão para executar algo, leia o que será feito antes de aprovar. Aqui o efeito é pequeno, porque é uma consulta de leitura em dados fictícios. Numa operação que altera informações, a aprovação deve ser dada caso a caso. Como o servidor roda no seu computador, ele só responde enquanto a máquina e o processo estiverem ativos.

Quarto passo: conecte o MCP no cliente compatível, que é o aplicativo em que você conversa com o agente e que aceita MCP. Confira se a ferramenta aparece e se a descrição dela diz exatamente o que ela consulta.

Agora faça a chamada com as datas do exercício. O resultado vem da API; o agente não precisa reconstruir a taxa lendo todas as vendas. Compare os parâmetros enviados, a resposta recebida e a documentação. Gerar um servidor sem erro é só uma etapa. Descobrir e usar a ferramenta é a próxima, e a conferência vem logo a seguir.

### m03-a04-b06 — Testar, registrar e adaptar ao seu sistema

Slide m03-a04-s06

Vamos conferir o resultado. Nos dados fictícios, o período é de treze de julho a onze de agosto de dois mil e vinte e seis. O resultado esperado para esse período é de cento e vinte pedidos e seis reembolsos, o que dá uma taxa de cinco por cento. A saída também precisa identificar o período consultado. Confira esses campos, não apenas o número final, porque uma taxa certa para um período errado continua sendo um erro.

Primeiro, o caso normal. Faça a consulta pela ferramenta e compare com a chamada direta à API local, feita fora do MCP, que serve de referência. Os dois resultados precisam coincidir.

Depois, dois erros. O primeiro é a ausência de credencial. Sem a credencial de exercício, a API deve recusar o acesso, e a ferramenta deve dizer que faltou autorização, sem inventar uma taxa. O segundo é um intervalo fora do contrato, isto é, fora do que a documentação define como válido, por exemplo uma data inicial posterior à final. A ferramenta deve explicar que a entrada é inválida, também sem inventar uma taxa. Em erro, o comportamento correto é explicar a falha e parar.

Guarde os resultados e a configuração usada no arquivo registro-testes.md. Registre também o que ficou sem teste. Não repita uma operação de escrita como tentativa de corrigir um erro de leitura; nossa ferramenta nem precisa oferecer escrita. E não apresente este teste como um teste da Hotmart: ele vale apenas para a API local fictícia.

Agora, a sua atividade. Escolha uma API que você pode usar, procure antes um MCP existente e selecione uma operação de leitura. Escreva a entrada, a saída e o critério de conferência. Se tiver documentação e ambiente de teste disponíveis, crie o MCP e execute os casos normal e de erro. Se faltar acesso ao sistema, use a API local fornecida para concluir a construção prática e registre o que falta para levar ao seu ambiente. A especificação sozinha é o plano; o teste da conexão exige a chamada real. É essa diferença que você deve registrar ao apresentar seu resultado.

### m03-a04-b03 — O teste de conclusão

Slide m03-a04-s03

Para concluir, o teste tem três verificações. A primeira: o agente encontrou a ferramenta. A segunda: usou o período certo. A terceira: devolveu os dados que vieram da API. Compare a resposta com a operação de referência. Depois, confirme o caso sem credencial: o resultado deve explicar a falha, sem inventar um número.

Sobre rodar local ou remoto, a escolha depende de onde você precisa usar o conector. Um servidor local roda no seu computador e só funciona com a máquina ligada e o processo ativo. Um servidor remoto fica em outro lugar e é acessado por um endereço, e depende de quem o mantém e de como a autenticação é feita. Não vamos construir os dois agora. Faça um caminho funcionar e anote do que ele depende.

Seu exercício: construa e teste a ferramenta com a API local fornecida; depois escolha uma operação de leitura do seu sistema e encontre a documentação dela. Antes de criar qualquer coisa, escreva a entrada, a saída esperada e como você vai conferir a resposta. Pause o vídeo e faça isso.

Na próxima aula, vamos combinar esse acesso com um procedimento de trabalho.

# 3.4 — Criando seu próprio MCP (com api)

ID m03-a04. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Dependências e ensaio:** Teste automatizado local será registrado separadamente da captura no cliente e da integração com API externa.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m03-a04-b01 | m03-a04-s01 / p. 1 | Abrir a documentação do sistema demonstrativo e mostrar as operações públicas sem token em tela. | Contrato da operação, parâmetros e autenticação são identificados. |
| m03-a04-b04 | m03-a04-s04 / p. 2 | Atribuir caso Hotmart a Thales e apresentar a API fictícia de exercício. | Relato corretamente atribuído e exemplo local distinguido do sistema Hotmart. |
| m03-a04-b02 | m03-a04-s02 / p. 3 | Usar https://demo-mcp.escoladeautomacao.com/openapi.json. Solicitar ao criador de MCP apenas consulta de taxa de reembolso, com token fornecido fora do chat e sem exposição. Intervalo fixo 2026-07-13–2026-08-11. | Conector mínimo é criado e consulta a operação com o intervalo fixo. |
| m03-a04-b05 | m03-a04-s05 / p. 4 | Usar a skill de criação com OpenAPI e conectar o MCP de leitura à API local. | Ferramenta criada/descoberta e resposta real da API local conferida. |
| m03-a04-b06 | m03-a04-s06 / p. 5 | Conferir 120 pedidos/6 reembolsos/5%, ausência de credencial e intervalo inválido. | Resposta normal correta, erros explícitos e nenhuma taxa inventada; execução local separada de acesso ao sistema do aluno. |
| m03-a04-b03 | m03-a04-s03 / p. 6 | Comparar a resposta do conector com a operação de referência; testar ausência de credencial sem divulgar valor e registrar limitações. | 120 pedidos, 6 reembolsos e 5% no período fixo; acesso ausente e entrada inválida não geram resultado inventado. |

## m03-a04-b01 — Quando faz sentido criar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir a documentação do sistema demonstrativo e mostrar as operações públicas sem token em tela. | slides/m03-a04.pptx e slides/m03-a04.pdf, página 1, ID m03-a04-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a04-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a04-b01. Sem trilha prevista. |

**Estado inicial:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Entrada/material:** apoio/api-demo/LEIA-ME.md, apoio/api-demo/openapi.json, apoio/criar-mcp-api/SKILL.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir a documentação do sistema demonstrativo e mostrar as operações públicas sem token em tela.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Contrato da operação, parâmetros e autenticação são identificados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a04-b01; SHA-256 e3e935fc5b9c7000f45d996d347082ce2ab051ce1c6aea759f48a3c68d97e64a.

**Função visual:** Abrir a documentação do sistema demonstrativo e mostrar as operações públicas sem token em tela.


## m03-a04-b04 — Do caso Hotmart à decisão de construir

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Atribuir caso Hotmart a Thales e apresentar a API fictícia de exercício. | slides/m03-a04.pptx e slides/m03-a04.pdf, página 2, ID m03-a04-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a04-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a04-b04. Sem trilha prevista. |

**Estado inicial:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Entrada/material:** apoio/api-demo/LEIA-ME.md, apoio/api-demo/openapi.json, apoio/criar-mcp-api/SKILL.md, apoio/registro-testes.md

**Passos de captura:**
1. Apresentar relato confirmado pelo professor, sem datas ou métricas inventadas.
2. Abrir documentação OpenAPI da API local.
3. Apontar única operação de leitura escolhida.

**Saída e conferência:** Relato corretamente atribuído e exemplo local distinguido do sistema Hotmart.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a04-b04; SHA-256 4465c8eb77366bd74312929f9ed5723fa4af9d99b9db74508228b99dc2e3cdcd.

**Função visual:** Atribuir caso Hotmart a Thales e apresentar a API fictícia de exercício.


## m03-a04-b02 — Um conector pequeno e verificável

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar https://demo-mcp.escoladeautomacao.com/openapi.json. Solicitar ao criador de MCP apenas consulta de taxa de reembolso, com token fornecido fora do chat e sem exposição. Intervalo fixo 2026-07-13–2026-08-11. | slides/m03-a04.pptx e slides/m03-a04.pdf, página 3, ID m03-a04-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a04-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a04-b02. Sem trilha prevista. |

**Estado inicial:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Entrada/material:** apoio/api-demo/LEIA-ME.md, apoio/api-demo/openapi.json, apoio/criar-mcp-api/SKILL.md, apoio/registro-testes.md

**Passos de captura:**
1. Usar https://demo-mcp.escoladeautomacao.com/openapi.json. Solicitar ao criador de MCP apenas consulta de taxa de reembolso, com token fornecido fora do chat e sem exposição. Intervalo fixo 2026-07-13–2026-08-11.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Conector mínimo é criado e consulta a operação com o intervalo fixo.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a04-b02; SHA-256 731f4045c6905e3b6ef136f9af184453a7cf88ee0ec35be027b9e203eb1c614d.

**Função visual:** Usar https://demo-mcp.escoladeautomacao.com/openapi.json. Solicitar ao criador de MCP apenas consulta de taxa de reembolso, com token fornecido fora do chat e sem exposição. Intervalo fixo 2026-07-13–2026-08-11.


## m03-a04-b05 — A skill que constrói a partir da documentação

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar a skill de criação com OpenAPI e conectar o MCP de leitura à API local. | slides/m03-a04.pptx e slides/m03-a04.pdf, página 4, ID m03-a04-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a04-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a04-b05. Sem trilha prevista. |

**Estado inicial:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Entrada/material:** apoio/api-demo/LEIA-ME.md, apoio/api-demo/openapi.json, apoio/criar-mcp-api/SKILL.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir criar-mcp-api/SKILL.md e openapi.json.
2. Pedir criação de uma única ferramenta, sem escrita.
3. Iniciar API local e servidor MCP em ambiente isolado.
4. Descobrir ferramenta e consultar período fixo.

**Saída e conferência:** Ferramenta criada/descoberta e resposta real da API local conferida.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a04-b05; SHA-256 cc87912383ddd12a380ae5192c578f602bb694d0e13838ebf06fcf194f6b8881.

**Função visual:** Usar a skill de criação com OpenAPI e conectar o MCP de leitura à API local.


## m03-a04-b06 — Testar, registrar e adaptar ao seu sistema

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir 120 pedidos/6 reembolsos/5%, ausência de credencial e intervalo inválido. | slides/m03-a04.pptx e slides/m03-a04.pdf, página 5, ID m03-a04-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a04-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a04-b06. Sem trilha prevista. |

**Estado inicial:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Entrada/material:** apoio/api-demo/LEIA-ME.md, apoio/api-demo/openapi.json, apoio/criar-mcp-api/SKILL.md, apoio/registro-testes.md

**Passos de captura:**
1. Executar caso normal e comparar com a operação HTTP da API local.
2. Testar ausência de credencial e datas inválidas.
3. Registrar resultados e limitações; não apresentar como teste Hotmart.

**Saída e conferência:** Resposta normal correta, erros explícitos e nenhuma taxa inventada; execução local separada de acesso ao sistema do aluno.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a04-b06; SHA-256 4e5e50001f61fee64952f8166236b0cfe9c427a216cd396ff0b8e50a62d54511.

**Função visual:** Conferir 120 pedidos/6 reembolsos/5%, ausência de credencial e intervalo inválido.


## m03-a04-b03 — O teste de conclusão

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar a resposta do conector com a operação de referência; testar ausência de credencial sem divulgar valor e registrar limitações. | slides/m03-a04.pptx e slides/m03-a04.pdf, página 6, ID m03-a04-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a04-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a04-b03. Sem trilha prevista. |

**Estado inicial:** Preparar API local, OpenAPI, skill criadora e cliente MCP. Relato Hotmart atribuído a Thales, confirmado por Leo em 02/11/2026.

**Entrada/material:** apoio/api-demo/LEIA-ME.md, apoio/api-demo/openapi.json, apoio/criar-mcp-api/SKILL.md, apoio/registro-testes.md

**Passos de captura:**
1. Comparar a resposta do conector com a operação de referência; testar ausência de credencial sem divulgar valor e registrar limitações.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** 120 pedidos, 6 reembolsos e 5% no período fixo; acesso ausente e entrada inválida não geram resultado inventado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a04-b03; SHA-256 86701f20764afe4ab0afa8225cb4ae2ee3b23599dc5926d9162acbdc3657b1ca.

**Função visual:** Comparar a resposta do conector com a operação de referência; testar ausência de credencial sem divulgar valor e registrar limitações.


## Atividade e solução

Construir e testar a ferramenta com a API local fornecida; depois especificar a operação equivalente do próprio sistema.

120 pedidos, 6 reembolsos e 5% no período fixo; acesso ausente e entrada inválida não geram resultado inventado.

## Materiais

- api-demo/LEIA-ME.md
- api-demo/openapi.json
- criar-mcp-api/SKILL.md
- registro-testes.md

# 3.5 — MCP + Skill = a primeira versão do seu time de IA / m03-a05

**Objetivo:** Combinar skill de prospecção e Apify, controlando entrada, custo, execução e conferência do dataset.

**Preparação:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Ensaio:** Execução paga Apify e dataset real não autorizados nesta produção; roteiro preserva a demonstração completa e o requisito de ensaio.

### m03-a05-b01 — Acesso com uma finalidade

Slide m03-a05-s01

Nesta aula vamos juntar duas peças das aulas anteriores. O MCP é o jeito padronizado de conectar a IA a outro serviço, e dá acesso às operações que esse serviço oferece. A skill é o procedimento escrito: diz o que fazer, em que ordem e como conferir. Juntas, elas formam uma unidade de trabalho. Chega uma entrada, a IA usa a ferramenta seguindo o procedimento e sai uma entrega que você confere por critérios definidos antes.

O exemplo é uma pesquisa de empresas para prospecção, isto é, para encontrar possíveis clientes. O objetivo é montar uma lista pequena, que dê para revisar linha por linha. Não vamos enviar mensagem para ninguém nem montar campanha. A aula termina na lista conferida.

O fluxo tem quatro passos. Primeiro, o critério: que tipo de empresa procurar e qual região considerar. Segundo, a consulta ao Apify, uma plataforma que oferece programas de coleta de dados, chamados de Actors. Terceiro, a lista, com a origem de cada informação. Quarto, a conferência.

Se um dado não veio da fonte, o campo fica em branco. A skill não completa a lista com informação inventada, porque um campo vazio é fácil de notar, e um campo inventado parece correto.

Depois de montar a lista, vamos abrir o resultado e compará-lo com o critério que definimos no começo.

### m03-a05-b04 — O contrato da skill de prospecção

Slide m03-a05-s04

Vamos escrever o contrato da skill de prospecção: o que ela recebe, o que faz e o que entrega. Abra o arquivo prospeccao-especificacao.md. Antes de qualquer busca, preenchemos quatro campos: segmento, região, amostra e teto de gasto.

Segmento e região dizem quem procurar. Um exemplo: clínicas de fisioterapia em Campinas. A amostra é a quantidade pequena que queremos, como dez empresas. O teto de gasto é o valor máximo, em dólares, que você aprovou para esta pesquisa. Esses quatro campos são a entrada. A saída tem empresa, site quando existir, fonte e observações. Não buscamos contato pessoal nem enriquecemos dados sem necessidade, porque cada dado a mais aumenta o custo e o cuidado que a lista exige.

Agora o procedimento. A skill começa conferindo a entrada. Se a região está vaga, ela pergunta. Se o orçamento não foi definido para uma execução paga, ela para antes de executar. Depois pesquisa um Actor adequado, lê o contrato dele e verifica se a saída atende ao objetivo. O Actor é cada programa de coleta publicado no catálogo do Apify, e o contrato dele é a documentação que diz o que ele recebe, o que devolve e quanto custa. Usar o primeiro resultado do catálogo sem ler essas condições transfere uma decisão importante para o acaso.

Um termo vai aparecer bastante: schema. É a descrição dos campos que o Actor aceita como entrada, com o nome de cada campo e o que ele espera receber. Funciona como o formulário que o programa exige.

Separe o critério comercial da operação técnica. O segmento e a região vêm de quem conhece o trabalho, que é você. O schema diz como passar essas informações ao programa. A skill faz essa tradução e registra a origem do que foi encontrado. Se um site não veio na fonte, ele não aparece como se tivesse sido verificado.

Uma observação sobre acesso. Procurar Actors e ler a documentação pode funcionar sem conta, quando a conexão com o Apify expõe só essas ferramentas de descoberta. Executar um Actor ou abrir resultados guardados exige autenticação. Por isso, sem conta ou sem verba, ainda dá para ensaiar a descoberta e a interpretação, mas isso não substitui uma execução real.

O objetivo continua sendo uma lista pequena que alguém consegue revisar, não o maior número de linhas possível.

### m03-a05-b02 — Skill de pesquisa com Apify

Slide m03-a05-s02

Com o contrato escrito, a skill vai ao Apify. O candidato deste exemplo é o Actor compass/crawler-google-places. Candidato quer dizer que ainda não foi escolhido: primeiro conferimos se ele serve. Abra a página dele e leia o formato de entrada que ele aceita e o custo. Faça isso agora, porque nomes de campos e preços podem mudar, e vale o que está na documentação atual, não o que alguém lembra. Isso vem antes de executar. Encontrar um Actor no catálogo não quer dizer que a pesquisa já foi feita.

Na demonstração, a amostra precisa ser pequena. A entrada pode ter um campo de quantidade, e ele ajuda a limitar os resultados. Mas não trate esse campo como teto de cobrança. Os limites da execução ficam nas opções de chamada do MCP, os callOptions. Por exemplo: máximo de itens, gasto total máximo e tempo limite, que no contrato aparecem como maxItems, maxTotalChargeUsd e timeout. Confira no contrato atual quais existem e o que cada um controla. E deixe desligados os enriquecimentos e as coletas que o exercício não precisa, porque cada extra pode aumentar o custo e trazer dados que não pedimos.

Terminada a execução, falta uma etapa: buscar o dataset de saída, que é a tabela de resultados guardada pelo Apify, e conferir. Um ID de execução, ou uma resposta dizendo que a tarefa começou, ainda não é a lista pronta. O próximo bloco mostra essa sequência.

Com a tabela em mãos, a skill organiza empresa, site quando houver, origem e observações de verificação. Depois, abrimos alguns resultados e comparamos com a fonte. Duplicatas, empresas fora da região e dados ausentes são problemas do resultado. Registre cada um deles. A formatação da lista não deve escondê-los.

### m03-a05-b05 — Executar e buscar o resultado certo

Slide m03-a05-s05

Vamos preparar a chamada. Com o Actor escolhido, preencha a entrada conforme o schema atual: segmento, região e a quantidade pequena da amostra. Depois confira as opções de chamada, os callOptions. O máximo de itens solicitado ao programa não é necessariamente um teto de cobrança. Os limites de execução ficam onde o contrato do MCP indica, como nas opções de quantidade, tempo e gasto total.

Antes de aprovar, leia os limites aplicáveis ao Actor e ao serviço. Se o limite que você quer não puder ser garantido pelo contrato, ajuste o ensaio, por exemplo reduzindo a amostra, ou não execute. A conta e os créditos precisam estar sob controle de quem autorizou a pesquisa.

Executar um Actor exige autenticação. O Apify recomenda a autorização por OAuth, que é o fluxo em que você entra na sua conta e libera o acesso à conexão. Não cole senha nem chave de acesso na conversa ou no arquivo da skill. A execução paga é uma passagem em que você aprova: confirme que a entrada está validada, que o teto está definido e que a autorização foi dada. Só então execute, e apenas se houver um ambiente autorizado para isso.

Depois da chamada, observe o estado da execução. A execução também se chama run. Um identificador de run indica que há uma execução para acompanhar; não significa que a lista está pronta. Aguarde o estado apropriado, que indica o término, e busque o dataset de saída usando a referência devolvida. Abra a tabela, confira a quantidade de linhas e os campos e compare algumas empresas com a origem.

Se houver falha, registre o que aconteceu antes de repetir. Uma execução pode ter consumido recursos mesmo sem a entrega final esperada. Consultar o estado e reconciliar o resultado ajuda a evitar uma segunda execução desnecessária. Registre também o consumo que você observou. E não apresente dados ilustrativos do material como resultado de uma coleta real.

### m03-a05-b06 — Conferência da lista e ponte para o time

Slide m03-a05-s06

Agora passe a lista pelo critério da skill, com quatro perguntas. A empresa pertence ao segmento? Está na região pedida? Há duplicatas? O site foi informado pela fonte ou apenas sugerido? Marque o que precisa de verificação antes de usar a lista no trabalho.

Se o resultado tiver dez linhas e três estiverem fora da região, não esconda essas três para dizer que a coleta deu certo. Registre o problema e identifique a causa de cada divergência. Pode ser o parâmetro, quando a região foi escrita de forma ampla demais. Pode ser a cobertura do Actor, quando ele não traz aquele tipo de empresa. Ou pode ser a interpretação do resultado, quando a skill tratou uma sugestão como confirmação. Essa informação orienta a correção.

Depois, registre no registro-testes.md o status da integração. Separe o que foi execução real do que foi ensaio ilustrativo. Se você não tem conta ou orçamento de teste, use o arquivo prospeccao-exemplo.csv, que traz dados ilustrativos, para treinar a leitura e a conferência. Nesse caso, marque a integração com o Apify como não executada, porque só o resultado real do serviço comprova a consulta. A próxima dependência, então, é uma execução real com conta e teto aprovados. Em nenhum dos casos algum contato é acionado.

Falta dizer o que esse resultado representa, e o que você faz com ele.

### m03-a05-b03 — Uma unidade de trabalho ainda não é o time inteiro

Slide m03-a05-s03

Repare no que mudou: você não orientou cada chamada nem copiou respostas para montar a lista. O procedimento diz quando consultar, o que aproveitar e como conferir a entrega.

Isso ainda não é o time completo do próximo módulo. Aqui, uma skill usa uma ferramenta para fazer uma tarefa. Depois, vamos coordenar várias skills, cada uma com sua responsabilidade e seus pontos de aprovação.

A missão deste módulo é esta: una uma skill a uma consulta que faça sentido para o seu processo e mostre onde está a prova do resultado. Configure a skill e execute uma amostra pequena, apenas em conta e orçamento de teste que você tenha disponíveis. Depois confira a lista e registre dois casos de erro, como uma duplicata e uma empresa fora da região. Você terminou quando conseguir mostrar a entrada validada, o orçamento respeitado no contrato, o resultado real identificado e uma amostra comparada com a origem, sem nenhuma mensagem enviada.

Para ensaiar, você pode usar dados ilustrativos, desde que diga que são ilustrativos. Só uma execução real comprova que o serviço foi consultado.

Com essa base, no próximo módulo vamos desenhar o processo de ponta a ponta e decidir em quais passagens a pessoa continua aprovando. Um envio de mensagem a uma empresa, por exemplo, seria uma dessas passagens.

# 3.5 — MCP + Skill = a primeira versão do seu time de IA

ID m03-a05. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Dependências e ensaio:** Execução paga Apify e dataset real não autorizados nesta produção; roteiro preserva a demonstração completa e o requisito de ensaio.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m03-a05-b01 | m03-a05-s01 / p. 1 | Apresentar o fluxo de prospecção: critério → consulta Apify → lista com origem → conferência. Não enviar mensagens. | Fluxo critério → consulta → lista com origem → conferência está delimitado. |
| m03-a05-b04 | m03-a05-s04 / p. 2 | Ler prospeccao-especificacao.md e preencher segmento, região, amostra e teto de gasto. | Contrato separa perfil de busca, parâmetros técnicos, limites e critérios. |
| m03-a05-b02 | m03-a05-s02 / p. 3 | Usar apoio/prospeccao-especificacao.md. Actor candidato compass/crawler-google-places; conferir input e custo atuais, limitar a execução, consultar dataset após conclusão. Ensaio real pendente. | Execução limitada retorna run e dataset reais; lista ilustrativa não é apresentada como extração. |
| m03-a05-b05 | m03-a05-s05 / p. 4 | Preparar chamada Apify com limites e, havendo ambiente autorizado, executar amostra e ler dataset. | Dataset real aberto e conferido; run/limite/cobrança não confundidos com lista pronta. |
| m03-a05-b06 | m03-a05-s06 / p. 5 | Conferir lista com critérios e registrar o que é execução real e o que é ensaio ilustrativo. | Lista revisada com rastreabilidade; nenhum contato acionado nem resultado simulado apresentado como coleta. |
| m03-a05-b03 | m03-a05-s03 / p. 6 | Conferir a entrega e orientar a missão do módulo. Deixar claro que registros ilustrativos não são resultados de uma extração real. | Entrada validada; orçamento respeitado no contrato; resultado real identificado e amostra comparada; sem envio de mensagens. |

## m03-a05-b01 — Acesso com uma finalidade

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar o fluxo de prospecção: critério → consulta Apify → lista com origem → conferência. Não enviar mensagens. | slides/m03-a05.pptx e slides/m03-a05.pdf, página 1, ID m03-a05-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a05-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a05-b01. Sem trilha prevista. |

**Estado inicial:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Entrada/material:** apoio/prospeccao-especificacao.md, apoio/prospeccao-exemplo.csv, apoio/registro-testes.md

**Passos de captura:**
1. Apresentar o fluxo de prospecção: critério → consulta Apify → lista com origem → conferência. Não enviar mensagens.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Fluxo critério → consulta → lista com origem → conferência está delimitado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a05-b01; SHA-256 689a787c40473f35deb682e198e15a1c04d7d534fc3e094c74034d5c767088d1.

**Função visual:** Apresentar o fluxo de prospecção: critério → consulta Apify → lista com origem → conferência. Não enviar mensagens.


## m03-a05-b04 — O contrato da skill de prospecção

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Ler prospeccao-especificacao.md e preencher segmento, região, amostra e teto de gasto. | slides/m03-a05.pptx e slides/m03-a05.pdf, página 2, ID m03-a05-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a05-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a05-b04. Sem trilha prevista. |

**Estado inicial:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Entrada/material:** apoio/prospeccao-especificacao.md, apoio/prospeccao-exemplo.csv, apoio/registro-testes.md

**Passos de captura:**
1. Definir perfil e saída antes de buscar Actor.
2. Conferir schema e preço do candidato.
3. Parar se faltar orçamento para operação paga.

**Saída e conferência:** Contrato separa perfil de busca, parâmetros técnicos, limites e critérios.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a05-b04; SHA-256 13b94e4d93b9a8f13a49a20d04d4f4a9cb3c0f703c74b3fcf03d1240d871991e.

**Função visual:** Ler prospeccao-especificacao.md e preencher segmento, região, amostra e teto de gasto.


## m03-a05-b02 — Skill de pesquisa com Apify

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar apoio/prospeccao-especificacao.md. Actor candidato compass/crawler-google-places; conferir input e custo atuais, limitar a execução, consultar dataset após conclusão. Ensaio real pendente. | slides/m03-a05.pptx e slides/m03-a05.pdf, página 3, ID m03-a05-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a05-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a05-b02. Sem trilha prevista. |

**Estado inicial:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Entrada/material:** apoio/prospeccao-especificacao.md, apoio/prospeccao-exemplo.csv, apoio/registro-testes.md

**Passos de captura:**
1. Usar apoio/prospeccao-especificacao.md. Actor candidato compass/crawler-google-places; conferir input e custo atuais, limitar a execução, consultar dataset após conclusão. Ensaio real pendente.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Execução limitada retorna run e dataset reais; lista ilustrativa não é apresentada como extração.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a05-b02; SHA-256 2e0254fc9a4a3c3a3630784fcd048ec4a639c2a1b2f54bf9b1280fa91c7f4f26.

**Função visual:** Usar apoio/prospeccao-especificacao.md. Actor candidato compass/crawler-google-places; conferir input e custo atuais, limitar a execução, consultar dataset após conclusão. Ensaio real pendente.


## m03-a05-b05 — Executar e buscar o resultado certo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preparar chamada Apify com limites e, havendo ambiente autorizado, executar amostra e ler dataset. | slides/m03-a05.pptx e slides/m03-a05.pdf, página 4, ID m03-a05-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a05-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a05-b05. Sem trilha prevista. |

**Estado inicial:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Entrada/material:** apoio/prospeccao-especificacao.md, apoio/prospeccao-exemplo.csv, apoio/registro-testes.md

**Passos de captura:**
1. Verificar schema e callOptions do contrato atual.
2. Conferir autorização e teto antes da operação paga.
3. Acompanhar run e buscar dataset pelo ID retornado.
4. Comparar amostra com origem e registrar falhas/consumo observado.

**Saída e conferência:** Dataset real aberto e conferido; run/limite/cobrança não confundidos com lista pronta.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a05-b05; SHA-256 af75bde5ad4df8306ae8748f469598759e289a2b856505fbbed6426fb28053e9.

**Função visual:** Preparar chamada Apify com limites e, havendo ambiente autorizado, executar amostra e ler dataset.


## m03-a05-b06 — Conferência da lista e ponte para o time

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir lista com critérios e registrar o que é execução real e o que é ensaio ilustrativo. | slides/m03-a05.pptx e slides/m03-a05.pdf, página 5, ID m03-a05-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a05-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a05-b06. Sem trilha prevista. |

**Estado inicial:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Entrada/material:** apoio/prospeccao-especificacao.md, apoio/prospeccao-exemplo.csv, apoio/registro-testes.md

**Passos de captura:**
1. Revisar segmento, região, duplicatas e origem.
2. Identificar causa de cada divergência.
3. Registrar status da integração e próxima dependência.

**Saída e conferência:** Lista revisada com rastreabilidade; nenhum contato acionado nem resultado simulado apresentado como coleta.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a05-b06; SHA-256 e8f51c9617b9a021b1f1f5a0a724d68022cf11b7560e34e6d99e874a865d79cf.

**Função visual:** Conferir lista com critérios e registrar o que é execução real e o que é ensaio ilustrativo.


## m03-a05-b03 — Uma unidade de trabalho ainda não é o time inteiro

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir a entrega e orientar a missão do módulo. Deixar claro que registros ilustrativos não são resultados de uma extração real. | slides/m03-a05.pptx e slides/m03-a05.pdf, página 6, ID m03-a05-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m03-a05-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m03-a05-b03. Sem trilha prevista. |

**Estado inicial:** Preparar Actor, schema, conta e teto de teste aprovado. Sem verba/conta, ensaiar só descoberta e interpretação, com execução marcada NOT_RUN.

**Entrada/material:** apoio/prospeccao-especificacao.md, apoio/prospeccao-exemplo.csv, apoio/registro-testes.md

**Passos de captura:**
1. Conferir a entrega e orientar a missão do módulo. Deixar claro que registros ilustrativos não são resultados de uma extração real.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Entrada validada; orçamento respeitado no contrato; resultado real identificado e amostra comparada; sem envio de mensagens.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m03-a05-b03; SHA-256 41ff2ce0bf25ce01a173970384bb48840a7f59209a0c0a407fde6ca3c4d4b34b.

**Função visual:** Conferir a entrega e orientar a missão do módulo. Deixar claro que registros ilustrativos não são resultados de uma extração real.


## Atividade e solução

Configurar skill e executar amostra apenas em conta/orçamento de teste disponíveis; conferir lista e dois casos de erro.

Entrada validada; orçamento respeitado no contrato; resultado real identificado e amostra comparada; sem envio de mensagens.

## Materiais

- prospeccao-especificacao.md
- prospeccao-exemplo.csv
- registro-testes.md

# 4.1 — Como mapear processos para automatizar / m04-a01

**Objetivo:** Mapear um processo com cinco perguntas e definir responsabilidades e aprovações antes da automação.

**Preparação:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Ensaio:** Mapa é material didático; execução integral Zoom → Drive permanece requisito das próximas demonstrações.

### m04-a01-b01 — Desenhar o processo que será delegado

Slide m04-a01-s01

Nas aulas anteriores, você aprendeu a ensinar uma tarefa à IA e a dar a ela acesso a uma ferramenta. Agora o passo é coordenar várias etapas em sequência. E, antes de montar um time de IA, precisamos desenhar o processo que esse time vai executar. Desenhar, aqui, é simples: escrever num documento quem faz o quê, em que ordem e quem decide.

Vamos trabalhar com um caso fictício. O Ateliê Horizonte é o cliente, uma empresa inventada para este exercício. Do outro lado está o prestador, que é quem vai preparar a proposta. Uma reunião entre os dois termina, e o prestador precisa transformar o que foi conversado em uma proposta comercial. Entre a conversa e o documento pronto, existem decisões: o que o cliente pediu, o que entra no escopo, ou seja, o que de fato será entregue, qual é a referência de preço e quem precisa aprovar antes de a proposta sair.

Se essas decisões ficarem escondidas na cabeça de alguém, o time só vai automatizar a confusão, e mais depressa. Por isso, vamos começar por cinco perguntas, que responderemos num arquivo de apoio chamado mapa-processo.md, na pasta apoio. Abra esse arquivo agora. Ele ainda está vazio, e vamos preenchê-lo aos poucos, ao longo da aula. Os outros materiais são o especificacao-caso.md, com os dados do caso fictício, e o projeto-final.md, que traz os critérios de clareza para você conferir o seu próprio mapa no final.

Usaremos este mesmo exemplo até o fim do módulo. Então, antes das perguntas, vale entender que papel o mapa vai ter na construção do time.

### m04-a01-b04 — Uma orquestradora que você consegue explicar

Slide m04-a01-s04

Vamos montar o time do mesmo jeito que se organiza qualquer trabalho: com responsabilidades, entradas, saídas e decisões. Lembrando, uma skill é um conjunto de instruções que ensina a IA a fazer uma tarefa específica. A skill orquestradora é a que coordena a sequência: ela chama cada parte na ordem e leva o resultado de uma etapa para a seguinte. Você não precisa começar por uma arquitetura complexa, nem decorar vários nomes, para conseguir um primeiro resultado.

Mas simples não quer dizer deixar as regras implícitas. Se a pessoa que faz o trabalho decide um prazo, escolhe um preço e aprova um documento, precisamos saber em que momento cada uma dessas decisões acontece. Automatizar sem esse mapa só deixa a confusão mais rápida.

Nosso exemplo começa no fim de uma reunião e termina com uma proposta salva no Google Drive, que é a pasta de arquivos online do Google, aguardando aprovação. O Ateliê Horizonte é o cliente fictício, que precisa organizar pedidos. O prestador é quem prepara a proposta. Essa distinção importa porque o prazo desejado começa a contar quando o prestador recebe os dados enviados pelo cliente. Se você trocar os papéis, o prazo fica invertido.

Então, no quadro do mapa, faça três marcações. Primeiro, escreva quem é o cliente e quem é o prestador. Segundo, marque onde o processo começa, no fim da reunião, e onde termina, na proposta no Drive. Terceiro, marque as duas aprovações: a confirmação de escopo, antes de a proposta ser montada, e a aprovação da proposta, antes de qualquer envio ao cliente.

Quem recebe a saída precisa reconhecer o que foi concluído, o que ficou pendente e qual decisão está esperando. A orquestradora será útil quando coordenar esse percurso de forma compreensível, sem pedir que você faça manualmente cada passagem. Mas ela só consegue isso se o mapa estiver preenchido antes de criarmos qualquer arquivo de skill. Para preenchê-lo, usamos as cinco perguntas.

### m04-a01-b02 — As cinco perguntas

Slide m04-a01-s02

Primeira pergunta: o que dispara o processo? É o evento que faz tudo começar. No nosso caso, uma reunião termina e a transcrição, que é o texto escrito do que foi dito, fica disponível.

Segunda: o que entra e o que sai? Entram a transcrição, o modelo de proposta e a tabela de serviços. Sai uma proposta salva para aprovação, com os dados de origem identificados, para que se saiba de qual reunião ela veio.

Terceira: quais são as etapas, na ordem? Buscar a transcrição, organizar o pedido, confirmar o entendimento, preparar a proposta e entregar no destino.

Quarta: onde precisamos de uma ferramenta de fora? Ferramenta de fora é qualquer serviço que fica fora da conversa com a IA. Aqui, o Zoom é a origem da transcrição, e o Google Drive é o destino do documento. O acesso a cada serviço precisa ser configurado e conferido. Isso vamos fazer nas próximas aulas. Por ora, o mapa só registra que cada acesso é necessário.

Quinta: onde uma pessoa precisa decidir? Em dois pontos. O primeiro é antes de tratar como escopo um entendimento que pode estar errado. O segundo é antes de enviar a proposta ao cliente. Essas aprovações fazem parte do desenho do processo, e não um cuidado extra que se acrescenta depois.

Com as cinco respostas, as responsabilidades ficam visíveis. Analisar a reunião, montar a proposta e entregar para aprovação podem ser três habilidades, as skills, separadas. Cada uma recebe uma entrada e entrega uma saída para a próxima. Agora vamos escrever essas respostas no mapa, com os arquivos do caso à frente.

### m04-a01-b05 — Responder às cinco perguntas com uma entrada concreta

Slide m04-a01-s05

Vamos preencher as cinco perguntas com os arquivos do caso, uma de cada vez, no mapa-processo.md.

Na primeira, o disparo é a transcrição de uma reunião de teste ficar disponível. No exercício, essa reunião é um texto fictício. Ele serve para treinarmos o conteúdo, mas não comprova a conexão real com o Zoom, que será configurada e conferida depois.

Na segunda, escreva o que entra: a referência da reunião, o modelo da empresa e a tabela de serviços. E o que sai: um documento salvo na pasta de aprovação, com estado claro e referência observável. Isso quer dizer que qualquer pessoa consegue ver onde o documento está e em que situação se encontra: aguardando aprovação, por exemplo.

Na terceira, escreva as etapas com verbos e resultados: buscar a transcrição, extrair o entendimento, confirmar o escopo, montar a proposta, salvar e conferir. Evite palavras vagas, como tratar ou resolver, porque elas não dizem o que se espera ao final.

Na quarta, as ferramentas externas são o Zoom, para a origem, e o Drive, para o destino.

Na quinta, marque os pontos humanos: a pessoa confirma o entendimento antes da proposta e revisa o documento antes de qualquer envio. Marque também o que cada aprovação cobre, porque confirmar o entendimento não é o mesmo que autorizar o envio.

Agora procure uma lacuna. Se o orçamento não apareceu na reunião, em qual etapa percebemos isso? Na análise. E quem decide se ainda é possível preparar um rascunho? O mapa precisa dizer, porque a IA não deve adivinhar. No nosso exercício, a ausência é mostrada e o fluxo pede a informação necessária antes de tratar as condições como confirmadas. Anote esse caminho no mapa.

Agora uma segunda lacuna: a proposta foi salva, mas a resposta se perdeu e não sabemos se deu certo. Repetir tudo pode criar uma segunda cópia. Então o mapa deve orientar a consulta ao estado do processo e ao destino antes de repetir: olhar se o documento já está na pasta e em que situação ficou. Só se ele não estiver lá a etapa é refeita.

Essas duas situações não exigem complicar o desenho. Exigem esclarecer o que fazer quando a entrada ou a entrega não é a esperada. Ao final, seu mapa deve mostrar três caminhos: o normal, a lacuna na entrada e a conferência antes de repetir.

### m04-a01-b06 — Do exemplo ao processo pessoal

Slide m04-a01-s06

Agora aplique as mesmas perguntas à tarefa que você escolheu no início da formação. Abra uma cópia do mapa para o seu projeto. Evite escrever “automatizar atendimento” como se fosse uma etapa, porque isso é um assunto inteiro, e não um passo que se confere. Escolha uma entrega pequena: organizar um pedido e deixar um rascunho para revisão, por exemplo.

Para cada etapa, escreva o que ela recebe, o que entrega e como você confere. Esse último item é o critério: o que você vai olhar para saber que a etapa deu certo. Depois, decida quantas skills você precisa. Se duas etapas sempre dependem do mesmo critério e produzem uma única entrega pequena, talvez uma skill baste. Se têm responsabilidades e testes próprios, vale separar. Não existe uma quantidade obrigatória de funcionários de IA.

Em seguida, marque as decisões humanas. Elas precisam aparecer como parte do percurso, com uma informação clara para quem vai decidir. Escreva o objeto de cada aprovação, isto é, o que exatamente a pessoa está aprovando. “Aprovar” sem dizer o que está sendo aprovado deixa uma brecha. Confirmar o escopo é diferente de aprovar o documento, e as duas coisas são diferentes de autorizar o envio.

Inclua também, no seu mapa, as duas lacunas que vimos: uma entrada incompleta e uma entrega incerta. Escreva o que acontece em cada uma.

Por fim, confira o resultado com os critérios do projeto-final.md. Você conclui este mapa quando outra pessoa consegue seguir o desenho e apontar o início, a entrada, as etapas, as ferramentas, a aprovação e a saída. Se ela precisar adivinhar uma regra importante, volte ao processo antes de pedir mais automação. Falta só um teste, que ajuda a decidir o tamanho certo de cada etapa.

### m04-a01-b03 — Uma etapa com resultado reconhecível

Slide m04-a01-s03

Nem todo passo do processo precisa virar uma skill. Separe uma etapa quando ela tem uma responsabilidade clara e pode ser testada sem depender do processo inteiro.

Compare dois passos. “Cuidar de propostas” é amplo demais para conferir: ninguém sabe o que entra, o que se faz e quando termina. Já “extrair da reunião o pedido, as entregas, o prazo citado e as perguntas abertas” diz o que entra, que é a reunião, o que a IA faz, que é extrair, e o que sai, que são esses quatro itens. E permite comparar o resultado com a transcrição, procurando cada item no texto original.

Use esse teste no seu mapa. Releia cada passo e pergunte: ele tem uma entrada, uma ação e um resultado que eu consigo comparar com a fonte? Se você não sabe qual deve ser a saída, a IA também não tem um critério confiável de conclusão. Nesse caso, reescreva o passo antes de seguir.

Na próxima aula, vamos aplicar esse desenho e testar as três skills do caso separadamente, uma de cada vez. Primeiro, fazemos cada peça funcionar sozinha. Depois, tiramos de você o trabalho de passar o resultado de uma para a outra.

# 4.1 — Como mapear processos para automatizar

ID m04-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Dependências e ensaio:** Mapa é material didático; execução integral Zoom → Drive permanece requisito das próximas demonstrações.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m04-a01-b01 | m04-a01-s01 / p. 1 | Abrir apoio/mapa-processo.md e apresentar o caso fictício do Ateliê Horizonte. | Gatilho e entrega final aguardando aprovação ficam explícitos. |
| m04-a01-b04 | m04-a01-s04 / p. 2 | Apresentar cliente/prestador e o mapa da orquestradora com duas aprovações. | Papéis e decisões explícitos; nenhum prazo invertido entre cliente e prestador. |
| m04-a01-b02 | m04-a01-s02 / p. 3 | Preencher gatilho, entradas/saídas, etapas, ferramentas e aprovações com os arquivos fictícios do projeto. | Mapa contém gatilho, entradas/saídas, etapas, ferramentas e decisões humanas. |
| m04-a01-b05 | m04-a01-s05 / p. 4 | Preencher as cinco perguntas no mapa e incluir orçamento ausente e resposta perdida. | Mapa inclui caminho normal, lacuna de entrada e conferência antes de repetir. |
| m04-a01-b06 | m04-a01-s06 / p. 5 | Preencher o mapa do projeto pessoal e aplicar a rubrica de clareza. | Outro leitor consegue explicar o processo sem adivinhar decisões. |
| m04-a01-b03 | m04-a01-s03 / p. 6 | Comparar um passo vago com um passo que define entrada, ação e resultado. Orientar o preenchimento do mapa. | Disparo, entradas/saídas, etapas, ferramentas e decisões descritos; exceções têm encaminhamento. |

## m04-a01-b01 — Desenhar o processo que será delegado

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir apoio/mapa-processo.md e apresentar o caso fictício do Ateliê Horizonte. | slides/m04-a01.pptx e slides/m04-a01.pdf, página 1, ID m04-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a01-b01. Sem trilha prevista. |

**Estado inicial:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Entrada/material:** apoio/mapa-processo.md, apoio/especificacao-caso.md, apoio/projeto-final.md

**Passos de captura:**
1. Abrir apoio/mapa-processo.md e apresentar o caso fictício do Ateliê Horizonte.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Gatilho e entrega final aguardando aprovação ficam explícitos.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a01-b01; SHA-256 152d92f6071c5364a5905c5fd8ac314437532e3d8886f399c3030dce9ad16bbd.

**Função visual:** Abrir apoio/mapa-processo.md e apresentar o caso fictício do Ateliê Horizonte.


## m04-a01-b04 — Uma orquestradora que você consegue explicar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Apresentar cliente/prestador e o mapa da orquestradora com duas aprovações. | slides/m04-a01.pptx e slides/m04-a01.pdf, página 2, ID m04-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a01-b04. Sem trilha prevista. |

**Estado inicial:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Entrada/material:** apoio/mapa-processo.md, apoio/especificacao-caso.md, apoio/projeto-final.md

**Passos de captura:**
1. Identificar Ateliê como cliente e prestador como executor.
2. Mostrar início e final do processo.
3. Marcar confirmação de escopo e aprovação da proposta.

**Saída e conferência:** Papéis e decisões explícitos; nenhum prazo invertido entre cliente e prestador.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a01-b04; SHA-256 5f2b905ee19892cb8ccf766ab13abaf32cf5745bfe779dcb3ef33fc802bf1bdd.

**Função visual:** Apresentar cliente/prestador e o mapa da orquestradora com duas aprovações.


## m04-a01-b02 — As cinco perguntas

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preencher gatilho, entradas/saídas, etapas, ferramentas e aprovações com os arquivos fictícios do projeto. | slides/m04-a01.pptx e slides/m04-a01.pdf, página 3, ID m04-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a01-b02. Sem trilha prevista. |

**Estado inicial:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Entrada/material:** apoio/mapa-processo.md, apoio/especificacao-caso.md, apoio/projeto-final.md

**Passos de captura:**
1. Preencher gatilho, entradas/saídas, etapas, ferramentas e aprovações com os arquivos fictícios do projeto.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Mapa contém gatilho, entradas/saídas, etapas, ferramentas e decisões humanas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a01-b02; SHA-256 4e375ed290616ee8f6af7dc09d303d87e0fcee2d966f544e46c7493c2261321b.

**Função visual:** Preencher gatilho, entradas/saídas, etapas, ferramentas e aprovações com os arquivos fictícios do projeto.


## m04-a01-b05 — Responder às cinco perguntas com uma entrada concreta

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preencher as cinco perguntas no mapa e incluir orçamento ausente e resposta perdida. | slides/m04-a01.pptx e slides/m04-a01.pdf, página 4, ID m04-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a01-b05. Sem trilha prevista. |

**Estado inicial:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Entrada/material:** apoio/mapa-processo.md, apoio/especificacao-caso.md, apoio/projeto-final.md

**Passos de captura:**
1. Abrir mapa-processo.md e preencher com reunião/modelo/tabela.
2. Marcar ferramentas e pontos humanos.
3. Acrescentar caminho de ausência e de entrega incerta.

**Saída e conferência:** Mapa inclui caminho normal, lacuna de entrada e conferência antes de repetir.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a01-b05; SHA-256 e06da23267bce671bf09babd81fb793963844a6e10df75bf1baa20d98c770f01.

**Função visual:** Preencher as cinco perguntas no mapa e incluir orçamento ausente e resposta perdida.


## m04-a01-b06 — Do exemplo ao processo pessoal

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preencher o mapa do projeto pessoal e aplicar a rubrica de clareza. | slides/m04-a01.pptx e slides/m04-a01.pdf, página 5, ID m04-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a01-b06. Sem trilha prevista. |

**Estado inicial:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Entrada/material:** apoio/mapa-processo.md, apoio/especificacao-caso.md, apoio/projeto-final.md

**Passos de captura:**
1. Escolher uma entrega pequena.
2. Definir entrada/saída/critério de cada etapa.
3. Nomear o objeto de cada aprovação.
4. Revisar usando projeto-final.md.

**Saída e conferência:** Outro leitor consegue explicar o processo sem adivinhar decisões.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a01-b06; SHA-256 7bbcba06e2aabc4619649b4b967e770ee8f2e27a0f6184c830cf703313a200bb.

**Função visual:** Preencher o mapa do projeto pessoal e aplicar a rubrica de clareza.


## m04-a01-b03 — Uma etapa com resultado reconhecível

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar um passo vago com um passo que define entrada, ação e resultado. Orientar o preenchimento do mapa. | slides/m04-a01.pptx e slides/m04-a01.pdf, página 6, ID m04-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a01-b03. Sem trilha prevista. |

**Estado inicial:** Abrir arquivos do caso e mapa vazio; preparar quadro com cliente/prestador e aprovações.

**Entrada/material:** apoio/mapa-processo.md, apoio/especificacao-caso.md, apoio/projeto-final.md

**Passos de captura:**
1. Comparar um passo vago com um passo que define entrada, ação e resultado. Orientar o preenchimento do mapa.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Disparo, entradas/saídas, etapas, ferramentas e decisões descritos; exceções têm encaminhamento.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a01-b03; SHA-256 c761b022c3b7515d6cfcfa06d5c1585a724e01d4f7109828693e8c6564123457.

**Função visual:** Comparar um passo vago com um passo que define entrada, ação e resultado. Orientar o preenchimento do mapa.


## Atividade e solução

Preencher mapa do caso e do processo pessoal, incluindo uma entrada incompleta e uma entrega incerta.

Disparo, entradas/saídas, etapas, ferramentas e decisões descritos; exceções têm encaminhamento.

## Materiais

- mapa-processo.md
- especificacao-caso.md
- projeto-final.md

# 4.2 — Estudo de caso: da reunião à proposta pronta para aprovação. / m04-a02

**Objetivo:** Criar três skills e testar o percurso Zoom → entendimento → proposta → Drive, com aprovações e caso incompleto.

**Preparação:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Ensaio:** Reunião de teste Zoom e ensaio autenticado das três skills ainda não foram executados para esta versão; TXT não substitui essa validação.

### m04-a02-b01 — Preparar o caso e as referências

Slide m04-a02-s01

Nesta aula, vamos levar um caso da reunião com um cliente até uma proposta pronta para aprovação. Para isso, você vai criar três skills. Uma skill é um procedimento escrito que o Claude segue quando você pede aquela tarefa. Ela tem um nome, instruções e, quando necessário, arquivos de referência. Cada uma das três cuida de uma responsabilidade: resumir o pedido do cliente, montar o documento da proposta e entregar esse documento para aprovação.

O cliente do exercício é o Ateliê Horizonte, um negócio fictício. Ele quer organizar pedidos numa planilha, importar até cem registros, ou seja, trazer para a planilha até cem linhas de informação, e receber uma orientação de uma hora. O teto de investimento citado é de mil e oitocentos reais. O prazo desejado é de dez dias corridos, contados a partir do momento em que o prestador recebe os dados enviados pelo cliente. Cliente, valores e prazo são fictícios e existem só para o exercício.

Para trabalhar, usamos três arquivos de apoio. O primeiro é a cópia em texto do diálogo da reunião, que serve para você consultar o conteúdo. O segundo é a tabela de serviços, um arquivo de tabela simples, que abre em qualquer planilha, com cada serviço e o seu preço. O terceiro é o modelo de proposta, um arquivo de texto com a estrutura que o documento deve seguir. A tabela diz à skill qual é o escopo, isto é, o que está incluído e o que não está. O modelo diz como o documento deve ser montado. Abra os três agora, um de cada vez, e confirme que todos são fictícios.

No caso real, a reunião virá do Zoom, e você vai selecionar a reunião de teste e conferir se a transcrição corresponde a este caso. Faremos isso no próximo passo. Se algum dos arquivos de referência faltar, a skill precisa apontar qual está ausente e pedir esclarecimento antes de seguir, em vez de preencher a lacuna por conta própria.

### m04-a02-b04 — Preparar Zoom, Drive e os arquivos da empresa

Slide m04-a02-s04

Antes de criar as skills, prepare o lugar de onde a informação sai e o lugar para onde ela vai. A origem é o Zoom. O destino é o Drive.

No Zoom, selecione uma reunião de teste que tenha transcrição disponível. Use uma reunião sua, feita para o ensaio, e não a gravação de um cliente real. Confira o título, a data e o conteúdo. O diálogo fictício do material pode orientar o que você diz nessa reunião de ensaio. Mas um arquivo de texto no computador não prova que a integração buscou a transcrição no Zoom. Por isso, o texto é apoio, e a prova é a busca feita no próprio Zoom.

No Drive, prepare uma pasta de exercício para as propostas que aguardam aprovação. Confira a conta que está conectada e quem pode acessar essa pasta. Depois, faça uma leitura pequena, por exemplo pedir que o Claude liste o conteúdo da pasta. Assim você confirma o destino antes de criar qualquer documento nele.

Quando o Zoom e o Drive pedirem autorização, aprove só o que o teste precisa: ler a transcrição no Zoom e criar um arquivo na pasta de teste do Drive. Ler também pode expor informação sensível, então o acesso mínimo é a escolha mais segura. A autorização acontece na tela do próprio serviço. Você não precisa colar senha nem chave de acesso numa conversa. Anote no registro de testes o identificador da reunião e o da pasta, para saber depois de onde veio cada informação e para onde ela foi.

Agora abra o modelo e a tabela e releia o pedido, porque eles formam o nosso gabarito, isto é, a resposta que vamos usar para conferir. O cliente quer uma planilha organizada, a importação de até cem registros e uma orientação de uma hora. O orçamento citado é um teto de mil e oitocentos reais, e não o preço. O prazo é de dez dias corridos a partir do recebimento dos dados pelo prestador. Ele não conta a partir da reunião, nem a partir da data em que o cliente envia.

Se a transcrição de teste vier diferente do diálogo fictício, registre a diferença e ajuste a referência do ensaio. Se você trocar a reunião por outro texto, diga que trocou. Não afirme que usou a mesma reunião.

### m04-a02-b02 — Testar as três responsabilidades

Slide m04-a02-s02

Vamos criar cada skill com o Skill Creator, a partir da especificação do caso, e testar uma de cada vez. Antes de pedir, precisamos saber o que cada uma recebe, o que faz e o que devolve, porque é isso que vamos conferir depois.

A primeira skill busca a transcrição da reunião indicada e extrai a necessidade, as entregas, o prazo, o orçamento e as perguntas abertas. A saída precisa separar o que foi dito do que está faltando. Se não houver transcrição, ou se ela não for da reunião correta, a skill para e avisa.

Depois, você confere esse entendimento. Aqui entra um cuidado: o teto de investimento não é automaticamente o preço da proposta. Na tabela do exercício, a planilha custa novecentos reais, a importação custa trezentos e a orientação custa trezentos. O total dos serviços é de mil e quinhentos reais, abaixo do teto de mil e oitocentos.

A segunda skill recebe o entendimento já confirmado, o modelo e a tabela, e monta a proposta dentro desse escopo. Um aplicativo, um site ou uma cobrança automatizada ficam de fora, porque não fazem parte do pedido. E uma estimativa continua sendo estimativa: ela não vira um compromisso novo.

A terceira skill entrega o documento na pasta de aprovação do Drive. A saída deve identificar o arquivo e informar que ele aguarda revisão. Você abre a pasta, confere o documento e compara o conteúdo com o que foi aprovado na etapa anterior.

Cada peça roda sozinha por um motivo. Se o escopo vier errado, você sabe onde corrigir. Se o documento não estiver no Drive, não precisa refazer a análise da reunião.

### m04-a02-b05 — Criar e testar cada skill isolada

Slide m04-a02-s05

Agora vamos pôr isso em prática. Peça ao Skill Creator três procedimentos separados, um de cada vez.

A primeira skill se chama analisar-reuniao. Ela recebe uma referência inequívoca da reunião, isto é, uma identificação que só pode apontar para aquela reunião, como título, data e identificador. Com ela, busca a transcrição e organiza necessidade, entregas, limites, prazo, orçamento e perguntas abertas. Ela preserva a origem de cada informação. E não transforma uma fala do cliente em autorização para uma ferramenta: se alguém disser na reunião que pode mandar uma mensagem, isso não autoriza a skill a mandar. Quem autoriza é você.

Execute somente essa skill. Leia o resumo e compare com a transcrição. Se estiver correto, confirme o entendimento.

Depois, crie a segunda, montar-proposta. Ela recebe o entendimento confirmado, o modelo e a tabela. Peça que ela relacione cada entrega a um item da tabela antes de redigir, porque assim nada entra no documento sem origem. A conta fictícia é novecentos mais trezentos mais trezentos: mil e quinhentos reais. O teto de mil e oitocentos não é o preço. Abra o rascunho e confira os serviços, o total, o prazo e as exclusões. Não deve haver site, aplicativo, cobrança automatizada nem condição de pagamento que ninguém combinou.

Por fim, crie a terceira, entregar-aprovacao. Ela recebe o documento e a pasta de teste, salva o arquivo e devolve uma referência real, ou seja, algo que você consiga abrir, como um link ou um identificador. Abra o arquivo pelo Drive usando essa referência e confira a pasta e o conteúdo. Não basta a skill dizer que salvou. Você só sabe que salvou quando abre. Essa skill também não pode declarar uma aprovação humana que não aconteceu. O estado final continua sendo aguardando revisão, e nada é enviado ao cliente: o envio é uma decisão sua, depois da aprovação.

Cada teste isolado produz uma evidência diferente. A primeira mostra que a fonte foi interpretada corretamente. A segunda, que o documento está correto. A terceira, que o arquivo foi realmente localizado no serviço.

### m04-a02-b06 — A dor da passagem manual e o caso incompleto

Slide m04-a02-s06

Agora faça o percurso inteiro do jeito solto, sem automação entre as etapas. Chame a análise, confira e copie o entendimento confirmado. Chame a proposta e forneça esse entendimento, o modelo e a tabela. Abra o rascunho. Depois chame a entrega e passe o documento e a pasta. Cada vez que você leva a saída de uma etapa para a próxima, está fazendo uma passagem manual, que costuma ser chamada de handoff. Conte quantas passagens foram necessárias e anote cada uma no registro de testes, sem calcular economia de tempo, porque ainda não medimos nada.

Esse trabalho manual não é desperdício nesta fase. Ele mostra se cada peça funciona e o que precisa passar adiante de uma para outra. Se juntássemos tudo antes, uma falha no destino poderia parecer um problema de interpretação da reunião.

Em seguida, repita a análise com o caso sem orçamento, usando o arquivo reuniao-sem-orcamento.txt. Esse texto é um ensaio local, e não uma reunião buscada no Zoom. Registre essa origem para não misturar as duas coisas. O teto do exemplo anterior não pode aparecer por hábito. A saída deve registrar orçamento não informado e pedir o esclarecimento necessário. Cada conversa trabalha com as informações que recebe, e nada garante que um dado de uma conversa chegue à outra. Por isso, não carregue um valor de um caso para o outro só porque os nomes parecem próximos. Confira que o valor de mil e oitocentos não aparece em nenhum ponto dessa saída.

Guarde os resultados dos dois casos no registro de testes, para compará-los em seguida.

### m04-a02-b03 — Verificar o que não pode ser inventado

Slide m04-a02-s03

Vamos fechar com a conferência dos dois casos. Uma proposta com boa aparência não encerra o teste. No caso completo, confira os serviços, o total de mil e quinhentos reais, o prazo com o marco inicial correto e as exclusões. Depois, verifique se o arquivo está na pasta correta do Drive e se continua aguardando aprovação.

No caso sem orçamento, o resultado correto preserva essa ausência e pede a informação necessária. Um valor inventado só para a proposta parecer completa é um erro. Se existir um rascunho desse caso, ele também permanece aguardando aprovação, com a pergunta pendente à vista.

Compare as duas entradas. O caso completo preservou o escopo, o preço e o prazo com seu marco inicial. O incompleto preservou a ausência. E a entrega externa só está comprovada quando o arquivo abre no Drive.

Por enquanto, a passagem entre as três skills é feita por você. Você chama a primeira, confere a saída, entrega à segunda e depois aciona a terceira. Esse caminho serve para testar as peças, mas deixa a coordenação na sua mão.

Na próxima aula, vamos criar a skill orquestradora, que coordena as três em sequência, cuidando das passagens que você acabou de fazer. Os pontos em que a decisão continua sendo humana ficam onde estão: a confirmação do entendimento e a aprovação do documento.

# 4.2 — Estudo de caso: da reunião à proposta pronta para aprovação.

ID m04-a02. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Dependências e ensaio:** Reunião de teste Zoom e ensaio autenticado das três skills ainda não foram executados para esta versão; TXT não substitui essa validação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m04-a02-b01 | m04-a02-s01 / p. 1 | Abrir apoio/reuniao-horizonte.txt, apoio/tabela-servicos.csv e apoio/modelo-proposta.md. Identificar todos como fictícios. A origem Zoom será demonstrada somente após ensaio. | Dados fictícios e origem da transcrição são identificados antes da execução. |
| m04-a02-b04 | m04-a02-s04 / p. 2 | Preparar reunião Zoom de teste e pasta Drive; conferir conteúdo contra o diálogo fictício. | Origem e destino reais preparados; TXT identificado como apoio e prazo corretamente atribuído. |
| m04-a02-b02 | m04-a02-s02 / p. 3 | Criar cada skill com Skill Creator, usando apoio/especificacao-caso.md. Testar análise, proposta e entrega individualmente. Conferir a reunião selecionada no Zoom e o arquivo no Drive; não usar gravação real de aluno como reunião comercial. | Três skills são testadas separadamente; proposta soma R$ 1.500 e é aberta no destino observado. |
| m04-a02-b05 | m04-a02-s05 / p. 4 | Criar três skills com Skill Creator, executar isoladamente e conferir cada saída. | Três saídas testadas isoladamente; proposta correta existe na pasta de teste e aguarda aprovação. |
| m04-a02-b06 | m04-a02-s06 / p. 5 | Executar handoff manual entre as três skills e repetir análise com orçamento ausente. | Passagens e critérios visíveis; entrada incompleta não herda orçamento; Drive conferido separadamente. |
| m04-a02-b03 | m04-a02-s03 / p. 6 | Executar também apoio/reuniao-sem-orcamento.txt. Confirmar que a ausência de orçamento gera pergunta, não valor fabricado. Manter documento como aguardando aprovação. | Escopo confirmado; R$900+300+300=R$1.500; prazo após prestador receber dados; exclusões preservadas; um documento aguarda revisão. |

## m04-a02-b01 — Preparar o caso e as referências

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir apoio/reuniao-horizonte.txt, apoio/tabela-servicos.csv e apoio/modelo-proposta.md. Identificar todos como fictícios. A origem Zoom será demonstrada somente após ensaio. | slides/m04-a02.pptx e slides/m04-a02.pdf, página 1, ID m04-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a02-b01. Sem trilha prevista. |

**Estado inicial:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Entrada/material:** apoio/especificacao-caso.md, apoio/prompts-time.md, apoio/reuniao-horizonte.txt, apoio/reuniao-sem-orcamento.txt, apoio/tabela-servicos.csv, apoio/modelo-proposta.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir apoio/reuniao-horizonte.txt, apoio/tabela-servicos.csv e apoio/modelo-proposta.md. Identificar todos como fictícios. A origem Zoom será demonstrada somente após ensaio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Dados fictícios e origem da transcrição são identificados antes da execução.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a02-b01; SHA-256 adf52af94409f235da224ad3fbba9c08bbe2a92ff9efec5763bb4fab80d040e1.

**Função visual:** Abrir apoio/reuniao-horizonte.txt, apoio/tabela-servicos.csv e apoio/modelo-proposta.md. Identificar todos como fictícios. A origem Zoom será demonstrada somente após ensaio.


## m04-a02-b04 — Preparar Zoom, Drive e os arquivos da empresa

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preparar reunião Zoom de teste e pasta Drive; conferir conteúdo contra o diálogo fictício. | slides/m04-a02.pptx e slides/m04-a02.pdf, página 2, ID m04-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a02-b04. Sem trilha prevista. |

**Estado inicial:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Entrada/material:** apoio/especificacao-caso.md, apoio/prompts-time.md, apoio/reuniao-horizonte.txt, apoio/reuniao-sem-orcamento.txt, apoio/tabela-servicos.csv, apoio/modelo-proposta.md, apoio/registro-testes.md

**Passos de captura:**
1. Identificar reunião com transcrição real e confirmar disponibilidade.
2. Autorizar Zoom/Drive somente no escopo de teste.
3. Abrir tabela/modelo e registrar IDs de origem/destino.
4. Conferir marco do prazo e teto do orçamento.

**Saída e conferência:** Origem e destino reais preparados; TXT identificado como apoio e prazo corretamente atribuído.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a02-b04; SHA-256 9dd198c693cc565f9a307e4bc0c7d0e5be5c22d154312330cd07e256016e8c06.

**Função visual:** Preparar reunião Zoom de teste e pasta Drive; conferir conteúdo contra o diálogo fictício.


## m04-a02-b02 — Testar as três responsabilidades

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Criar cada skill com Skill Creator, usando apoio/especificacao-caso.md. Testar análise, proposta e entrega individualmente. Conferir a reunião selecionada no Zoom e o arquivo no Drive; não usar gravação real de aluno como reunião comercial. | slides/m04-a02.pptx e slides/m04-a02.pdf, página 3, ID m04-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a02-b02. Sem trilha prevista. |

**Estado inicial:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Entrada/material:** apoio/especificacao-caso.md, apoio/prompts-time.md, apoio/reuniao-horizonte.txt, apoio/reuniao-sem-orcamento.txt, apoio/tabela-servicos.csv, apoio/modelo-proposta.md, apoio/registro-testes.md

**Passos de captura:**
1. Criar cada skill com Skill Creator, usando apoio/especificacao-caso.md. Testar análise, proposta e entrega individualmente. Conferir a reunião selecionada no Zoom e o arquivo no Drive; não usar gravação real de aluno como reunião comercial.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Três skills são testadas separadamente; proposta soma R$ 1.500 e é aberta no destino observado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a02-b02; SHA-256 66fc7f020d9bd1079aa8466f9f8d6611532a1d8c04219cf2e0b68b71ca46de8a.

**Função visual:** Criar cada skill com Skill Creator, usando apoio/especificacao-caso.md. Testar análise, proposta e entrega individualmente. Conferir a reunião selecionada no Zoom e o arquivo no Drive; não usar gravação real de aluno como reunião comercial.


## m04-a02-b05 — Criar e testar cada skill isolada

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Criar três skills com Skill Creator, executar isoladamente e conferir cada saída. | slides/m04-a02.pptx e slides/m04-a02.pdf, página 4, ID m04-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a02-b05. Sem trilha prevista. |

**Estado inicial:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Entrada/material:** apoio/especificacao-caso.md, apoio/prompts-time.md, apoio/reuniao-horizonte.txt, apoio/reuniao-sem-orcamento.txt, apoio/tabela-servicos.csv, apoio/modelo-proposta.md, apoio/registro-testes.md

**Passos de captura:**
1. Criar analisar-reuniao com transcrição e critérios.
2. Executar, conferir e confirmar escopo.
3. Criar montar-proposta com modelo/tabela; conferir R$1.500.
4. Criar entregar-aprovacao; salvar no Drive e abrir pela referência retornada.

**Saída e conferência:** Três saídas testadas isoladamente; proposta correta existe na pasta de teste e aguarda aprovação.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a02-b05; SHA-256 7ec94b849519d0b782686704ad929b40f008beada96e5055c1a4571ed98db56d.

**Função visual:** Criar três skills com Skill Creator, executar isoladamente e conferir cada saída.


## m04-a02-b06 — A dor da passagem manual e o caso incompleto

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar handoff manual entre as três skills e repetir análise com orçamento ausente. | slides/m04-a02.pptx e slides/m04-a02.pdf, página 5, ID m04-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a02-b06. Sem trilha prevista. |

**Estado inicial:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Entrada/material:** apoio/especificacao-caso.md, apoio/prompts-time.md, apoio/reuniao-horizonte.txt, apoio/reuniao-sem-orcamento.txt, apoio/tabela-servicos.csv, apoio/modelo-proposta.md, apoio/registro-testes.md

**Passos de captura:**
1. Copiar saída da análise para proposta e depois para entrega.
2. Registrar intervenções manuais sem inflar métrica de economia.
3. Executar reuniao-sem-orcamento.txt em ensaio local, identificando a origem.
4. Conferir ausência de vazamento do teto anterior.

**Saída e conferência:** Passagens e critérios visíveis; entrada incompleta não herda orçamento; Drive conferido separadamente.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a02-b06; SHA-256 30d969b777c92fcbb19e6caebab73be9c92498f8754932b2ef1e75cdc364bcad.

**Função visual:** Executar handoff manual entre as três skills e repetir análise com orçamento ausente.


## m04-a02-b03 — Verificar o que não pode ser inventado

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar também apoio/reuniao-sem-orcamento.txt. Confirmar que a ausência de orçamento gera pergunta, não valor fabricado. Manter documento como aguardando aprovação. | slides/m04-a02.pptx e slides/m04-a02.pdf, página 6, ID m04-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a02-b03. Sem trilha prevista. |

**Estado inicial:** Preparar reunião real de teste, transcrição e pasta Drive. Usar Skill Creator e os arquivos fictícios; capturar login somente fora da gravação.

**Entrada/material:** apoio/especificacao-caso.md, apoio/prompts-time.md, apoio/reuniao-horizonte.txt, apoio/reuniao-sem-orcamento.txt, apoio/tabela-servicos.csv, apoio/modelo-proposta.md, apoio/registro-testes.md

**Passos de captura:**
1. Executar também apoio/reuniao-sem-orcamento.txt. Confirmar que a ausência de orçamento gera pergunta, não valor fabricado. Manter documento como aguardando aprovação.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Escopo confirmado; R$900+300+300=R$1.500; prazo após prestador receber dados; exclusões preservadas; um documento aguarda revisão.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a02-b03; SHA-256 7e556945a807150973113032376cf8178c889635ad1ea00d60eff7a0feed653e.

**Função visual:** Executar também apoio/reuniao-sem-orcamento.txt. Confirmar que a ausência de orçamento gera pergunta, não valor fabricado. Manter documento como aguardando aprovação.


## Atividade e solução

Criar e executar as três skills isoladas; realizar handoff manual; conferir arquivo real no Drive e ausência de orçamento no segundo caso.

Escopo confirmado; R$900+300+300=R$1.500; prazo após prestador receber dados; exclusões preservadas; um documento aguarda revisão.

## Materiais

- especificacao-caso.md
- prompts-time.md
- reuniao-horizonte.txt
- reuniao-sem-orcamento.txt
- tabela-servicos.csv
- modelo-proposta.md
- registro-testes.md

# 4.3 — Transformando peças soltas em um time orquestrado / m04-a03

**Objetivo:** Criar e executar orquestradora com estados, aprovações e retomada verificáveis.

**Preparação:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Ensaio:** Teste real da cadeia e retomada no Drive ainda exige ensaio autenticado. Não declarar idempotência geral por um único teste.

### m04-a03-b01 — A coordenação também pode ter um procedimento

Slide m04-a03-s01

Nas aulas anteriores deste módulo, você montou as três skills do caso comercial. Para lembrar: uma skill é um procedimento escrito que a IA segue, com a entrada que ela recebe, o que deve fazer e o que precisa entregar. Em linhas gerais, no nosso caso uma analisa a reunião, outra monta a proposta e a terceira salva o documento no Drive.

Até aqui, quem levava o resultado de uma skill para a outra era você. Chamava a primeira, lia o que ela entregou, passava o que importava para a segunda e repetia o gesto com a terceira. Esse é o fluxo manual. Vamos executá-lo agora, uma skill de cada vez, porque ele será o nosso ponto de comparação.

Enquanto fazemos isso, conte as passagens. Cada vez que você leva um resultado de um lugar para outro, há um momento em que confere, o que é bom. Mas também há um momento em que dá para esquecer um dado ou usar a versão errada de um arquivo.

Quando as três terminarem, abra o resultado e compare com o critério que vamos usar na aula inteira. O entendimento da reunião foi confirmado antes da proposta. O documento correto está aguardando a sua revisão. Existe uma única cópia dele. E nada foi enviado ao cliente.

Agora vamos criar mais uma skill, que cuida do percurso inteiro: a orquestradora. A que vamos montar é a orquestradora comercial, a que leva a reunião até a proposta pronta para revisão.

Ela recebe o objetivo, chama a skill adequada para cada etapa, confere o que veio e repassa para a etapa seguinte. E ela sabe quando precisa parar para uma decisão sua.

Isso é diferente de escrever “faça tudo sozinho” no começo de um pedido. Aqui, a autonomia se apoia em responsabilidades e critérios que você já definiu. Se faltar uma dependência, ou seja, algo de que a etapa precisa, como a tabela de preços, ou se um resultado não puder ser conferido, o processo mostra esse ponto. Ele não segue em frente como se estivesse tudo certo.

### m04-a03-b04 — Criar o contrato da orquestradora

Slide m04-a03-s04

Vamos criar a orquestradora usando as três skills que já foram testadas. Antes de pedir qualquer coisa à IA, precisamos escrever o contrato dela: o combinado sobre o que ela recebe, o que faz em cada etapa e quando para. Abra o arquivo especificacao-orquestradora.md, que reúne esse combinado, e o prompts-time.md, onde está o pedido de apoio para esta etapa.

O pedido descreve o objetivo, a reunião de origem, os arquivos da empresa e a pasta de destino. A orquestradora também precisa saber o que recebe de cada etapa e o que é condição para seguir. Por exemplo: a análise entrega o entendimento do escopo, e sem ele a proposta não começa. A proposta entrega o documento, e sem ele não há o que salvar.

O contrato é organizado em estados. Estado é apenas a resposta para a pergunta “em que ponto estamos?”. Primeiro, reunião identificada e análise em andamento. Depois, entendimento aguardando confirmação. Só após essa confirmação entra a proposta. Em seguida, o documento pode ser salvo na pasta de revisão. E o estado final é proposta aguardando aprovação, não proposta enviada. Como o contrato não prevê nenhum estado de envio, esse fluxo não concede a autorização de enviar ao cliente.

Perceba que o contrato reserva duas decisões humanas: confirmar o entendimento do escopo e revisar a proposta. São as duas paradas que vamos ver funcionando daqui a pouco.

Peça também que a orquestradora registre a referência da reunião, as versões dos arquivos da empresa, como a tabela de preços e o modelo de proposta usados, e o identificador do documento criado. Esse registro precisa ficar em um arquivo, e não apenas na conversa, porque os dados de uma conversa não se tornam memória garantida. É ele que ajuda a retomar a mesma execução. Se a entrada mudou, por exemplo se a tabela foi atualizada, não trate uma aprovação antiga como se cobrisse o conteúdo novo. Se o escopo mudou, volte à confirmação correspondente.

Sobre permissões: criar a skill não dá acesso novo a nada. Ela usa as conexões com o Zoom e o Drive que você já autorizou. Se durante a execução o Claude pedir uma permissão nova, leia o que está sendo pedido e conceda só o necessário para aquela etapa, em vez de liberar tudo para não ser interrompido.

Agora peça ao Skill Creator, o recurso que usamos para criar skills, que transforme esse contrato em uma skill orquestradora, vinculando as três skills existentes. Quando ele terminar, não execute ainda. Leia primeiro os estados, as saídas esperadas de cada etapa e as regras de retomada.

Confira também se o procedimento chama as skills existentes, em vez de reescrever regras diferentes para cada etapa. A razão é simples: se o preço for descrito de novo dentro da orquestradora, você passa a ter duas fontes, e uma delas vai ficar desatualizada. A coordenação deve deixar o caminho mais claro; o preço e o prazo continuam vindo das mesmas referências que as skills já usam.

### m04-a03-b02 — Uma execução com duas aprovações

Slide m04-a03-s02

Com a orquestradora criada, vamos ao pedido inicial. Ele identifica a reunião do caso do Ateliê Horizonte e pede a proposta pronta para revisão. Algo como: “use a reunião do Ateliê Horizonte e deixe a proposta pronta para a minha revisão”. Repare que o pedido é curto. As regras já estão no contrato e nas skills, então não precisamos repeti-las aqui.

A orquestradora começa buscando e analisando a transcrição da reunião. Em seguida, apresenta o entendimento do escopo, isto é, o que será feito e o que fica de fora, e pede a sua confirmação. Essa é a primeira parada. Ela vem antes da proposta de propósito: se o entendimento estiver errado, o preço e o prazo saem errados junto.

Com o escopo confirmado, ela chama a skill de proposta, que usa o modelo e a tabela. A etapa seguinte entrega o documento no Drive e devolve a referência para você abrir. O estado final é “aguardando aprovação”. Essa é a segunda parada: a proposta espera a sua revisão, e este fluxo não tem autorização para enviar nada ao cliente.

Repare que a IA não pede decisão sobre cada detalhe operacional. Ela pede as decisões que você reservou. E a confirmação do escopo vale só para o escopo: não é também aprovação de preço, do documento ou do envio.

No teste, vamos usar a mesma reunião da aula anterior. Assim, você compara o percurso manual com o orquestrado, com os mesmos dados. Só muda quem faz as passagens. Ao final desta primeira execução, abra o documento pela referência devolvida e compare com o critério da aula. O teste completo, com cada conferência, é o próximo passo.

### m04-a03-b05 — Testar caminho normal, lacuna e retomada

Slide m04-a03-s05

Agora o teste completo, em três situações: o caminho normal, uma entrada incompleta e uma retomada.

Comece pelo caminho normal. Execute o mesmo caso da aula anterior, agora com um pedido à orquestradora. Observe se ela busca e analisa a reunião, apresenta o entendimento e realmente espera a sua confirmação. Não confunda uma pergunta escrita no resumo, como “posso seguir?”, com uma parada efetiva do processo. Se a pergunta aparece e a execução continua sem a sua resposta, não houve parada. A parada de verdade é aquela em que nada avança até você responder.

Depois de confirmar, acompanhe a proposta e a entrega ao Drive. Abra o documento pela referência devolvida e compare com o rascunho da aula anterior. O resultado precisa manter serviços, total, prazo e exclusões, que são os pontos que mais alteram o que o cliente entende. No final, deve haver um documento aguardando revisão.

Agora teste uma entrada incompleta. Por exemplo, peça a proposta sem indicar a reunião, ou indique uma que a orquestradora não encontra. Ela não pode contornar uma informação necessária apenas para terminar o fluxo, supondo um escopo que ninguém confirmou. O comportamento correto é mostrar o que falta e em que etapa parou.

Por fim, teste uma retomada depois de salvar o arquivo. Imagine que o documento já foi gravado no Drive, mas a execução foi interrompida, ou a resposta do serviço foi incerta. Peça para retomar a mesma execução. Antes de criar outro documento, a orquestradora deve consultar a referência registrada e a pasta de destino.

Se a resposta do serviço foi incerta, o caminho é conferir o estado. Repetir a criação sem investigar pode duplicar a proposta, e uma retomada não deve criar outra só porque perdeu a referência do arquivo anterior. Para a demonstração controlada, registre como a retomada encontrou a entrega existente: qual referência usou e o que viu na pasta.

O teste só passa se você consegue mostrar as paradas, o conteúdo e a ausência de duplicação no cenário que você testou. Isso não prova que toda falha possível está resolvida. É uma evidência para aquele cenário, não uma garantia geral.

### m04-a03-b06 — Antes e depois e extensões com escopo próprio

Slide m04-a03-s06

Compare os dois percursos usando os registros de cada um. No manual, você chamou as três skills e fez as passagens. No orquestrado, um pedido iniciou a sequência e as intervenções ficaram nas decisões combinadas. Não vamos atribuir uma porcentagem de economia, porque este teste não mede tempo. A diferença que dá para sustentar é quantas vezes você precisou intervir e em quais pontos.

Anote no registro de testes os três casos: o normal, a lacuna e a retomada. Cada um com a parada observada e o resultado.

Agora vamos separar o que a orquestradora decide do que ela não decide. Ela escolhe a próxima etapa conforme o estado e confere se a saída permite avançar. Quem conhece o negócio confirma o escopo e revisa a proposta. E se o documento mudou depois da aprovação, a autorização anterior não serve para uma versão diferente.

Você poderia acrescentar uma preparação de e-mail, uma notificação ou o WhatsApp. Cada extensão precisa de uma finalidade e de um acesso próprios, com a sua aprovação. Preparar uma mensagem para revisão é diferente de enviar. No caso do WhatsApp oficial, há ainda regras de cobrança que variam conforme a categoria da mensagem e o mercado, e isso deve ser conferido antes de ligar o canal.

Nesta aula, as extensões ficam como opções, sem ativar nenhum envio. E não acrescente canais apenas porque existe um conector disponível, isto é, uma integração que o programa oferece para se ligar a outro serviço.

### m04-a03-b03 — Coordenar sem perder a capacidade de conferir

Slide m04-a03-s03

Você continua podendo usar cada skill separadamente. A orquestradora não tira essa possibilidade. Ela organiza o uso conjunto, quando o objetivo pede a sequência completa.

Agora, o seu exercício. Execute o time com o caso normal, o caso incompleto e a retomada, e registre no registro-testes.md as paradas e o resultado de cada um. Depois escreva uma explicação curta do antes e depois, com as suas palavras, dizendo três coisas: o que a orquestradora decide, o que ela confere e onde ela deve parar. Essa explicação acompanha a execução; ela não substitui o teste.

Se você consegue apontar esses três pontos, consegue avaliar se o time está trabalhando como foi combinado. Para conferir o seu resultado, use o critério da aula. O entendimento foi confirmado antes da proposta. O documento correto aguarda revisão. Não há duplicação no cenário que você testou. E nenhum envio foi feito ao cliente.

Na próxima aula, vamos ver a diferença entre acionar esse time por uma conversa e deixá-lo começar por uma rotina. Veremos também que uma rotina pode rodar na nuvem ou no seu computador, e que isso muda se a máquina precisa estar ligada.

# 4.3 — Transformando peças soltas em um time orquestrado

ID m04-a03. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Dependências e ensaio:** Teste real da cadeia e retomada no Drive ainda exige ensaio autenticado. Não declarar idempotência geral por um único teste.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m04-a03-b01 | m04-a03-s01 / p. 1 | Usar as três skills do caso e mostrar o fluxo manual antes da orquestração. Não confundir esta orquestradora comercial com a skill que produz o curso. | Responsabilidades e ordem das três skills são mostradas antes do encadeamento. |
| m04-a03-b04 | m04-a03-s04 / p. 2 | Criar skill orquestradora com estados, referências e duas decisões humanas. | Contrato coordena peças existentes, preserva referências e não concede envio externo. |
| m04-a03-b02 | m04-a03-s02 / p. 3 | Criar a orquestradora com apoio/especificacao-orquestradora.md. Testar com o mesmo caso do Ateliê Horizonte, incluindo parada para confirmar entendimento e parada antes do envio. | Execução para na confirmação de escopo e termina com documento aguardando aprovação humana, sem envio. |
| m04-a03-b05 | m04-a03-s05 / p. 4 | Executar orquestração com escopo, caso incompleto e retomada após gravação no Drive. | Duas decisões preservadas, conteúdo correto e retomada sem duplicação no ensaio. |
| m04-a03-b06 | m04-a03-s06 / p. 5 | Comparar logs manuais e orquestrados e orientar entrega de teste mais explicação. | Explicação sustentada por execução e critérios; extensões não ampliam autorização automaticamente. |
| m04-a03-b03 | m04-a03-s03 / p. 6 | Comparar entradas/saídas antes e depois. Registrar estado final e arquivo único; orientar a missão do módulo. | Entendimento confirmado antes da proposta; documento correto aguarda revisão; nenhuma duplicação no cenário testado; nenhum envio ao cliente. |

## m04-a03-b01 — A coordenação também pode ter um procedimento

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar as três skills do caso e mostrar o fluxo manual antes da orquestração. Não confundir esta orquestradora comercial com a skill que produz o curso. | slides/m04-a03.pptx e slides/m04-a03.pdf, página 1, ID m04-a03-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a03-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a03-b01. Sem trilha prevista. |

**Estado inicial:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Entrada/material:** apoio/especificacao-orquestradora.md, apoio/contrato-aprovacao.md, apoio/prompts-time.md, apoio/registro-testes.md

**Passos de captura:**
1. Usar as três skills do caso e mostrar o fluxo manual antes da orquestração. Não confundir esta orquestradora comercial com a skill que produz o curso.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Responsabilidades e ordem das três skills são mostradas antes do encadeamento.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a03-b01; SHA-256 bba3ebd571f1b12fc02624113cba8da93570c7ff597b6ca1863677818db266e0.

**Função visual:** Usar as três skills do caso e mostrar o fluxo manual antes da orquestração. Não confundir esta orquestradora comercial com a skill que produz o curso.


## m04-a03-b04 — Criar o contrato da orquestradora

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Criar skill orquestradora com estados, referências e duas decisões humanas. | slides/m04-a03.pptx e slides/m04-a03.pdf, página 2, ID m04-a03-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a03-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a03-b04. Sem trilha prevista. |

**Estado inicial:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Entrada/material:** apoio/especificacao-orquestradora.md, apoio/contrato-aprovacao.md, apoio/prompts-time.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir especificacao-orquestradora.md e prompts-time.md.
2. Criar a orquestradora vinculando as três skills existentes.
3. Ler estados, saídas e regras de retomada antes de executar.

**Saída e conferência:** Contrato coordena peças existentes, preserva referências e não concede envio externo.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a03-b04; SHA-256 89bf9fea996da54bc522ffe424f0fc2befccf6626c6a0a234fdba09365166d69.

**Função visual:** Criar skill orquestradora com estados, referências e duas decisões humanas.


## m04-a03-b02 — Uma execução com duas aprovações

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Criar a orquestradora com apoio/especificacao-orquestradora.md. Testar com o mesmo caso do Ateliê Horizonte, incluindo parada para confirmar entendimento e parada antes do envio. | slides/m04-a03.pptx e slides/m04-a03.pdf, página 3, ID m04-a03-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a03-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a03-b02. Sem trilha prevista. |

**Estado inicial:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Entrada/material:** apoio/especificacao-orquestradora.md, apoio/contrato-aprovacao.md, apoio/prompts-time.md, apoio/registro-testes.md

**Passos de captura:**
1. Criar a orquestradora com apoio/especificacao-orquestradora.md. Testar com o mesmo caso do Ateliê Horizonte, incluindo parada para confirmar entendimento e parada antes do envio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Execução para na confirmação de escopo e termina com documento aguardando aprovação humana, sem envio.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a03-b02; SHA-256 7deab924561bac66366b9206ed7868b4d9380111f5e6083c6eb3db81cb9cd75e.

**Função visual:** Criar a orquestradora com apoio/especificacao-orquestradora.md. Testar com o mesmo caso do Ateliê Horizonte, incluindo parada para confirmar entendimento e parada antes do envio.


## m04-a03-b05 — Testar caminho normal, lacuna e retomada

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar orquestração com escopo, caso incompleto e retomada após gravação no Drive. | slides/m04-a03.pptx e slides/m04-a03.pdf, página 4, ID m04-a03-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a03-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a03-b05. Sem trilha prevista. |

**Estado inicial:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Entrada/material:** apoio/especificacao-orquestradora.md, apoio/contrato-aprovacao.md, apoio/prompts-time.md, apoio/registro-testes.md

**Passos de captura:**
1. Rodar caso completo e observar primeira espera.
2. Confirmar escopo e abrir documento final.
3. Rodar entrada incompleta e observar bloqueio.
4. Retomar execução já salva e conferir ausência de nova cópia.

**Saída e conferência:** Duas decisões preservadas, conteúdo correto e retomada sem duplicação no ensaio.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a03-b05; SHA-256 5701c867280cb7cf863c2b29c3808fd42285cc79ddcb839953fb0663eab277c4.

**Função visual:** Executar orquestração com escopo, caso incompleto e retomada após gravação no Drive.


## m04-a03-b06 — Antes e depois e extensões com escopo próprio

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar logs manuais e orquestrados e orientar entrega de teste mais explicação. | slides/m04-a03.pptx e slides/m04-a03.pdf, página 5, ID m04-a03-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a03-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a03-b06. Sem trilha prevista. |

**Estado inicial:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Entrada/material:** apoio/especificacao-orquestradora.md, apoio/contrato-aprovacao.md, apoio/prompts-time.md, apoio/registro-testes.md

**Passos de captura:**
1. Relacionar passagens manuais e decisões preservadas.
2. Registrar caso normal, lacuna e retomada.
3. Listar extensões como opcionais, sem ativar envio.

**Saída e conferência:** Explicação sustentada por execução e critérios; extensões não ampliam autorização automaticamente.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a03-b06; SHA-256 9be52a1fe5cb2db551d14e64396fefe5d2ae81b04a70f7278138e11ea134eccd.

**Função visual:** Comparar logs manuais e orquestrados e orientar entrega de teste mais explicação.


## m04-a03-b03 — Coordenar sem perder a capacidade de conferir

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar entradas/saídas antes e depois. Registrar estado final e arquivo único; orientar a missão do módulo. | slides/m04-a03.pptx e slides/m04-a03.pdf, página 6, ID m04-a03-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a03-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a03-b03. Sem trilha prevista. |

**Estado inicial:** Três skills isoladas e Zoom/Drive ensaiados; preparar referência de execução e um cenário de resposta incerta.

**Entrada/material:** apoio/especificacao-orquestradora.md, apoio/contrato-aprovacao.md, apoio/prompts-time.md, apoio/registro-testes.md

**Passos de captura:**
1. Comparar entradas/saídas antes e depois. Registrar estado final e arquivo único; orientar a missão do módulo.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Entendimento confirmado antes da proposta; documento correto aguarda revisão; nenhuma duplicação no cenário testado; nenhum envio ao cliente.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a03-b03; SHA-256 d02731b225535030e70cb5712e169cb69d54e01c11caa689c0b6485eb00d88e1.

**Função visual:** Comparar entradas/saídas antes e depois. Registrar estado final e arquivo único; orientar a missão do módulo.


## Atividade e solução

Executar caso normal, caso incompleto e retomada; entregar registro e explicação do antes/depois.

Entendimento confirmado antes da proposta; documento correto aguarda revisão; nenhuma duplicação no cenário testado; nenhum envio ao cliente.

## Materiais

- especificacao-orquestradora.md
- contrato-aprovacao.md
- prompts-time.md
- registro-testes.md

# 4.3 — Rotinas: como colocar seu Time de IA para trabalhar sem você precisar acionar / m04-a04

**Objetivo:** Preparar rotina no ambiente adequado, preservar aprovações e testar ausência/repetição/falha antes de ativar.

**Preparação:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Ensaio:** Agendamento real e contrato de retomada precisam de ensaio no ambiente escolhido; nenhuma rotina de produção será ativada nesta revisão.

### m04-a04-b01 — Agendar o início não resolve o processo

Slide m04-a04-s01

Até aqui, você chamava o time sempre que precisava. Uma rotina muda só isso: ela inicia o trabalho por um horário ou por uma frequência, por exemplo todo dia útil de manhã, e você deixa de acionar o time a cada vez.

Só que agendar o início não resolve o resto. A rotina não garante que o time tenha acesso às ferramentas de que precisa, que a entrada seja boa nem que alguém aprove a saída. Se nenhum desses três pontos foi cuidado, o que você automatizou foi só o começo de um processo que ainda pode falhar sem que ninguém perceba.

Então, antes de criar uma rotina, responda a três perguntas. Qual processo ela vai iniciar? Onde esse processo roda? E como você vai perceber que deu certo? O time que acabamos de construir é o procedimento. A rotina é só mais uma forma de acioná-lo, no lugar de você pedir o trabalho a cada vez.

No nosso caso comercial, a primeira pergunta tem esta resposta: a rotina vai verificar se existe uma nova reunião de teste pronta para análise. Se existir, ela prepara o material para aprovação, com as mesmas decisões humanas que já definimos. Vamos usar apenas origem e destino de teste, ou seja, um lugar de onde a reunião de teste é lida e um lugar onde o resultado é salvo. Não vamos criar nenhuma agenda de produção.

A segunda pergunta, onde o processo roda, vem agora. A terceira, como saber que deu certo, vamos responder abrindo o resultado no destino.

### m04-a04-b04 — Rotina na nuvem, no desktop ou na sessão

Slide m04-a04-s04

Já sabemos qual processo a rotina inicia. Agora vamos escolher onde ela roda, e isso vem antes de escolher o horário. Na documentação atual do Claude Code, há três opções: tarefas em nuvem, tarefas do desktop e repetições da sessão, como o /loop. Elas não têm as mesmas dependências.

Uma tarefa em nuvem roda nos servidores do fornecedor e pode funcionar sem o seu computador ligado. Em compensação, ela não recebe automaticamente a sua pasta local nem o seu navegador com login já feito. Ela precisa das próprias fontes e conexões.

Uma tarefa do desktop roda no aplicativo instalado no seu computador. Por isso ela pode alcançar os arquivos locais, mas exige a máquina ligada, nas condições do aplicativo.

Uma repetição dentro da sessão, como o /loop, repete um pedido enquanto a conversa está aberta. Por isso ela depende da sessão local ativa.

Existe ainda o controle remoto, que permite interagir com uma execução que continua no seu computador. Ele não transforma esse trabalho em nuvem.

A experiência nova de Claude e Cowork também pode manter trabalho e agendamentos na nuvem, sem depender de um dispositivo ligado. Uma conta mais antiga pode mostrar um fluxo diferente. Por isso, não use a regra “toda rotina precisa deixar o computador ligado”, nem a regra contrária. Leia qual tipo está sendo criado na sua conta.

No nosso caso, a pergunta prática é esta: o ambiente que você escolheu consegue ler a origem de teste, guardar o estado e salvar no destino? Estado é a anotação, guardada fora da conversa, que diz em que ponto está cada reunião, por exemplo “aguardando confirmação”. Vamos usá-lo daqui a pouco. Se faltar um desses três acessos, a existência de um botão de agendamento não resolve.

Escolha um único caminho para o ensaio e ensaie o processo nele primeiro. Só depois prepare a repetição.

### m04-a04-b02 — Local certo, resultado certo

Slide m04-a04-s02

Escolhido o ambiente, vamos criar a rotina nele. Antes, confira uma condição que depende do recurso de agendamento: se ele exige o aplicativo ou a sessão abertos na hora da execução. Isso muda de um recurso para outro. Se o ambiente é local, o computador precisa estar ativo. Escolha pelas dependências do processo, e não só porque existe um botão de agendamento à mão.

Deixe também as permissões definidas antes. Numa rotina, pode não haver ninguém diante da tela para responder a um pedido de permissão. Conceda só o necessário: ler a origem de teste e salvar no destino de teste. O envio ao cliente fica de fora.

Agora vamos configurar a rotina com o recurso de agendamento que a versão desta gravação oferece. Colocamos nela a instrução para o time e as pastas de teste. Se o recurso pedir um horário já na criação, use um horário de teste e confira o fuso, que é a região de referência daquele horário. O horário que vamos manter só vem depois, quando os casos estiverem ensaiados.

Depois de configurar, use a opção de executar agora, se ela existir, para testar sem esperar o horário.

E então vem a conferência. O que precisamos ver é a reunião certa analisada e a saída no destino combinado. Uma notificação de que a execução aconteceu não prova isso. Abra o destino e confira.

Esse primeiro teste mostra o caminho em que tudo dá certo. Falta ensaiar os caminhos em que não dá: sem reunião nova, reunião repetida, falha de conexão e espera por uma pessoa.

### m04-a04-b05 — Esperar aprovação sem deixar a rotina travada

Slide m04-a04-s05

Vamos começar pela espera, porque ela decide como a rotina se comporta nos outros casos. Uma rotina não precisa ficar indefinidamente aberta esperando alguém. Quando chega à confirmação de escopo, ela registra o entendimento, grava o estado “aguardando confirmação” e termina. A pessoa revisa e autoriza uma retomada daquela execução e daquela versão.

Depois da proposta, o estado passa a ser “aguardando aprovação do documento”. Uma nova rodada do agendamento consulta esse estado. Ela não interpreta o silêncio como aprovação e não gera outra proposta para o mesmo trabalho.

Por isso, o contrato precisa dizer três coisas: quem pode aprovar, qual documento está em revisão e o que muda quando o conteúdo é alterado. Esse contrato está no arquivo contrato-aprovacao.md. O arquivo estados-exemplo.json traz exemplos de estado para você seguir.

Antes de agendar, vamos fazer uma execução manual de teste para cada situação. Se há reunião nova, a rotina prepara a etapa permitida e registra a decisão pendente. Se não há reunião nova, ela registra que não havia trabalho e termina sem gerar arquivo vazio. Se a reunião já foi tratada, ela retorna a referência existente e não repete a entrega. Se uma conexão falhou, ela registra o erro e o ponto de retomada, para continuar dali.

Com esses resultados conferidos, configure horário, fuso e frequência no recurso atual. Escreva o fuso de forma explícita, porque o mesmo “oito da manhã” muda conforme a região de referência. Configure apenas uma agenda de teste. Não deixe uma agenda de produção ativa para demonstrar uma aula.

O objetivo é aprender a iniciar o time sem perder o controle das decisões que continuam sendo humanas.

### m04-a04-b06 — Conferir a primeira execução e encerrar o teste

Slide m04-a04-s06

Com a agenda de teste configurada, rode-a uma vez pela execução manual do agendamento, quando esse recurso existir. Abra o histórico, que é a lista das execuções, e abra o destino. A notificação indica que houve uma execução; o documento e o conteúdo dele mostram se a tarefa entregou o que foi combinado. Compare três pontos: a origem de teste, o estado e o destino.

Confira a reunião, a referência do entendimento, a decisão pendente e o documento criado, quando a etapa estiver autorizada. Verifique também o que acontece com um erro de acesso, num cenário controlado de teste. O responsável precisa saber onde acompanhar a falha e como corrigi-la, sem adivinhar se a proposta foi salva.

Agora pause ou remova a rotina de exercício e confirme na interface que ela aparece como pausada ou removida. Uma automação que você não pretende manter não deve continuar consumindo recursos. Guarde o registro do ensaio no arquivo registro-testes.md, junto com a regra que permitiria ativá-la no futuro, no seu processo.

### m04-a04-b03 — A rotina preserva o limite de decisão

Slide m04-a04-s03

Agora, uma conferência importante: o horário não muda a autorização. A proposta deve continuar aguardando revisão, porque agendar a preparação não autoriza enviar o documento ao cliente. Olhe o histórico e a saída para confirmar que nenhum envio aconteceu.

Para concluir o exercício, confira três coisas: a primeira execução, o estado final e onde você acompanharia uma falha. Se a rotina de teste ainda estiver ativa, desative-a agora. Não deixe uma repetição ativa só para mostrar que sabe criá-la.

Na atividade, entregue o desenho da rotina, que são as suas respostas às três perguntas do início, e os resultados dos quatro casos de teste: trabalho novo, nenhum trabalho, trabalho repetido e espera de aprovação. Se a plataforma de agendamento não estiver disponível para você, ensaie esses estados manualmente e registre o agendamento como não executado. Você terá preparado o procedimento, mas só a execução real, no ambiente que você escolheu, comprova que o horário funciona.

Com isso, temos procedimento, ferramentas, coordenação e uma forma de iniciar o trabalho. No próximo módulo, vamos levar esse mesmo raciocínio para o ecossistema da OpenAI e separar o que dá para reaproveitar do que precisa ser adaptado.

# 4.3 — Rotinas: como colocar seu Time de IA para trabalhar sem você precisar acionar

ID m04-a04. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Dependências e ensaio:** Agendamento real e contrato de retomada precisam de ensaio no ambiente escolhido; nenhuma rotina de produção será ativada nesta revisão.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m04-a04-b01 | m04-a04-s01 / p. 1 | Retomar o caso comercial; apresentar uma rotina de verificação de novas reuniões em ambiente de teste, sem criar agenda produtiva. | Agendamento é diferenciado da execução e da conclusão da tarefa. |
| m04-a04-b04 | m04-a04-s04 / p. 2 | Comparar Cloud/Desktop/sessão e escolher ambiente pelo acesso às dependências. | Condição de máquina/app/sessão explicitada sem generalização para toda rotina. |
| m04-a04-b02 | m04-a04-s02 / p. 3 | Demonstrar agendamento no recurso disponível na versão da gravação, executar agora e conferir a saída. Usar origem e destino de teste; desativar após o ensaio. | Executar agora produz resultado conferido em origem/destino de teste. |
| m04-a04-b05 | m04-a04-s05 / p. 4 | Ensaiar rotina com estado de aprovação, ausência de trabalho e reunião já processada. | Rotina encerra/retoma por estado; silêncio não aprova e repetição não cria documento vazio ou duplicado. |
| m04-a04-b06 | m04-a04-s06 / p. 5 | Executar teste, conferir histórico/destino e pausar a rotina criada. | Resultado e estado conferidos; agendamento de teste encerrado e limitações registradas. |
| m04-a04-b03 | m04-a04-s03 / p. 6 | Conferir histórico, saída e ausência de envio automático. Cancelar/desativar o agendamento de exercício após teste. | Ambiente e fuso claros; estados preservados; nenhuma interpretação de silêncio como autorização; rotina final pausada/removida. |

## m04-a04-b01 — Agendar o início não resolve o processo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Retomar o caso comercial; apresentar uma rotina de verificação de novas reuniões em ambiente de teste, sem criar agenda produtiva. | slides/m04-a04.pptx e slides/m04-a04.pdf, página 1, ID m04-a04-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a04-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a04-b01. Sem trilha prevista. |

**Estado inicial:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Entrada/material:** apoio/guia-rotinas.md, apoio/contrato-aprovacao.md, apoio/estados-exemplo.json, apoio/registro-testes.md

**Passos de captura:**
1. Retomar o caso comercial; apresentar uma rotina de verificação de novas reuniões em ambiente de teste, sem criar agenda produtiva.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Agendamento é diferenciado da execução e da conclusão da tarefa.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a04-b01; SHA-256 e5d0a5b4bd7906815dc099cd5ee32a734dc3ad4a1d0c8e35a8eb683cef35b936.

**Função visual:** Retomar o caso comercial; apresentar uma rotina de verificação de novas reuniões em ambiente de teste, sem criar agenda produtiva.


## m04-a04-b04 — Rotina na nuvem, no desktop ou na sessão

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Comparar Cloud/Desktop/sessão e escolher ambiente pelo acesso às dependências. | slides/m04-a04.pptx e slides/m04-a04.pdf, página 2, ID m04-a04-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a04-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a04-b04. Sem trilha prevista. |

**Estado inicial:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Entrada/material:** apoio/guia-rotinas.md, apoio/contrato-aprovacao.md, apoio/estados-exemplo.json, apoio/registro-testes.md

**Passos de captura:**
1. Abrir quadro atualizado e documentação da superfície usada.
2. Conferir onde ficam arquivos, credenciais e estado.
3. Escolher um único caminho para o ensaio.

**Saída e conferência:** Condição de máquina/app/sessão explicitada sem generalização para toda rotina.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a04-b04; SHA-256 a6e453dcf99701830848b20b47b751059958ba210c2886549a7157233bb816a8.

**Função visual:** Comparar Cloud/Desktop/sessão e escolher ambiente pelo acesso às dependências.


## m04-a04-b02 — Local certo, resultado certo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Demonstrar agendamento no recurso disponível na versão da gravação, executar agora e conferir a saída. Usar origem e destino de teste; desativar após o ensaio. | slides/m04-a04.pptx e slides/m04-a04.pdf, página 3, ID m04-a04-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a04-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a04-b02. Sem trilha prevista. |

**Estado inicial:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Entrada/material:** apoio/guia-rotinas.md, apoio/contrato-aprovacao.md, apoio/estados-exemplo.json, apoio/registro-testes.md

**Passos de captura:**
1. Demonstrar agendamento no recurso disponível na versão da gravação, executar agora e conferir a saída. Usar origem e destino de teste; desativar após o ensaio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Executar agora produz resultado conferido em origem/destino de teste.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a04-b02; SHA-256 ad0f5bf9954103c1fa861600e874b8678da9593cce90aeaaffaeb73d8a920c67.

**Função visual:** Demonstrar agendamento no recurso disponível na versão da gravação, executar agora e conferir a saída. Usar origem e destino de teste; desativar após o ensaio.


## m04-a04-b05 — Esperar aprovação sem deixar a rotina travada

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Ensaiar rotina com estado de aprovação, ausência de trabalho e reunião já processada. | slides/m04-a04.pptx e slides/m04-a04.pdf, página 4, ID m04-a04-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a04-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a04-b05. Sem trilha prevista. |

**Estado inicial:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Entrada/material:** apoio/guia-rotinas.md, apoio/contrato-aprovacao.md, apoio/estados-exemplo.json, apoio/registro-testes.md

**Passos de captura:**
1. Usar contrato-aprovacao.md e estados-exemplo.json.
2. Executar manualmente antes de agendar.
3. Conferir ausência de trabalho e reunião repetida.
4. Configurar apenas agenda de teste com fuso explícito.

**Saída e conferência:** Rotina encerra/retoma por estado; silêncio não aprova e repetição não cria documento vazio ou duplicado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a04-b05; SHA-256 592e1571fc52033a8c56f74d56b8864bae548b518aa36920ee5598f887d7f7ad.

**Função visual:** Ensaiar rotina com estado de aprovação, ausência de trabalho e reunião já processada.


## m04-a04-b06 — Conferir a primeira execução e encerrar o teste

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar teste, conferir histórico/destino e pausar a rotina criada. | slides/m04-a04.pptx e slides/m04-a04.pdf, página 5, ID m04-a04-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a04-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a04-b06. Sem trilha prevista. |

**Estado inicial:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Entrada/material:** apoio/guia-rotinas.md, apoio/contrato-aprovacao.md, apoio/estados-exemplo.json, apoio/registro-testes.md

**Passos de captura:**
1. Rodar agora e comparar origem, estado e destino.
2. Observar falha de acesso no cenário controlado.
3. Pausar/remover rotina de exercício e confirmar na interface.

**Saída e conferência:** Resultado e estado conferidos; agendamento de teste encerrado e limitações registradas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a04-b06; SHA-256 4e060e496cce5a5141aa8331635c9ca5bb274ee4fd6d96444ac6691c33e92d05.

**Função visual:** Executar teste, conferir histórico/destino e pausar a rotina criada.


## m04-a04-b03 — A rotina preserva o limite de decisão

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir histórico, saída e ausência de envio automático. Cancelar/desativar o agendamento de exercício após teste. | slides/m04-a04.pptx e slides/m04-a04.pdf, página 6, ID m04-a04-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m04-a04-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m04-a04-b03. Sem trilha prevista. |

**Estado inicial:** Time testado, estado durável definido e agendamento disponível na superfície escolhida. Usar somente origem/destino de teste.

**Entrada/material:** apoio/guia-rotinas.md, apoio/contrato-aprovacao.md, apoio/estados-exemplo.json, apoio/registro-testes.md

**Passos de captura:**
1. Conferir histórico, saída e ausência de envio automático. Cancelar/desativar o agendamento de exercício após teste.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Ambiente e fuso claros; estados preservados; nenhuma interpretação de silêncio como autorização; rotina final pausada/removida.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m04-a04-b03; SHA-256 86437c43a697742d7d90304383e7d9d6c375fdc47667a09f9ed0f1c080e6d008.

**Função visual:** Conferir histórico, saída e ausência de envio automático. Cancelar/desativar o agendamento de exercício após teste.


## Atividade e solução

Ensaiar quatro estados e criar uma rotina de teste, conferir a primeira execução e desativá-la.

Ambiente e fuso claros; estados preservados; nenhuma interpretação de silêncio como autorização; rotina final pausada/removida.

## Materiais

- guia-rotinas.md
- contrato-aprovacao.md
- estados-exemplo.json
- registro-testes.md

# 5.1 — Mapa de equivalências e migração / m05-a01

**Objetivo:** Construir mapa de equivalências e identificar diferenças de arquivos, skills, plugins, MCP, agendamento e custos.

**Preparação:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Ensaio:** Telas, modelo e disponibilidade de plugins/conectores devem ser conferidos na conta da gravação.

### m05-a01-b01 — Levar o método, conferir o ambiente

Slide m05-a01-s01

Até aqui, você aprendeu a definir uma tarefa, guardar um procedimento numa skill, conectar ferramentas e conferir a entrega. A skill, lembrando, é um procedimento escrito que o agente consulta: um arquivo principal, materiais de apoio e, às vezes, programas pequenos chamados scripts. Esse raciocínio todo não depende de uma interface específica.

Agora vamos levá-lo para o ecossistema da OpenAI. Dá para reaproveitar a intenção do processo, os critérios, os arquivos de exemplo e parte das instruções. O que precisa ser conferido é como o novo ambiente encontra essas instruções e como ele acessa as ferramentas. Também não vêm junto automaticamente as permissões que você concedeu e as regras de custo: cada ambiente tem as suas.

Por isso, migrar não é copiar uma pasta e presumir que tudo funciona. Vamos usar um mapa de equivalências. A ideia é comparar por função, e não pelo nome na tela. Para cada peça do projeto, o mapa mostra o que ela faz, qual é o caminho correspondente do outro lado, do que ela depende e como testar se funcionou. Esse registro vai para o checklist de migração, que você vai preencher ao longo da aula.

### m05-a01-b04 — Chat, Work e Codex no mapa atual

Slide m05-a01-s04

Vamos começar pelo ecossistema da OpenAI, distinguindo três superfícies, que são os lugares onde você usa a ferramenta: Chat, Work e Codex. O Chat atende conversas e perguntas do dia a dia. O Work é voltado a trabalho de várias etapas e entregáveis. O Codex é o ambiente para desenvolvimento e trabalho técnico, e é nele que vamos demonstrar o projeto, porque é onde trabalhamos com pastas, skills e conexões. Há recursos compartilhados entre as três, mas o acesso a arquivos, as ferramentas e a execução mudam conforme a superfície e a conta.

Agora, o modelo, que é o motor de linguagem que a ferramenta usa para raciocinar e responder. Na referência consultada em dois de novembro de dois mil e vinte e seis, a documentação da OpenAI menciona o GPT-6.1 Sol e outros modelos, com disponibilidade que depende do plano e da liberação gradual. Por isso, não escolha um modelo fixo só porque ele aparece numa gravação, inclusive nesta: abra o seletor da sua conta e veja o que está disponível agora. O GPT-5.5, por exemplo, saiu do Codex com login ChatGPT em catorze de outubro de dois mil e vinte e seis. Essa informação vale para esse tipo de login, e não para todas as formas de acesso.

Para custo e uso, abra nos materiais da aula a matriz de contas e custos e o arquivo de referências, que apontam para as páginas oficiais atuais. Separe três coisas: a capacidade incluída no seu plano, os créditos adicionais e os serviços conectados, que cobram por conta própria. Do lado do Claude acontece o mesmo: modelos como o Fable dependem do plano e, em alguns planos, exigem créditos. E um serviço como o WhatsApp oficial cobra conforme a entrega da mensagem, a categoria e o mercado, com isenções; essa cobrança vem do serviço, não do plano de IA. A mesma tarefa pode custar diferente conforme o modelo, o esforço, que é quanto raciocínio o modelo dedica antes de responder, e a quantidade de correções. Por isso não vamos fixar tarifa em fala: ela muda.

O objetivo da formação continua sendo construir uma solução efetiva e verificável, não trocar de ferramenta sempre que aparece um nome novo. Então vamos escolher um ambiente que esteja disponível na sua conta e repetir um caso pequeno com os mesmos critérios.

### m05-a01-b02 — As correspondências que importam

Slide m05-a01-s02

O mapa se resume a quatro perguntas. Onde ficam as instruções que valem para o trabalho? Onde a skill é encontrada? Como a ferramenta externa é conectada? E como a execução vai ser conferida ou agendada? Neste bloco vamos responder às duas primeiras, procurando no seu próprio ambiente. As outras duas vêm nos blocos seguintes.

Começando pelas instruções. CLAUDE.md e AGENTS.md são arquivos de texto, guardados no projeto, que orientam o agente: como escrever, o que evitar, quais critérios seguir. Quais deles são lidos, e qual vale mais quando há mais de um, dependem da ferramenta e da configuração. Por isso, não presuma: peça à própria ferramenta que diga quais instruções carregou e confira. Isso importa porque o que foi carregado entra no contexto, que é tudo o que a ferramenta tem diante de si naquela conversa, e o contexto tem limite de tamanho.

Vou mostrar o caminho. Abro a pasta do projeto e procuro, na raiz, arquivos chamados CLAUDE.md e AGENTS.md, anotando quais existem. Depois escrevo ao Codex: quais arquivos de instruções do projeto você carregou? Liste o caminho de cada um e resuma o que cada um pede. Comparo a resposta com o que encontrei na pasta. Se a resposta citar um arquivo que eu não esperava, ou omitir um que existe, essa é exatamente a diferença que o mapa precisa registrar.

Agora, as skills. Cada ambiente tem seus locais e sua forma de distribuição. No Claude Code, as skills ficam em .claude/skills; o Codex também lê diretórios como .agents/skills. Ainda assim, um formato parecido não garante que referências, caminhos, scripts e permissões vieram junto. Então procuro as pastas de skills no projeto, abro o SKILL.md da skill de resumo e vejo se há arquivos de referência e scripts ao lado dele. Faço essa inspeção antes da primeira execução, e não depois que algo falhar.

A terceira pergunta, as conexões, começa com uma olhada na área de conexões ou plugins da ferramenta, no nome que aparecer na sua versão. Por enquanto só listo o que está conectado e o que está disponível, sem conectar nada.

Planos, preços e nomes mudam com o tempo, dos dois lados. No Claude, por exemplo, Chat e Cowork estão sendo unificados; se você não encontrar o seletor Cowork, peça a tarefa na própria conversa. Por isso, a referência atual fica separada do procedimento: se a tarifa ou o nome mudar, a lógica da aula continua clara. E, na OpenAI, o que importa é a tarefa e os recursos disponíveis na superfície onde você está: Work e Codex podem compartilhar conceitos e integrações, mas as telas e os recursos não são idênticos.

Agora é com você. Pause o vídeo e faça essa busca no seu ambiente: localize as instruções do projeto, as skills e as conexões, e peça para a ferramenta informar qual arquivo de instruções ela carregou. Confira a resposta contra o que você encontrou. E deixe as configurações globais como estão: elas valem para todos os seus projetos, e aqui estamos apenas lendo e anotando.

### m05-a01-b05 — Skills, plugins, MCP e instruções na transferência

Slide m05-a01-s05

Agora vamos traduzir as peças, uma de cada vez. Primeiro, crio uma cópia isolada da skill de resumo e dos arquivos de instruções, numa pasta separada. Trabalhar na cópia permite errar, comparar com o original e voltar atrás.

Segundo passo: a skill. Ela continua sendo um procedimento com arquivo principal, o SKILL.md, referências e, quando necessário, scripts. No Codex, os diretórios de descoberta, isto é, os lugares onde a ferramenta procura skills, incluem os caminhos documentados para o agente, como .agents/skills. Não basta copiar uma pasta para qualquer lugar e esperar que ela apareça. Na cópia, vejo em que caminho a skill está hoje e para qual caminho ela precisa ir.

Terceiro passo: as instruções. AGENTS.md pode guardar as orientações do projeto. Abro o CLAUDE.md e o AGENTS.md lado a lado e leio o conteúdo, preservando apenas o que se aplica ao novo ambiente. O critério da tarefa, como o formato do resumo e o que conferir, passa direto. Comandos, nomes de ferramentas e caminhos que dependem do Claude precisam de adaptação. Um exemplo: se uma linha manda conferir o consumo com o comando /usage, esse é um comando do Claude Code, e a linha precisa ser trocada pela forma equivalente do novo ambiente ou removida. Se o produto oferecer importação assistida, e a documentação do app-server da OpenAI descreve uma que não sobrescreve skills já existentes, use-a como ponto de partida: revise os itens detectados e confira o resultado. Não suponha que toda configuração foi transferida.

Quarto passo: ferramentas e conexões. Plugins podem distribuir skills e conexões num pacote só. MCP, sigla de Model Context Protocol, é o padrão aberto que permite a um assistente se conectar a um serviço externo, como o Notion. O conector é a integração que aparece pronta no cliente, e pode usar MCP por baixo. A configuração e o login pertencem ao cliente e à conta. Instalar o plugin não dispensa a autorização do serviço. E mesmo uma conexão só de leitura pode expor informação sensível, então conceda apenas o necessário: no nosso caso, a página fictícia do exercício. Confira também os scripts: o programa que a skill usa precisa existir no ambiente onde vai executar, e ele pode ter ficado instalado só no computador de origem.

Quinto passo: o registro. Para cada adaptação, anoto uma linha no checklist: o que mudou, por quê e como vou testar.

Para fechar, monte a equivalência por função. Procedimento vira procedimento reconhecido pelo agente. Instrução de projeto vai para o arquivo lido naquele contexto. Ferramenta externa precisa de conexão disponível e autorizada. E o teste da migração é a execução com a mesma entrada e o mesmo critério, não a semelhança do nome na interface.

### m05-a01-b06 — Agendamento e o que muda amanhã

Slide m05-a01-s06

O último ponto do mapa é o agendamento, ou seja, fazer uma tarefa rodar sozinha em horário definido. Ele também precisa de equivalência pelo ambiente, porque onde a rotina roda muda o que ela enxerga. Uma tarefa local no desktop usa o projeto disponível naquele computador e depende de máquina e aplicativo nas condições documentadas: computador ligado, aplicativo disponível e a pasta acessível. Uma tarefa web ou de nuvem usa o contexto enviado e as conexões daquele ambiente; não ganha sua pasta local automaticamente. A CLI, que é a ferramenta usada por comandos escritos no terminal, pode ajudar a preparar o procedimento, mas não oferece a mesma interface de gerenciamento de tarefas agendadas.

Antes de levar uma rotina, teste manualmente a ação no destino. Depois confira quatro coisas. Primeiro, horário e fuso, que é a referência de hora usada: uma rotina marcada para as oito pode rodar em outro momento se o fuso for diferente do seu. Segundo, os dados acessíveis naquele ambiente. Terceiro, o estado de aprovação: se a rotina termina enviando algo para fora, como um e-mail ou uma mensagem a um cliente, o envio deve ficar aguardando a sua aprovação. A rotina prepara, você decide. Quarto, como você vai acompanhar uma falha. Uma rotina que inicia na nuvem e precisa de um arquivo que só existe no seu computador não está completa.

Nomes e recursos podem mudar entre a gravação e o momento em que você assiste. Use as referências atualizadas e a comunidade da turma para localizar a função equivalente. O principal é preservar o contrato: o que entra, o que pode acontecer, o que sai e onde alguém decide.

Com isso, o núcleo previsto para esta migração é pequeno: na próxima aula vamos demonstrar uma skill de resumo e um MCP lendo uma página do Notion. Levar o time inteiro de propostas fica como extensão opcional, depois que esse caminho pequeno estiver funcionando.

### m05-a01-b03 — Um mapa que vira teste

Slide m05-a01-s03

O que permanece na migração é o critério do trabalho. Por isso, na próxima aula vamos usar a mesma entrada de antes e verificar o mesmo que verificávamos: decisões, responsáveis, pendências e informações ausentes. Se o resultado cumprir esses quatro pontos, a migração funcionou; se não, o checklist mostra onde procurar.

Agora, a preparação. Abro o checklist de migração e percorro cada linha: função, destino, dependências e teste. Em seguida, reúno numa pasta separada a cópia da skill e as cópias dos arquivos fictícios do caso, e deixo os originais sem mexer. Isso protege o que já funciona e permite comparar o antes e o depois. Deixo também uma página fictícia no Notion, com uma reunião inventada, para a leitura da próxima aula.

Faça o mesmo no seu ambiente. Percorra o checklist e prepare a sua cópia isolada. Localize onde o Codex encontra as instruções e como a conexão com o Notion será autorizada. Se faltar uma ferramenta, registre a dependência específica, por exemplo, conector do Notion ainda não conectado, em vez de um genérico não funcionou. Não é preciso recomeçar todos os módulos por causa de uma diferença de configuração.

Queremos chegar a uma skill e um MCP funcionando juntos, com uma saída que você consegue conferir.

# 5.1 — Mapa de equivalências e migração

ID m05-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Dependências e ensaio:** Telas, modelo e disponibilidade de plugins/conectores devem ser conferidos na conta da gravação.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m05-a01-b01 | m05-a01-s01 / p. 1 | Apresentar correspondências funcionais entre o projeto no Claude e o Codex; usar apoio/migracao-checklist.md. | Correspondências são funcionais, sem prometer compatibilidade automática. |
| m05-a01-b04 | m05-a01-s04 / p. 2 | Mostrar mapa Chat/Work/Codex e referências atuais de uso, sem fixar tarifa em fala. | Aluno diferencia superfícies e consulta preço/uso da conta atual. |
| m05-a01-b02 | m05-a01-s02 / p. 3 | Localizar no ambiente atual instruções de projeto, skills e conexões; conferir arquivo carregado. Não alterar configurações globais durante a preparação. | Arquivo de instruções e recursos realmente carregados são localizados. |
| m05-a01-b05 | m05-a01-s05 / p. 4 | Preencher equivalência funcional e inspecionar uma cópia de skill e instruções. | Transferência preserva critério e identifica adaptação técnica específica. |
| m05-a01-b06 | m05-a01-s06 / p. 5 | Comparar rotina local/cloud e preparar migração pequena em vez de ampliar o escopo obrigatório. | Aluno separa configuração de rotina e migração funcional; time completo é extensão opcional. |
| m05-a01-b03 | m05-a01-s03 / p. 6 | Fechar checklist da migração da skill de resumo + Notion; separar extensão opcional do time de propostas. | Cada função tem destino, dependências e teste; permissões/custos não considerados automaticamente transferidos. |

## m05-a01-b01 — Levar o método, conferir o ambiente

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar correspondências funcionais entre o projeto no Claude e o Codex; usar apoio/migracao-checklist.md. | slides/m05-a01.pptx e slides/m05-a01.pdf, página 1, ID m05-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a01-b01. Sem trilha prevista. |

**Estado inicial:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Entrada/material:** apoio/mapa-equivalencias.md, apoio/migracao-checklist.md, apoio/matriz-contas-custos.md, apoio/referencias.md

**Passos de captura:**
1. Apresentar correspondências funcionais entre o projeto no Claude e o Codex; usar apoio/migracao-checklist.md.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Correspondências são funcionais, sem prometer compatibilidade automática.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a01-b01; SHA-256 3ea56a486f4413fa327f8ac05c01973d493c552d43c6460f54915b69a4dcfc05.

**Função visual:** Apresentar correspondências funcionais entre o projeto no Claude e o Codex; usar apoio/migracao-checklist.md.


## m05-a01-b04 — Chat, Work e Codex no mapa atual

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Mostrar mapa Chat/Work/Codex e referências atuais de uso, sem fixar tarifa em fala. | slides/m05-a01.pptx e slides/m05-a01.pdf, página 2, ID m05-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a01-b04. Sem trilha prevista. |

**Estado inicial:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Entrada/material:** apoio/mapa-equivalencias.md, apoio/migracao-checklist.md, apoio/matriz-contas-custos.md, apoio/referencias.md

**Passos de captura:**
1. Abrir a documentação oficial de Work/Codex e pricing.
2. Identificar superfície e recursos da conta usada.
3. Conferir seletor atual e evitar modelo retirado no login usado.

**Saída e conferência:** Aluno diferencia superfícies e consulta preço/uso da conta atual.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a01-b04; SHA-256 48c995c76b420e47e075f6871ea311043229b7270213b2d071f1ad00295bc93c.

**Função visual:** Mostrar mapa Chat/Work/Codex e referências atuais de uso, sem fixar tarifa em fala.


## m05-a01-b02 — As correspondências que importam

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Localizar no ambiente atual instruções de projeto, skills e conexões; conferir arquivo carregado. Não alterar configurações globais durante a preparação. | slides/m05-a01.pptx e slides/m05-a01.pdf, página 3, ID m05-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a01-b02. Sem trilha prevista. |

**Estado inicial:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Entrada/material:** apoio/mapa-equivalencias.md, apoio/migracao-checklist.md, apoio/matriz-contas-custos.md, apoio/referencias.md

**Passos de captura:**
1. Localizar no ambiente atual instruções de projeto, skills e conexões; conferir arquivo carregado. Não alterar configurações globais durante a preparação.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Arquivo de instruções e recursos realmente carregados são localizados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a01-b02; SHA-256 79e8ff5ac7652a79e8f8f02bb8b23878b7d5e6216adec7acf8460136043a9982.

**Função visual:** Localizar no ambiente atual instruções de projeto, skills e conexões; conferir arquivo carregado. Não alterar configurações globais durante a preparação.


## m05-a01-b05 — Skills, plugins, MCP e instruções na transferência

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preencher equivalência funcional e inspecionar uma cópia de skill e instruções. | slides/m05-a01.pptx e slides/m05-a01.pdf, página 4, ID m05-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a01-b05. Sem trilha prevista. |

**Estado inicial:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Entrada/material:** apoio/mapa-equivalencias.md, apoio/migracao-checklist.md, apoio/matriz-contas-custos.md, apoio/referencias.md

**Passos de captura:**
1. Criar cópia isolada dos arquivos.
2. Comparar CLAUDE.md/AGENTS.md e caminhos de skills.
3. Conferir referências, scripts, ferramentas e autenticação.
4. Registrar cada adaptação no checklist.

**Saída e conferência:** Transferência preserva critério e identifica adaptação técnica específica.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a01-b05; SHA-256 5dbf592acb3f6cd4b6010bd499cc5320551a8ca45ca0921af84907adcfa2dd29.

**Função visual:** Preencher equivalência funcional e inspecionar uma cópia de skill e instruções.


## m05-a01-b06 — Agendamento e o que muda amanhã

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Comparar rotina local/cloud e preparar migração pequena em vez de ampliar o escopo obrigatório. | slides/m05-a01.pptx e slides/m05-a01.pdf, página 5, ID m05-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a01-b06. Sem trilha prevista. |

**Estado inicial:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Entrada/material:** apoio/mapa-equivalencias.md, apoio/migracao-checklist.md, apoio/matriz-contas-custos.md, apoio/referencias.md

**Passos de captura:**
1. Apontar dependências de cada ambiente.
2. Revisar checklist antes de agendar.
3. Definir skill de resumo + Notion como núcleo da próxima aula.

**Saída e conferência:** Aluno separa configuração de rotina e migração funcional; time completo é extensão opcional.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a01-b06; SHA-256 131a3ecd92bf32e87ca9cd97185f07cea29da337ef5f90ef9143f5399da332d7.

**Função visual:** Comparar rotina local/cloud e preparar migração pequena em vez de ampliar o escopo obrigatório.


## m05-a01-b03 — Um mapa que vira teste

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Fechar checklist da migração da skill de resumo + Notion; separar extensão opcional do time de propostas. | slides/m05-a01.pptx e slides/m05-a01.pdf, página 6, ID m05-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a01-b03. Sem trilha prevista. |

**Estado inicial:** Preparar Codex atualizado, cópia isolada da skill e uma página Notion fictícia; conferir planos e referências oficiais.

**Entrada/material:** apoio/mapa-equivalencias.md, apoio/migracao-checklist.md, apoio/matriz-contas-custos.md, apoio/referencias.md

**Passos de captura:**
1. Conferir os itens do checklist e preparar uma cópia isolada dos arquivos fictícios do caso.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Cada função tem destino, dependências e teste; permissões/custos não considerados automaticamente transferidos.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a01-b03; SHA-256 94602a665408d4fc23b9c33c6135e4202c98af925dcfaccad5e71a82c3c34ce3.

**Função visual:** Conferir os itens do checklist e preparar uma cópia isolada dos arquivos fictícios do caso.


## Atividade e solução

Preencher checklist de migração com a skill de resumo e uma conexão de leitura, sem alterar configuração global.

Cada função tem destino, dependências e teste; permissões/custos não considerados automaticamente transferidos.

## Materiais

- mapa-equivalencias.md
- migracao-checklist.md
- matriz-contas-custos.md
- referencias.md

# 5.2 — O projeto rodando no Codex / m05-a02

**Objetivo:** Executar no Codex uma skill e um MCP já estudados, com a mesma entrada e critérios.

**Preparação:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Ensaio:** Teste autenticado do Notion no Codex e execução combinada precisam de ensaio; não presumir herança da conexão Claude.

### m05-a02-b01 — A mesma entrada torna a comparação útil

Slide m05-a02-s01

Nesta aula vamos levar para o Codex duas peças que você já conhece da formação: uma skill e uma conexão por MCP. Skill é uma pasta com o procedimento escrito, em um arquivo chamado SKILL.md, que traz nome, descrição, instruções e, se for preciso, arquivos de referência. Aqui será o procedimento de resumo de conversa. MCP é um protocolo aberto de conexão, um padrão que permite a um assistente de IA buscar informação em um serviço. No nosso caso, vai ler uma página fictícia do Notion.

Essas duas peças são o núcleo da migração, e é isso que vamos cumprir agora. O time inteiro de propostas fica como prática opcional, no final da aula.

Vamos usar a mesma entrada que usamos antes, porque só assim a comparação ensina alguma coisa. Se eu trocasse a conversa e o resumo saísse diferente, não saberia dizer se a causa foi o texto ou o ambiente. Por isso mantemos os mesmos arquivos de apoio do módulo quatro e os mesmos critérios. A saída separa decisões, ações e perguntas abertas. Responsável e prazo aparecem apenas quando a fonte informa; quando ela não informa, a saída registra que está em aberto. E o resumo deve ser salvo em um arquivo que conseguimos abrir, para conferir depois.

Começo pela cópia de exercício. Cópia isolada quer dizer uma pasta separada, só para este teste, de modo que o seu trabalho real não seja alterado e um erro aqui não atinja o original. Nela, primeiro identifico o que o Codex reconhece e, depois, confiro a conexão com o Notion.

Faço nessa ordem por uma razão. Uma skill pode citar uma ferramenta no texto, mas escrever o nome da ferramenta não a instala nem a autoriza. Então vamos observar três coisas, uma de cada vez: se o Codex descobre o procedimento, se a ferramenta acessa a fonte e se a entrega chega como arquivo.

### m05-a02-b04 — Levar uma skill e um MCP, preservando a entrada

Slide m05-a02-s04

Vamos preparar a cópia de exercício da skill de resumo. Copie a pasta da skill para dentro do projeto de teste, sem nenhuma credencial. Se existir senha, token ou chave escrita em algum arquivo, não leve para a cópia. Em seguida, revise as dependências, que são os scripts ou programas que a skill chama. Leia o SKILL.md e esses arquivos antes de deixar qualquer coisa rodar. Confira o nome, a descrição, as instruções e os arquivos de referência.

A regra continua a mesma: separar decisões, ações e perguntas abertas e não inventar responsável nem prazo. Se a skill contém um comando específico do Claude, adapte só o mecanismo, ou seja, a forma de chamar a ferramenta, sem alterar esse critério. O critério é o que garante que estamos comparando a mesma tarefa.

Agora confira como o Codex descobre a pasta. No Claude Code, as skills ficam em .claude/skills. O Codex também lê diretórios .agents/skills, então esse é o local de projeto que vamos usar; confira na documentação da sua versão se ele continua valendo. Com a cópia nesse lugar, peça ao Codex para identificar a skill de resumo. Depois abra o arquivo que ele indicou e verifique se é o da cópia de exercício, e não outra versão global com o mesmo nome. Se você usar a importação assistida de configuração externa que o Codex documenta, ela não sobrescreve skills existentes. Mesmo assim, olhe o que foi importado e de onde veio. Descoberta é uma etapa. O comportamento da skill só será testado em seguida.

Agora a conexão com o Notion. Use o recurso que a sua conta oferece. Se for um plugin ou um app, que é um pacote que pode reunir skills, conexões e outros recursos, leia o que ele inclui e siga a autorização do próprio serviço. Instalar o pacote não concede, por si só, o acesso ao Notion. Se for uma configuração de MCP, use o caminho documentado para o Codex. Em qualquer caso, conceda apenas o escopo necessário. Ler também pode expor informação sensível, então a permissão precisa cobrir a página do exercício e nada além.

Confirme a conta e confirme a página fictícia do módulo três. Aqui vale um cuidado: ter autorizado o Notion em outro ambiente não prova que esta sessão do Codex recebeu o mesmo acesso. Cada ambiente tem a sua conexão, e nós a verificamos.

Antes de resumir, faça uma leitura pequena. Peça ao Codex para ler a página pelo identificador dela, e não por um título aproximado, e compare o que veio com o Notion aberto ao lado. Com isso separamos duas perguntas: o Codex encontrou o procedimento certo? A ferramenta conseguiu buscar a fonte certa? Quando as duas respostas forem sim, podemos testar o trabalho completo.

### m05-a02-b02 — Rodar e comparar

Slide m05-a02-s02

Agora vamos acionar a tarefa no Codex, com o procedimento e a conexão já conferidos. A ideia desta etapa é fixar o que vamos observar, e o passo a passo vem logo depois.

O pedido precisa citar três coisas: a página de exercício, a skill de resumo e a pasta de saída. Use uma pasta de teste separada, para que um resultado antigo não se misture com o novo e não gere arquivos duplicados.

A primeira conferência é a origem. O texto que o Codex recebeu corresponde à página que escolhemos? Se não corresponde, não adianta olhar o resumo.

Depois abrimos o arquivo salvo e conferimos quatro itens: a decisão, a ação com seu responsável, a pendência e o prazo que não foi definido. O resultado não pode preencher uma ausência só para parecer completo.

Em seguida repetimos com a entrada incompleta e comparamos com os critérios que usamos no Claude. Se houver diferença, investigamos cinco possíveis causas: a instrução carregada, o caminho, a ferramenta, a permissão e a interpretação do pedido. Corrigimos a parte responsável e repetimos só o teste afetado.

Uma conclusão importante: só uma execução com fonte e saída observadas comprova que esta migração funcionou. Uma resposta plausível, ou uma pasta copiada, não substitui essa conferência.

### m05-a02-b05 — Executar, salvar e comparar os dois casos

Slide m05-a02-s05

Vamos executar. Peça ao Codex para buscar a página identificada, aplicar a skill de resumo e salvar o resultado na pasta de saída. Não deixe a origem implícita no nome da empresa nem em um título aproximado, porque duas páginas podem parecer iguais. Use a referência exata do recurso preparado para o teste.

Se o Codex pedir permissão, aprove o que corresponde ao pedido: ler aquela página e gravar naquela pasta. Se pedir algo além disso, pare e entenda por quê antes de aprovar. Nesta aula nada é enviado a ninguém; o resultado fica em um arquivo.

Quando a execução terminar, abra o arquivo salvo. Confira a decisão, a ação, o responsável, a pendência e o prazo. Compare também a fonte registrada. Se você recebeu só uma resposta na conversa, falta a entrega em arquivo que pedimos. Se o conteúdo veio de outra página, o teste falhou, mesmo que o resumo esteja bem escrito.

Agora a segunda rodada. Abra uma conversa nova, para que o contexto da primeira, isto é, tudo o que o Codex já leu e respondeu nela, não seja reaproveitado. Use a entrada incompleta, em uma página ou arquivo identificado separadamente. O resultado deve manter as ausências. Se o responsável ou o prazo da primeira rodada aparecerem aqui, é sinal de que a informação vazou de uma conversa para a outra, e o teste falhou. Compare com o gabarito que usamos no Claude.

Se aparecer uma diferença, procure a causa antes de trocar tudo. A skill foi carregada? O caminho da referência é válido? A ferramenta retornou o documento completo, ou só um trecho? A regra foi interpretada de outra forma? Corrija uma causa por vez e repita os casos afetados. Anote a diferença e a correção no registro de testes, porque vamos precisar delas no fim.

O que estamos validando é a migração desta tarefa, com esta conexão. Não estamos provando que todos os recursos dos dois produtos são equivalentes.

### m05-a02-b06 — Escolher ferramenta e concluir o projeto pessoal

Slide m05-a02-s06

Você acabou de comparar o mesmo procedimento em dois ambientes. Abra o checklist de migração e o registro de testes e anote primeiro o que precisou mudar: o caminho da skill, o arquivo de instruções do projeto, a conexão, a autenticação ou algum comando. Depois anote o que permaneceu: a entrada, os critérios e a conferência. Escreva ao lado de cada diferença a evidência de que você a conferiu, como o arquivo aberto ou a página comparada.

Agora avalie qual ambiente atende melhor ao seu processo. Considere quatro coisas: os acessos que você já tem, a qualidade que observou nos testes, o custo de uso e o esforço de manter a solução funcionando.

Sobre acesso e custo, confira na sua conta, na data em que você for decidir. Modelos e recursos variam conforme o plano e a liberação gradual do fornecedor. No Claude, por exemplo, os modelos da família Fable estão incluídos com limite próprio em alguns planos, e em outros exigem créditos. Os limites de uso são compartilhados entre as superfícies, e você os vê em Settings, Usage, ou com o comando /usage. Créditos adicionais são cobrados por uso. No lado da OpenAI, a disponibilidade de modelos e planos também varia, e vale conferir a página de preços do Codex antes de assumir qualquer modelo específico.

Se o seu processo precisar rodar sozinho em horários marcados, some mais um critério: onde a tarefa roda. Tarefa local depende do computador e do aplicativo ligados e da pasta disponível. Tarefa na nuvem não depende do seu computador, mas só enxerga o contexto que você enviou e as conexões que ela mesma tem. E o Codex em linha de comando não oferece a interface de agendamento.

Escolher uma ferramenta, portanto, significa decidir por essas condições. Não existe uma nota única que diga qual é melhor, e também não vale tratar as duas como se fossem iguais.

Para concluir o núcleo da formação, entregue seu processo pessoal com mapa, skill, ferramenta e testes. Use a rubrica do material, com seus quatro níveis, para avaliar clareza, correção, limites e retomada. Se ainda falta uma integração, mostre o que foi executado e o que depende dela. Liste as pendências concretas separadas da extensão opcional. Um texto dizendo que vai funcionar não substitui a prova do resultado.

Se quiser aprofundar, migre também o time completo de propostas e repita seus testes de escopo, preço, aprovação e retomada. Lembre que qualquer mensagem a cliente continua sujeita à sua aprovação. Essa é uma extensão, não uma exigência nova para concluir esta aula.

### m05-a02-b03 — Escolher sem perder o processo

Slide m05-a02-s03

Você pode escolher o ambiente pela tarefa, pelo acesso necessário, pela qualidade e pelo custo. O que dá continuidade ao seu trabalho é um processo que você entende e critérios que consegue conferir.

Seu exercício tem três partes. Primeiro, execute a skill e a conexão nos dois casos, o normal e o incompleto. Segundo, registre uma diferença concreta da migração. Terceiro, mostre como você abriu e conferiu a entrega. Depois aplique o mesmo método ao seu projeto pessoal.

Com isso, terminamos o núcleo da formação. No bônus, vamos acrescentar o WhatsApp a um processo, preservando a diferença entre o canal e o time que faz o trabalho. Vamos ver também como funciona a cobrança do WhatsApp oficial, que depende da entrega, da categoria da mensagem e do mercado, e como qualquer envio continua dependendo da sua aprovação.

# 5.2 — O projeto rodando no Codex

ID m05-a02. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Dependências e ensaio:** Teste autenticado do Notion no Codex e execução combinada precisam de ensaio; não presumir herança da conexão Claude.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m05-a02-b01 | m05-a02-s01 / p. 1 | Mostrar cópia da skill de resumo e conexão de leitura Notion no projeto Codex. | Procedimento correto e fonte identificados; time de propostas é opcional. |
| m05-a02-b04 | m05-a02-s04 / p. 2 | Instalar cópia da skill no projeto Codex e autorizar leitura da página Notion de exercício. | Skill e fonte corretas identificadas antes da execução combinada. |
| m05-a02-b02 | m05-a02-s02 / p. 3 | Executar resumo da página fictícia no Codex, salvar arquivo e repetir com entrada incompleta. | Arquivo real preserva decisões, responsáveis e ausências nos dois casos. |
| m05-a02-b05 | m05-a02-s05 / p. 4 | Executar resumo com Notion no Codex, salvar arquivo e repetir entrada incompleta. | Duas entregas reais conferidas e regra de ausência preservada. |
| m05-a02-b06 | m05-a02-s06 / p. 5 | Comparar diferenças e aplicar rubrica do projeto pessoal; indicar time completo como opcional. | Migração do núcleo comprovada e projeto avaliado com evidência, sem impor o time completo. |
| m05-a02-b03 | m05-a02-s03 / p. 6 | Apresentar registro da migração e rubrica do projeto pessoal. | Diferença concreta documentada e entrega conferida; nenhum escopo adicional obrigatório. |

## m05-a02-b01 — A mesma entrada torna a comparação útil

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar cópia da skill de resumo e conexão de leitura Notion no projeto Codex. | slides/m05-a02.pptx e slides/m05-a02.pdf, página 1, ID m05-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a02-b01. Sem trilha prevista. |

**Estado inicial:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/migracao-checklist.md, apoio/projeto-final.md, apoio/registro-testes.md

**Passos de captura:**
1. Mostrar cópia da skill de resumo e conexão de leitura Notion no projeto Codex.
2. Abrir a referência citada e comparar com a entrada e o critério.

**Saída e conferência:** Procedimento correto e fonte identificados; time de propostas é opcional.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a02-b01; SHA-256 f50fc3ece165d37a616a63619d9e4daf332af3da12b5777a33ae8abf39a55571.

**Função visual:** Abrir uma cópia isolada do caso no Codex e os mesmos arquivos de apoio do módulo 4.


## m05-a02-b04 — Levar uma skill e um MCP, preservando a entrada

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Instalar cópia da skill no projeto Codex e autorizar leitura da página Notion de exercício. | slides/m05-a02.pptx e slides/m05-a02.pdf, página 2, ID m05-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a02-b04. Sem trilha prevista. |

**Estado inicial:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/migracao-checklist.md, apoio/projeto-final.md, apoio/registro-testes.md

**Passos de captura:**
1. Copiar skill sem credenciais e revisar dependências.
2. Conferir caminho de descoberta e versão encontrada.
3. Autorizar Notion no Codex e ler página por ID.
4. Comparar conteúdo com a origem.

**Saída e conferência:** Skill e fonte corretas identificadas antes da execução combinada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a02-b04; SHA-256 1a16762031c999b498b465fdeea0d27b0fbbfd68e27ae5c0a10a85dc44dfcf1f.

**Função visual:** Instalar cópia da skill no projeto Codex e autorizar leitura da página Notion de exercício.


## m05-a02-b02 — Rodar e comparar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar resumo da página fictícia no Codex, salvar arquivo e repetir com entrada incompleta. | slides/m05-a02.pptx e slides/m05-a02.pdf, página 3, ID m05-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a02-b02. Sem trilha prevista. |

**Estado inicial:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/migracao-checklist.md, apoio/projeto-final.md, apoio/registro-testes.md

**Passos de captura:**
1. Executar resumo da página fictícia no Codex, salvar arquivo e repetir com entrada incompleta.
2. Abrir a referência citada e comparar com a entrada e o critério.

**Saída e conferência:** Arquivo real preserva decisões, responsáveis e ausências nos dois casos.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a02-b02; SHA-256 bb4d62db90a340e0905a96a02421398e0917c50c40365890d875d522cd1d7c29.

**Função visual:** Executar o caso no Codex após homologação dos acessos. Comparar conteúdo e destino; usar uma pasta de teste separada para evitar duplicatas.


## m05-a02-b05 — Executar, salvar e comparar os dois casos

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar resumo com Notion no Codex, salvar arquivo e repetir entrada incompleta. | slides/m05-a02.pptx e slides/m05-a02.pdf, página 4, ID m05-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a02-b05. Sem trilha prevista. |

**Estado inicial:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/migracao-checklist.md, apoio/projeto-final.md, apoio/registro-testes.md

**Passos de captura:**
1. Rodar pedido com página/skill/destino explícitos.
2. Abrir arquivo e comparar fatos com a origem.
3. Rodar entrada incompleta sem herdar dados.
4. Registrar diferença e repetir teste após correção.

**Saída e conferência:** Duas entregas reais conferidas e regra de ausência preservada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a02-b05; SHA-256 0a59090f0cb5cbb1f9c5728c431c80c7e2cd83647d813c5bae75d7fa4682de6a.

**Função visual:** Executar resumo com Notion no Codex, salvar arquivo e repetir entrada incompleta.


## m05-a02-b06 — Escolher ferramenta e concluir o projeto pessoal

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Comparar diferenças e aplicar rubrica do projeto pessoal; indicar time completo como opcional. | slides/m05-a02.pptx e slides/m05-a02.pdf, página 5, ID m05-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a02-b06. Sem trilha prevista. |

**Estado inicial:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/migracao-checklist.md, apoio/projeto-final.md, apoio/registro-testes.md

**Passos de captura:**
1. Preencher diferença encontrada e evidência de conferência.
2. Aplicar quatro níveis da rubrica ao projeto pessoal.
3. Listar pendências concretas e extensão opcional separadamente.

**Saída e conferência:** Migração do núcleo comprovada e projeto avaliado com evidência, sem impor o time completo.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a02-b06; SHA-256 d2adce5ea821978dbbde1a109269120f33a9a8aee17e03fdacd203cc03ca596e.

**Função visual:** Comparar diferenças e aplicar rubrica do projeto pessoal; indicar time completo como opcional.


## m05-a02-b03 — Escolher sem perder o processo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar registro da migração e rubrica do projeto pessoal. | slides/m05-a02.pptx e slides/m05-a02.pdf, página 6, ID m05-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m05-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m05-a02-b03. Sem trilha prevista. |

**Estado inicial:** Skill de resumo testada, página Notion fictícia e Codex atualizado com conexão autorizada. O caso inteiro de propostas é opcional.

**Entrada/material:** apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt, apoio/migracao-checklist.md, apoio/projeto-final.md, apoio/registro-testes.md

**Passos de captura:**
1. Apresentar registro da migração e rubrica do projeto pessoal.
2. Abrir a referência citada e comparar com a entrada e o critério.

**Saída e conferência:** Diferença concreta documentada e entrega conferida; nenhum escopo adicional obrigatório.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m05-a02-b03; SHA-256 da49721a1c63182ceb0c7cc4719913d5e00599e6ef06ce99d4a62ed6b72be96a.

**Função visual:** Registrar comparação e dependências do ambiente; não declarar paridade total entre plataformas.


## Atividade e solução

Rodar resumo + Notion no Codex com entrada normal e incompleta, salvar saídas e registrar uma diferença da migração.

Fontes e arquivos reais conferidos; decisões/responsáveis/ausências preservados; adaptação específica identificada.

## Materiais

- skill-resumo-exemplo.md
- conversa-demo.txt
- conversa-incompleta.txt
- migracao-checklist.md
- projeto-final.md
- registro-testes.md

# 6.1 — Quando adicionar o WhatsApp pode fazer sentido / m06-a01

**Objetivo:** Avaliar usos financeiros e de projetos no WhatsApp e escolher uma integração inicial pequena.

**Preparação:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Ensaio:** Cenários financeiro/projetos são exemplos de arquitetura de processo, não implementações entregues ou homologadas.

### m06-a01-b01 — O canal entra depois da necessidade

Slide m06-a01-s01

Até aqui, cada trabalho começou dentro de um ambiente de IA e terminou numa entrega para você conferir. Em alguns processos, porém, faz sentido receber um pedido ou mandar um aviso pelo WhatsApp. Esta aula ajuda a decidir quando isso vale a pena e como começar com um uso pequeno.

Primeiro, uma distinção. O WhatsApp é só o canal, ou seja, o caminho por onde a mensagem entra e sai. Quem define o que acontece quando uma mensagem chega é o processo: quem pode mandar, de onde vêm as informações para responder, o que fica registrado e quem confirma. Se essa regra ainda não existe, o canal só cria mais uma porta de entrada para organizar.

Por isso a ordem é esta: primeiro a necessidade, depois o canal. Diante de uma ideia de uso, pergunte qual etapa concreta ficaria melhor com uma mensagem. Se não houver uma etapa assim, ainda não é hora de conectar nada.

Vamos usar como base um exemplo pequeno: avisar que um documento foi preparado e está aguardando revisão. O documento fica no destino combinado, e a aprovação continua sendo uma decisão de uma pessoa. A mensagem apenas informa; ela não aprova e não envia nada a ninguém por conta própria.

Para enxergar o papel do canal em situações mais ricas, vamos olhar dois cenários maiores: um assistente financeiro e um apoio de projetos. Eles são possibilidades para desenhar o processo no papel. Não são sistemas prontos, nem algo que esteja instalado e funcionando para você. Em cada cenário, vamos procurar quatro coisas: de onde vem a informação, quem a recebe, quem autoriza e o que sai no final.

### m06-a01-b04 — O assistente financeiro pelo canal certo

Slide m06-a01-s04

Vamos começar pelo assistente financeiro de uma empresa. De manhã, ele lembra o dono das contas que vencem no dia e na semana. Recebe a foto de um comprovante, confere os dados e prepara o registro. No fim do dia, organiza um resumo de entradas e saídas. Esse é o cenário da ementa que vamos analisar.

O WhatsApp pode ser a interface dessas conversas, isto é, a parte que a pessoa vê e usa. Mas, por trás, precisamos de fontes, que são os lugares de onde a informação vem: uma agenda ou controle de contas, uma planilha ou sistema financeiro, e regras para interpretar documentos. O canal não sabe sozinho se uma conta foi paga nem se o valor reconhecido na imagem está correto.

Agora vamos desenhar o mapa, em três fluxos separados. Em cada um, anote o que entra, o que o processo faz e o que sai.

O primeiro é o lembrete. A entrada é o horário combinado. O processo consulta a agenda ou o controle de contas e a saída é uma mensagem informando os vencimentos do dia e da semana. Ele consulta e informa; ele não paga uma conta. Anote isso no mapa, porque é aqui que a linha entre lembrar e pagar fica visível.

O segundo é o comprovante. A entrada é a foto enviada. O processo lê a imagem e extrai valor, data e identificação. A saída não é um lançamento definitivo, e sim uma proposta de registro, com esses dados, para uma pessoa revisar. Marque aqui o ponto de validação: alguém confere o que foi reconhecido na imagem antes de o registro valer. Uma foto pode estar torta, cortada ou ter um número mal lido, e o processo precisa deixar espaço para essa conferência.

O terceiro é a consulta, como a pergunta “quanto faturei neste mês?”. A resposta só é confiável se disser qual fonte, qual período e qual critério estão sendo usados. Faturamento é o que foi vendido ou emitido no período; não é automaticamente o saldo em caixa, que é o dinheiro disponível. Se o critério não estiver escrito, duas respostas diferentes podem parecer certas. Marque no mapa o período e o critério.

Repare no que os três fluxos têm em comum: lembrar, registrar e consultar são ações diferentes de pagar. Cada uma tem a sua fonte e a sua decisão. Isso evita que uma mensagem seja tratada como autorização financeira ampla. Por isso, ao dar acesso a uma ferramenta, conceda só o necessário: ler uma agenda de vencimentos não exige poder para registrar, e registrar não exige poder para pagar. Mesmo a leitura pode envolver informação sensível, então o acesso também deve ser proporcional.

Falta uma pergunta prática: o que faz o lembrete da manhã sair no horário? Algo precisa estar em funcionamento àquela hora. Se a rotina roda no seu computador, ele precisa estar ligado e com o programa ativo. Se roda como uma rotina na nuvem, ou seja, nos servidores do fornecedor, ela não depende do seu computador, mas depende do contexto e das conexões que você configurou para ela. A disponibilidade de cada opção varia conforme o plano, a versão e a organização da sua conta, então confira na sua conta antes de prometer um horário a alguém.

Nesta formação, usamos o cenário para mapear o processo. Não estamos entregando um sistema contábil nem ativando pagamentos. A prática de conexão será menor, com uma atualização fictícia em conversa de teste.

### m06-a01-b02 — Dois usos que ajudam a enxergar o papel do canal

Slide m06-a01-s02

Juntando o cenário financeiro com o de projetos, que veremos logo em seguida, dá para ver o papel do canal. No primeiro, um assistente financeiro recebe um comprovante, extrai as informações e prepara um registro para conferência. No segundo, um apoio de projetos avisa sobre uma pendência e recebe uma atualização da equipe. Nos dois, o WhatsApp é a conversa. O procedimento é que define como interpretar, registrar e confirmar.

Casos assim podem pedir outras integrações, que são ligações entre o seu processo e outros serviços. Também podem pedir revisão humana e regras sobre os dados. Por isso, vamos apenas descrevê-los e mapeá-los. O nosso exercício será menor: uma mensagem de teste, com uma finalidade clara.

Antes de conectar qualquer canal, responda a três perguntas. A primeira: o que a pessoa precisa receber ou informar? A segunda: quem pode participar da conversa? A terceira: o que o processo faz se a mensagem não for entregue? Escreva as respostas, porque elas viram o centro do mapa que você vai preencher no fim da aula.

Se o canal não melhora uma etapa concreta, talvez ele ainda não precise entrar. Agora vamos ao cenário de projetos, para comparar.

### m06-a01-b05 — O gestor de projetos e o resumo do dia

Slide m06-a01-s05

Agora o segundo cenário: um apoio de projetos. Pela manhã, ele apresenta as tarefas de cada pessoa. Durante o dia, recebe atualizações. No fim, entrega ao responsável um resumo de pendências, vendas ou problemas, desde que esses dados existam nas fontes conectadas. Se o dado não está em nenhuma fonte, o resumo não pode inventá-lo.

Vamos mapear passo a passo.

No primeiro passo, ligamos as tarefas ao quadro. Se elas estão no Trello, que organiza o trabalho em cartões dentro de colunas, o processo precisa consultar o quadro certo e interpretar os estados combinados com a equipe, como “a fazer”, “em andamento” e “concluído”. No quadro do exercício, relacione cada tarefa ao identificador do cartão e ao seu estado. Assim, a conversa fala de uma tarefa específica, e não de uma descrição solta.

No segundo passo, separamos mensagem recebida de atualização autorizada. Uma mensagem “terminei” não deve encerrar qualquer cartão parecido. Antes de mudar algo no quadro, o processo precisa saber qual é a tarefa e se quem escreveu pode atualizar aquele recurso. Se a informação veio só por mensagem, registre a origem e o que ainda precisa de confirmação. Assim, a pessoa responsável sabe o que foi dito e o que ainda não foi verificado.

Um cuidado: o que o processo precisa saber não deve ficar apenas na conversa. Uma conversa não vira memória garantida, e o contexto de uma sessão tem limite. O que importa, como os estados do quadro e quem pode atualizar o quê, fica escrito em um arquivo ou no próprio quadro.

No terceiro passo, definimos destinatário e frequência. Em um grupo, as mensagens podem misturar participantes e assuntos, e fica difícil saber quem disse o quê e a quem a resposta se dirige. Por isso, o exercício inicial será individual. Para um uso em equipe, combine quem recebe quais informações e qual é a finalidade das notificações. Cobrar uma pendência a cada minuto não melhora o projeto; pode apenas criar ruído.

Para conferir o desenho, responda a quatro perguntas. Qual evento dispara o aviso? Qual fonte confirma a situação? Quem pode responder? E o que muda no sistema quando alguém responde? Se a última resposta for “nada muda sem aprovação”, o desenho está seguro para começar.

Você pode concluir que um resumo diário para o responsável já resolve a necessidade. Não é obrigatório transformar toda interação da equipe em uma automação.

### m06-a01-b06 — Escolher um primeiro uso pequeno

Slide m06-a01-s06

Compare os dois cenários com o processo de propostas deste curso. Em todos eles, uma informação chega, um procedimento usa ferramentas e uma saída precisa ser conferida. O WhatsApp acrescenta um canal de entrada ou aviso; não substitui o procedimento.

Agora vamos fazer a atividade. Vou mostrar o preenchimento do arquivo mapa-canal-whatsapp.md, e você faz o seu em paralelo.

Primeiro, escolha o caso: o cenário financeiro, o de projetos ou uma necessidade sua. Abra o arquivo e preencha cinco campos: entrada, fonte, destinatário, decisão e saída. Por exemplo, no cenário de projetos: a entrada é um cartão que ficou parado; a fonte é o quadro do exercício; o destinatário é o responsável; a decisão é quem acompanha o cartão; a saída é um aviso curto. Faça o mesmo com o seu caso, e use só dados fictícios.

Segundo, reduza a primeira conexão. Em vez de montar o cenário inteiro, escolha uma mensagem com finalidade simples: avisar que um documento fictício está aguardando revisão. Defina quem pode recebê-la e qual referência pode ser compartilhada, como o nome do arquivo de exercício. Escreva o texto de teste no arquivo mensagem-whatsapp.txt, curto e sem dados reais. Registre no mapa que essa mensagem não aprova o documento e não autoriza enviar a proposta ao cliente. Quem decide continua sendo uma pessoa.

Terceiro, decida o que acontece se o canal falhar. O documento continua no destino combinado? Há outro lugar para acompanhar a pendência? Quem confere a entrega? Anote no mapa o que registrar quando a entrega falhar. Um aviso não recebido não pode fazer o processo dizer que alguém foi informado.

Um detalhe sobre a ferramenta de IA: para preencher este mapa você não precisa do modelo mais forte. Comece pelo modelo padrão do seu plano. Os modelos da família Fable, por exemplo, dependem do produto e do plano: em alguns planos estão incluídos com um limite, e em outros exigem créditos, que cobram por uso. Veja o que a sua conta oferece em Settings > Usage antes de escolher. Aumente o nível de esforço apenas quando encontrar uma dificuldade concreta, como um mapa com muitas exceções.

Por fim, confira o resultado contra o critério da aula: o uso do canal está justificado por uma etapa concreta, e fonte, destinatário e conferência estão identificados? O cenário maior mostra possibilidades; o teste pequeno permite observar a conexão sem depender de um número importante para o negócio.

### m06-a01-b03 — Um recorte para começar

Slide m06-a01-s03

Para executar a prática do bônus, a de conexão, será necessário preparar uma instância, que é a conexão de WhatsApp mantida pelo serviço, e um destino de teste, que deve ser um número que não seja o comercial do negócio. Se você ainda não tem esse ambiente, faça o mapa desta aula e deixe a conexão para depois de escolhermos o caminho na próxima aula. A mensagem será a atualização de um exercício fictício, e nada será enviado a um cliente real.

O critério de conferência é separar três situações: o que foi preparado, o que foi enviado ao serviço e o que chegou ao destino. Essa separação importa porque clicar em enviar não prova que a comunicação aconteceu. O serviço pode aceitar o pedido de envio e, ainda assim, a mensagem não chegar. Por isso, a resposta do serviço comprova que ele recebeu o pedido, e só a conferência no destino comprova a chegada. Antes do envio, o conteúdo e o destinatário passam pela sua aprovação.

Uma observação sobre custo e regras. No WhatsApp oficial, a cobrança depende da mensagem entregue, da categoria e do mercado, com algumas isenções. Mensagens de atendimento dentro da janela de 24 horas após a mensagem do cliente, por exemplo, não são cobradas. Por isso, não presuma que toda mensagem recebida gera cobrança. Um provedor intermediário pode cobrar por serviços adicionais, então confira a página oficial de preços do WhatsApp Business e as condições do seu provedor. E um volume baixo não torna aprovado um caminho não oficial, nem garante que não haverá bloqueio.

Na próxima aula, vamos escolher o caminho de integração e entender seus limites antes de conectar.

# 6.1 — Quando adicionar o WhatsApp pode fazer sentido

ID m06-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Dependências e ensaio:** Cenários financeiro/projetos são exemplos de arquitetura de processo, não implementações entregues ou homologadas.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m06-a01-b01 | m06-a01-s01 / p. 1 | Apresentar o cenário de notificação de andamento e os exemplos financeiros/de projetos como possibilidades, não produtos já construídos. | Canal é escolhido pela necessidade, não pelo desejo de automatizar tudo. |
| m06-a01-b04 | m06-a01-s04 / p. 2 | Mapear lembrete, comprovante e consulta financeira, com fontes e decisões distintas. | Aluno reconhece dependências e aprovação; nenhuma ação financeira real é ativada. |
| m06-a01-b02 | m06-a01-s02 / p. 3 | Descrever de forma breve os cenários do assistente financeiro e do gestor de projetos, sem construir os dois. | Exemplos financeiro e de projetos são apresentados como possibilidades. |
| m06-a01-b05 | m06-a01-s05 / p. 4 | Mapear tarefa em quadro, atualização e resumo, identificando pessoa e recurso. | Canal, fonte de tarefa e autorização separados; grupo não tratado como conversa individual. |
| m06-a01-b06 | m06-a01-s06 / p. 5 | Escolher caso e reduzir a primeira integração a um aviso fictício individual. | Uso do canal justificado por etapa concreta, com fonte, destinatário e conferência. |
| m06-a01-b03 | m06-a01-s03 / p. 6 | Definir o exemplo mínimo e separar sua execução de uma operação real de atendimento. | Fonte, destinatário, autorização e saída identificados; cenários exemplificativos não apresentados como sistemas prontos. |

## m06-a01-b01 — O canal entra depois da necessidade

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Apresentar o cenário de notificação de andamento e os exemplos financeiros/de projetos como possibilidades, não produtos já construídos. | slides/m06-a01.pptx e slides/m06-a01.pdf, página 1, ID m06-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a01-b01. Sem trilha prevista. |

**Estado inicial:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Entrada/material:** apoio/mapa-canal-whatsapp.md, apoio/mensagem-whatsapp.txt, apoio/projeto-final.md

**Passos de captura:**
1. Apresentar o cenário de notificação de andamento e os exemplos financeiros/de projetos como possibilidades, não produtos já construídos.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Canal é escolhido pela necessidade, não pelo desejo de automatizar tudo.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a01-b01; SHA-256 5ec76d2c5e49a837122bf7b5e1d5f8b8ea0a1d8acb226def7475a0c31a0d256e.

**Função visual:** Apresentar o cenário de notificação de andamento e os exemplos financeiros/de projetos como possibilidades, não produtos já construídos.


## m06-a01-b04 — O assistente financeiro pelo canal certo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Mapear lembrete, comprovante e consulta financeira, com fontes e decisões distintas. | slides/m06-a01.pptx e slides/m06-a01.pdf, página 2, ID m06-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a01-b04. Sem trilha prevista. |

**Estado inicial:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Entrada/material:** apoio/mapa-canal-whatsapp.md, apoio/mensagem-whatsapp.txt, apoio/projeto-final.md

**Passos de captura:**
1. Desenhar três entradas e saídas.
2. Separar lembrar/registrar/consultar de pagar.
3. Marcar validação do comprovante e critério de período.

**Saída e conferência:** Aluno reconhece dependências e aprovação; nenhuma ação financeira real é ativada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a01-b04; SHA-256 720bfbd67213ab31b3ad0940c46f8b5eed92f5fb6246a99c5bb05ba68098cda2.

**Função visual:** Mapear lembrete, comprovante e consulta financeira, com fontes e decisões distintas.


## m06-a01-b02 — Dois usos que ajudam a enxergar o papel do canal

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Descrever de forma breve os cenários do assistente financeiro e do gestor de projetos, sem construir os dois. | slides/m06-a01.pptx e slides/m06-a01.pdf, página 3, ID m06-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a01-b02. Sem trilha prevista. |

**Estado inicial:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Entrada/material:** apoio/mapa-canal-whatsapp.md, apoio/mensagem-whatsapp.txt, apoio/projeto-final.md

**Passos de captura:**
1. Descrever de forma breve os cenários do assistente financeiro e do gestor de projetos, sem construir os dois.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Exemplos financeiro e de projetos são apresentados como possibilidades.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a01-b02; SHA-256 d46d44391416bbf76207a9281ecf34729b8966397321d56acca7686037b8fa6a.

**Função visual:** Descrever de forma breve os cenários do assistente financeiro e do gestor de projetos, sem construir os dois.


## m06-a01-b05 — O gestor de projetos e o resumo do dia

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Mapear tarefa em quadro, atualização e resumo, identificando pessoa e recurso. | slides/m06-a01.pptx e slides/m06-a01.pdf, página 4, ID m06-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a01-b05. Sem trilha prevista. |

**Estado inicial:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Entrada/material:** apoio/mapa-canal-whatsapp.md, apoio/mensagem-whatsapp.txt, apoio/projeto-final.md

**Passos de captura:**
1. Relacionar tarefas a IDs/estados do quadro de exercício.
2. Distinguir mensagem recebida de atualização autorizada.
3. Definir destinatário e frequência útil.

**Saída e conferência:** Canal, fonte de tarefa e autorização separados; grupo não tratado como conversa individual.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a01-b05; SHA-256 67ec0582c1f0ee0efe3983faff2ca6e6661c9ebb71f2734f5724d8ed52708f19.

**Função visual:** Mapear tarefa em quadro, atualização e resumo, identificando pessoa e recurso.


## m06-a01-b06 — Escolher um primeiro uso pequeno

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Escolher caso e reduzir a primeira integração a um aviso fictício individual. | slides/m06-a01.pptx e slides/m06-a01.pdf, página 5, ID m06-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a01-b06. Sem trilha prevista. |

**Estado inicial:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Entrada/material:** apoio/mapa-canal-whatsapp.md, apoio/mensagem-whatsapp.txt, apoio/projeto-final.md

**Passos de captura:**
1. Preencher mapa-canal-whatsapp.md.
2. Definir destinatário permitido e conteúdo de teste.
3. Definir o que registrar em falha de entrega.

**Saída e conferência:** Uso do canal justificado por etapa concreta, com fonte, destinatário e conferência.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a01-b06; SHA-256 20b35d85e3dca061c89b753b90b0fccb1c1d0826c06beb5589228da17775ba43.

**Função visual:** Escolher caso e reduzir a primeira integração a um aviso fictício individual.


## m06-a01-b03 — Um recorte para começar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Definir o exemplo mínimo e separar sua execução de uma operação real de atendimento. | slides/m06-a01.pptx e slides/m06-a01.pdf, página 6, ID m06-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a01-b03. Sem trilha prevista. |

**Estado inicial:** Preparar diagramas dos dois cenários e mensagem fictícia; não usar número ou documentos reais.

**Entrada/material:** apoio/mapa-canal-whatsapp.md, apoio/mensagem-whatsapp.txt, apoio/projeto-final.md

**Passos de captura:**
1. Definir o exemplo mínimo e separar sua execução de uma operação real de atendimento.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Fonte, destinatário, autorização e saída identificados; cenários exemplificativos não apresentados como sistemas prontos.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a01-b03; SHA-256 9ab195b64667521a85abcb4552f37a57962b9d0caa02f41f0949f873cd2335b2.

**Função visual:** Definir o exemplo mínimo e separar sua execução de uma operação real de atendimento.


## Atividade e solução

Mapear um dos cenários completos e desenhar um aviso individual fictício como primeiro teste.

Fonte, destinatário, autorização e saída identificados; cenários exemplificativos não apresentados como sistemas prontos.

## Materiais

- mapa-canal-whatsapp.md
- mensagem-whatsapp.txt
- projeto-final.md

# 6.2 — Como adicionar o WhatsApp às suas soluções com segurança / m06-a02

**Objetivo:** Distinguir integração oficial/não oficial, entender cobrança atual e definir segurança e conferência do canal.

**Preparação:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Ensaio:** Políticas/preços exigem reconferência na gravação; instância UazAPI de teste não existe nesta produção.

### m06-a02-b01 — Escolher a integração conhecendo o limite

Slide m06-a02-s01

Nesta aula você vai decidir como o WhatsApp entra nas suas soluções, sabendo o que está conectando e o que precisa conferir antes de confiar no resultado. A ordem é esta: primeiro, os dois caminhos possíveis e o limite de cada um; depois, como a cobrança funciona; por fim, quem pode receber mensagens, onde ficam as credenciais e como conferir cada etapa de um envio.

Para trabalhar com WhatsApp, existem dois tipos de caminho. O oficial é o que a própria plataforma oferece para empresas. Os não oficiais são integrações de terceiros, que ligam um número de WhatsApp a um programa por uma API. API é a porta pela qual um programa pede ações a outro serviço, como enviar uma mensagem.

Nesta formação, o exercício prático usa a UazAPI, que é a opção escolhida para o curso. Ela é uma integração não oficial, e é justamente por isso que vale entender o limite antes de usar.

Esse limite é o seguinte: escolher a UazAPI não elimina o risco de bloqueio, de desconexão ou de falha na entrega. E usar pouco volume também não garante que uma integração não oficial funcione sem problemas.

Pense num número que a sua loja usa todos os dias para receber pedidos e tirar dúvidas de clientes. Se esse número for desconectado no meio de um teste, o atendimento fica sem canal. Por isso, o exemplo começa em um ambiente de teste, com um número reservado, sem depender de nenhum número importante para o seu negócio.

O que você precisa levar desta aula é saber o que está conectando e o que precisa conferir. A conveniência do caminho não é garantia de funcionamento. Vamos começar pela diferença entre o caminho oficial e o não oficial.

### m06-a02-b04 — Caminho oficial e integração não oficial

Slide m06-a02-s04

A Meta oferece a plataforma oficial do WhatsApp Business para integrações empresariais. Esse caminho tem regras de conta, regras de uso, modelos de mensagem e cobrança. Modelo de mensagem é um texto padrão, cadastrado antes, que a empresa usa quando é ela quem começa a conversa. O fato de existir automação autorizada não significa que qualquer conexão de WhatsApp foi aprovada pela plataforma.

A UazAPI, escolhida para este bônus, é uma integração não oficial. Ela pode ser conveniente para um experimento, mas isso não elimina o risco de bloqueio, de desconexão, de mudança no funcionamento ou de perda de acesso. Usar poucas mensagens não torna a integração oficial e não garante estabilidade.

Por isso, não vamos ensinar uma forma de disfarçar automação nem prometer um volume que evite bloqueio. O que vamos fazer é aprender a reconhecer o tipo de acesso que você está usando e a conferir uma operação em um ambiente separado. Se o processo for importante para o negócio, avalie o caminho oficial, as políticas atuais e o suporte de que você precisa.

Vamos fazer essa comparação com as fontes na tela. Primeiro, vou abrir a página oficial de políticas e de preços da plataforma e, ao lado dela, a documentação da UazAPI. Em cada uma, a pergunta é a mesma: quem oferece este acesso e quem responde por ele? Na plataforma oficial, a resposta é a Meta, com regras publicadas. Na UazAPI, é um provedor independente, sem a aprovação da plataforma para esse tipo de conexão.

Anote o resultado dessa leitura, uma linha para cada caminho: a natureza do acesso e o principal risco. É esse registro que você vai consultar quando precisar justificar a escolha.

Depois, definimos a decisão prática desta formação. O ensaio fica limitado a um número reservado, um destinatário combinado e uma mensagem fictícia. Número reservado é um número que você não usa para atender clientes. Destinatário combinado é uma pessoa que sabe que vai receber a mensagem de teste.

Um número que sustenta atendimento, vendas ou recuperação de contas não é o lugar para aprender uma conexão que ainda não foi validada. Nesta etapa, você só define esse número e esse destinatário como pré-requisitos do exercício. A conexão em si fica para a próxima aula.

O exercício serve para entender o percurso técnico e seus limites. Ele não transforma conveniência em garantia.

### m06-a02-b02 — A conta e os estados são coisas diferentes

Slide m06-a02-s02

Agora vamos separar duas coisas que costumam ser confundidas: o que você paga e em que estado uma mensagem está. A primeira é assunto de preço. A segunda é assunto técnico.

Primeiro, a cobrança. As regras da plataforma oficial e o preço cobrado por um provedor são referências diferentes. A categoria da mensagem, o mercado e as condições de gratuidade podem mudar a conta. Por isso, não vamos usar uma tarifa única por mensagem enviada ou recebida. Vou abrir a documentação atual de preços da plataforma e a do provedor, uma ao lado da outra, sem copiar valores para esta aula. Antes de usar em produção, consulte as duas. O próximo bloco detalha como ler essa cobrança.

Agora, a parte técnica. Aqui a separação é entre quatro situações: conexão, envio, entrega e leitura.

Comece pela conexão. Na UazAPI, uma instância é a conexão do seu número com o serviço. Criar a instância não basta: ela ainda precisa ser pareada com o número, como acontece quando você conecta o WhatsApp em outro aparelho. Uma instância conectada está autenticada para operar. Isso não quer dizer que uma mensagem específica já foi aceita, entregue ou lida.

Quando você pede um envio, o serviço pode devolver uma identificação da mensagem. Use essa referência para acompanhar o estado dela. Se o pedido terminar por tempo esgotado, ou seja, sem resposta, não repita o envio às cegas. A primeira tentativa pode ter sido processada, e o seu contato receberia a mensagem duas vezes. Antes de reenviar, confira o que aconteceu com ela.

No exercício, vamos tratar uma falha como informação para o processo. Se a entrega depende de uma comunicação, o processo precisa saber o que fazer quando o canal não está disponível. O que não pode acontecer é ele continuar dizendo que deu tudo certo.

Vou mostrar esses quatro estados na tela, um de cada vez, e depois comparo com o critério da aula: custo tratado por condição, baixo volume sem promessa de proteção, e o estado de cada mensagem conferido separadamente.

### m06-a02-b05 — Cobrança atual: categoria, mercado e entrega

Slide m06-a02-s05

Vamos olhar a cobrança com mais calma, porque é aqui que mais se erra por suposição. A cobrança da plataforma oficial precisa ser lida no modelo atual. Na verificação feita para esta aula, em novembro de 2026, a Meta cobra conforme as mensagens entregues, a categoria e o mercado, com condições de gratuidade. Não existe uma tarifa única que descreva toda mensagem enviada ou recebida.

Vou abrir a página oficial de preços e procurar três informações: a categoria da mensagem, o mercado, que aqui é o país do destinatário, e a janela de vinte e quatro horas.

Essa janela funciona assim. Quando uma pessoa inicia a conversa, abre-se uma janela de atendimento de vinte e quatro horas. As respostas de serviço dentro dessa janela são gratuitas na cobrança da plataforma. Há também condições de gratuidade para mensagens de utilidade enviadas em resposta ao usuário. Fora dessas condições, os modelos de mensagem e as categorias têm regras próprias. Consulte a tabela vigente para o país e a operação que você pretende usar.

Há uma segunda conta. O preço do provedor pode incluir outros serviços, mesmo quando uma mensagem não gera tarifa da Meta. Separe as duas contas no planejamento: uma é a da plataforma, outra é a do provedor. E não copie uma tarifa de uma aula antiga para calcular o custo do seu projeto. Registre sempre a referência consultada e a data, sem fixar um preço universal.

Agora, a atividade. Descreva dois casos.

O primeiro é uma resposta a uma solicitação recebida. Um cliente escreve às catorze horas perguntando pelo andamento de um pedido, e você responde vinte minutos depois. A pergunta que você verifica é se a resposta está dentro da janela de vinte e quatro horas e se é uma resposta de serviço.

O segundo é um lembrete iniciado pela empresa. No dia seguinte, depois de passada essa janela, a empresa quer avisar sobre um pagamento pendente. Aqui, a empresa é quem começa a conversa. Você verifica a categoria da mensagem, o modelo de mensagem usado e o mercado do destinatário na tabela vigente.

Em cada caso, anote qual condição precisa ser verificada, sem supor que toda automação paga igual. Use a matriz de contas e custos para registrar isso. Essa leitura ajuda a escolher a solução com informação suficiente e mantém o roteiro atualizado quando os valores mudarem.

### m06-a02-b06 — Segredos, destinatários e estados da mensagem

Slide m06-a02-s06

Agora, a segurança da conexão. Uma conexão precisa proteger o acesso e limitar o efeito do que pode acontecer. Vamos tratar três pontos: segredos, destinatários e estados da mensagem.

Segredos. O token da instância é a credencial que autoriza operações daquela sessão. O token administrativo tem alcance maior e não deve ser usado como atalho no procedimento diário. Nenhum dos dois vai para a fala, para o slide ou para o material distribuído. Vou ler com você um checklist curto: onde o token fica guardado, quem tem acesso a ele e o que acontece se ele aparecer num registro.

Destinatários. Defina quem pode receber mensagens e quem pode pedir uma ação. Pense numa mensagem que chega dizendo: "me mande os documentos do cliente" ou "mude o valor do plano". Uma mensagem recebida é conteúdo para interpretar, não é autorização para revelar documentos, enviar algo para outro contato ou alterar uma regra do sistema. A validação do destinatário e do acesso precisa existir na própria integração, além da instrução escrita para o modelo de IA. A instrução pode ser ignorada ou contornada, e a validação feita pelo sistema não.

Estados. Na conferência, separe conectado, operação aceita, entregue e lido. Cada estado responde a uma pergunta diferente. Estar conectado não prova que houve envio. O aceite do serviço não prova entrega. E entrega não prova leitura. Se uma chamada ficar sem resposta, consulte a referência e o estado antes de tentar outra vez. Na UazAPI, existe uma consulta de status da instância, que mostra se a conexão está ativa, e a resposta de cada operação. O envio de um texto leva dois dados: o número de destino e o texto. Como o nome exato dos campos e dos endereços pode variar com a versão do servidor, confirme na documentação antes do ensaio.

Por fim, os eventos. Evento é um aviso que o serviço manda ao seu processo quando algo muda, por exemplo, que uma mensagem foi entregue. Trate esses avisos como atualizações da mensagem, e não como mensagens novas do usuário. Se o processo responder a cada atualização como se fosse uma pergunta nova, ele cria respostas em cadeia. Guarde os identificadores necessários para relacionar o retorno à operação certa, em registros que não exponham credenciais.

Para praticar, preencha o contrato do ensaio: o acesso, o destinatário permitido e os quatro estados, e use o registro de testes para anotar cada conferência. O efeito deve ficar limitado à conversa de teste, e nenhum estado pode ser dado como certo sem conferir. Na próxima aula, veremos esse caminho numa conexão pequena, se você tiver um ambiente de teste disponível.

### m06-a02-b03 — Credenciais fora da demonstração

Slide m06-a02-s03

Para fechar, vamos tratar do cuidado com o token. O token é uma credencial de acesso. Ele não aparece na fala, em um print, no arquivo de exemplo nem em uma instrução que será distribuída. Configure o acesso pelo caminho apropriado do seu ambiente, como um local protegido do seu computador, e, antes de compartilhar qualquer coisa, confira o que entra nos arquivos e nos registros.

Na UazAPI, vamos usar duas informações da sua conta: o endereço do servidor e o token da instância necessária ao exercício. A credencial administrativa tem outro alcance e não é a chave do dia a dia. Em nenhum momento esta formação pede que você envie senha ou token no chat.

Resumindo o que definimos: o canal escolhido é a UazAPI, em um ambiente de teste. O escopo é um número reservado, um destinatário combinado e uma mensagem fictícia. E os critérios de conferência são os quatro estados: conexão, envio, entrega e leitura, cada um conferido separadamente.

Para saber se você aplicou bem esta aula, use este critério. Os custos e as gratuidades foram tratados por condição, e não por tarifa única. O baixo volume não foi tratado como proteção. E o token e o destinatário têm escopo definido.

Com isso, podemos preparar a conexão. Na próxima aula, seguimos esse caminho com um exemplo pequeno, de ponta a ponta.

# 6.2 — Como adicionar o WhatsApp às suas soluções com segurança

ID m06-a02. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Dependências e ensaio:** Políticas/preços exigem reconferência na gravação; instância UazAPI de teste não existe nesta produção.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m06-a02-b01 | m06-a02-s01 / p. 1 | Comparar conceitualmente plataforma oficial e integração não oficial; não sugerir ausência de risco por volume pequeno. | Plataforma oficial e integração não oficial são diferenciadas com dependências e riscos. |
| m06-a02-b04 | m06-a02-s04 / p. 2 | Comparar integração oficial e UazAPI sem prometer ausência de bloqueio por volume. | Oficialidade, risco e finalidade de teste distinguidos. |
| m06-a02-b02 | m06-a02-s02 / p. 3 | Mostrar documentação atual de preços da plataforma e do provedor, sem fixar tarifas; apresentar conexão, envio, entrega e leitura. | Conexão, fila, envio, entrega e leitura são estados separados. |
| m06-a02-b05 | m06-a02-s05 / p. 4 | Consultar pricing oficial e comparar resposta de serviço com lembrete iniciado pela empresa. | Aluno não presume cobrança genérica por mensagem recebida e consulta condição aplicável. |
| m06-a02-b06 | m06-a02-s06 / p. 5 | Apresentar contrato de operação com destinatário permitido e quatro estados distintos. | Efeito limitado à conversa de teste e estados conferidos sem reenviar às cegas. |
| m06-a02-b03 | m06-a02-s03 / p. 6 | Explicar uso do token de instância, armazenamento local protegido e ocultação de segredos. Não pedir senha/token ao aluno no chat. | Custos e gratuidades tratados por condição; baixo volume não promete proteção; token e destinatário têm escopo definido. |

## m06-a02-b01 — Escolher a integração conhecendo o limite

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Comparar conceitualmente plataforma oficial e integração não oficial; não sugerir ausência de risco por volume pequeno. | slides/m06-a02.pptx e slides/m06-a02.pdf, página 1, ID m06-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a02-b01. Sem trilha prevista. |

**Estado inicial:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/mapa-canal-whatsapp.md, apoio/matriz-contas-custos.md, apoio/registro-testes.md

**Passos de captura:**
1. Comparar conceitualmente plataforma oficial e integração não oficial; não sugerir ausência de risco por volume pequeno.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Plataforma oficial e integração não oficial são diferenciadas com dependências e riscos.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a02-b01; SHA-256 1f7b70faea4bb4fe412e0bc4ae7bc9b4a5d8ee7d201579b7a65f03609d265e25.

**Função visual:** Comparar conceitualmente plataforma oficial e integração não oficial; não sugerir ausência de risco por volume pequeno.


## m06-a02-b04 — Caminho oficial e integração não oficial

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Comparar integração oficial e UazAPI sem prometer ausência de bloqueio por volume. | slides/m06-a02.pptx e slides/m06-a02.pdf, página 2, ID m06-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a02-b04. Sem trilha prevista. |

**Estado inicial:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/mapa-canal-whatsapp.md, apoio/matriz-contas-custos.md, apoio/registro-testes.md

**Passos de captura:**
1. Abrir fontes oficiais de política/preço e documentação UazAPI.
2. Identificar natureza de cada caminho.
3. Definir número e destinatário de teste como pré-requisitos, sem conectá-los nesta revisão.

**Saída e conferência:** Oficialidade, risco e finalidade de teste distinguidos.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a02-b04; SHA-256 f97d6514a5830aaf0e543bf742b2421918a9cd679f5a99a5ba08523a653160c1.

**Função visual:** Comparar integração oficial e UazAPI sem prometer ausência de bloqueio por volume.


## m06-a02-b02 — A conta e os estados são coisas diferentes

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar documentação atual de preços da plataforma e do provedor, sem fixar tarifas; apresentar conexão, envio, entrega e leitura. | slides/m06-a02.pptx e slides/m06-a02.pdf, página 3, ID m06-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a02-b02. Sem trilha prevista. |

**Estado inicial:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/mapa-canal-whatsapp.md, apoio/matriz-contas-custos.md, apoio/registro-testes.md

**Passos de captura:**
1. Mostrar documentação atual de preços da plataforma e do provedor, sem fixar tarifas; apresentar conexão, envio, entrega e leitura.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Conexão, fila, envio, entrega e leitura são estados separados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a02-b02; SHA-256 49690019c6232cb65eab9d1e368f761913c90f5af57e376fe4fe4d4fbb28bd32.

**Função visual:** Mostrar documentação atual de preços da plataforma e do provedor, sem fixar tarifas; apresentar conexão, envio, entrega e leitura.


## m06-a02-b05 — Cobrança atual: categoria, mercado e entrega

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Slides. Consultar pricing oficial e comparar resposta de serviço com lembrete iniciado pela empresa. | slides/m06-a02.pptx e slides/m06-a02.pdf, página 4, ID m06-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a02-b05. Sem trilha prevista. |

**Estado inicial:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/mapa-canal-whatsapp.md, apoio/matriz-contas-custos.md, apoio/registro-testes.md

**Passos de captura:**
1. Identificar categoria, mercado e janela de 24h.
2. Separar cobrança Meta de tarifa do provedor.
3. Registrar referência/data, sem fixar preço universal.

**Saída e conferência:** Aluno não presume cobrança genérica por mensagem recebida e consulta condição aplicável.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a02-b05; SHA-256 7329b4643b653e2c6c3d1e150dc95f1a34ff5ad1456714acf8f00893429832d6.

**Função visual:** Consultar pricing oficial e comparar resposta de serviço com lembrete iniciado pela empresa.


## m06-a02-b06 — Segredos, destinatários e estados da mensagem

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Apresentar contrato de operação com destinatário permitido e quatro estados distintos. | slides/m06-a02.pptx e slides/m06-a02.pdf, página 5, ID m06-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a02-b06. Sem trilha prevista. |

**Estado inicial:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/mapa-canal-whatsapp.md, apoio/matriz-contas-custos.md, apoio/registro-testes.md

**Passos de captura:**
1. Ler checklist de segredo/destinatário.
2. Relacionar identificador da operação a seus eventos.
3. Explicar falha de resposta e consulta antes de repetir.

**Saída e conferência:** Efeito limitado à conversa de teste e estados conferidos sem reenviar às cegas.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a02-b06; SHA-256 52a014252ae725288bf73942afd6929d9d84e031af8f21d138f3787a9d2049d0.

**Função visual:** Apresentar contrato de operação com destinatário permitido e quatro estados distintos.


## m06-a02-b03 — Credenciais fora da demonstração

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Explicar uso do token de instância, armazenamento local protegido e ocultação de segredos. Não pedir senha/token ao aluno no chat. | slides/m06-a02.pptx e slides/m06-a02.pdf, página 6, ID m06-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a02-b03. Sem trilha prevista. |

**Estado inicial:** Consultar fontes oficiais na data da gravação; preparar contrato sem credenciais e sem número comercial.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/mapa-canal-whatsapp.md, apoio/matriz-contas-custos.md, apoio/registro-testes.md

**Passos de captura:**
1. Explicar uso do token de instância, armazenamento local protegido e ocultação de segredos. Não pedir senha/token ao aluno no chat.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Custos e gratuidades tratados por condição; baixo volume não promete proteção; token e destinatário têm escopo definido.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a02-b03; SHA-256 19c92b63bacdc3933aaf4ab168b058810c576ca72b617d63f1ad675d09c8972d.

**Função visual:** Explicar uso do token de instância, armazenamento local protegido e ocultação de segredos. Não pedir senha/token ao aluno no chat.


## Atividade e solução

Comparar dois cenários de cobrança e preencher contrato de acesso, destinatário e estados para o ensaio.

Custos e gratuidades tratados por condição; baixo volume não promete proteção; token e destinatário têm escopo definido.

## Materiais

- guia-whatsapp.md
- mapa-canal-whatsapp.md
- matriz-contas-custos.md
- registro-testes.md

# 6.2 — Conectando no WhatsApp com api não oficial / m06-a03

**Objetivo:** Preparar UazAPI e executar conexão/mensagem de teste com ferramenta real e conferência no destino.

**Preparação:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Ensaio:** BLOCKED_FOR_LIVE_DEMO: usuário já confirmou ausência de instância UazAPI. Não houve pareamento, envio, recebimento ou prova de entrega.

### m06-a03-b01 — Preparar a instância de teste

Slide m06-a03-s01

Nesta aula, vamos conectar um exemplo ao WhatsApp usando a UazAPI. Uma API é um jeito de um programa pedir algo a outro, por um endereço combinado. Aqui, o pedido será enviar uma mensagem de texto. A UazAPI é uma API não oficial, ou seja, não é a API do próprio WhatsApp. Isso explica por que esta aula tem tanto cuidado com o número e com a conferência de cada etapa.

Vale entender a diferença de custo e de risco. Na API oficial, a cobrança depende da mensagem entregue, da categoria dela e do mercado, e há isenções. Por exemplo, uma resposta de atendimento dentro da janela de 24 horas, contada a partir do contato do cliente, é gratuita. Não existe uma cobrança genérica por mensagem recebida. Num provedor não oficial, o provedor pode cobrar serviços adicionais. E um volume baixo de mensagens não torna a integração aprovada pelo WhatsApp, nem garante que a conta não será bloqueada. Por isso, o exercício usa um número reservado, e nunca a conta de atendimento da sua empresa.

Para o exercício, você precisa de três coisas: uma instância de teste, o endereço do servidor dessa instância e esse número reservado. Instância é a sessão de WhatsApp que o serviço mantém para você. Na próxima parte, vamos separar cada um desses nomes com calma.

Um ponto pede atenção. O site da documentação não é o endereço do seu servidor. O que vale é a Server URL, que é a base de todas as chamadas da sua instância. O token é a credencial, uma espécie de senha da instância: é ele que autoriza essas chamadas, e só vale no servidor a que pertence. Uma credencial de outro servidor não comprova acesso nesse endereço.

Agora, duas conferências antes de avançar. A primeira é onde o procedimento vai rodar. Se for no seu computador, ele precisa estar ligado e com o aplicativo aberto enquanto o trabalho acontece. Se for uma rotina na nuvem, o computador pode ficar desligado, mas o trabalho depende do que foi enviado para lá e das conexões configuradas lá; o que está no seu computador não vai junto automaticamente. Uma conta mais antiga pode mostrar um fluxo diferente do que descrevemos. Neste exercício, use o seu computador, com você acompanhando cada passo.

A segunda conferência é como o procedimento recebe a configuração sem expor o token. Os dados de acesso ficam fora da skill, que é o arquivo com o procedimento, e fora de qualquer material que você vá compartilhar. Também não cole o token numa conversa com o Claude: o que entra na conversa passa a fazer parte do contexto, que é o conjunto de informações que o Claude tem à vista naquela sessão.

Uma última nota, sobre o lado do Claude. Para esta tarefa pequena, comece no modelo e no esforço padrão da sua conta; só aumente se aparecer uma dificuldade que você consiga apontar. Os modelos da família Fable dependem do seu plano: em alguns planos vêm incluídos, com um limite menor; em outros exigem créditos, que têm cobrança por uso. Confira em Settings, na área Usage, ou com o comando /usage no Claude Code, antes de escolher.

### m06-a03-b04 — Servidor, instância, número e conexão

Slide m06-a03-s04

Vamos preparar a conexão em quatro partes, e cada uma tem um nome que não pode ser misturado com os outros. Server URL é o endereço do servidor da conta. Instância é a sessão administrada nesse servidor. Número é a conta de WhatsApp que será pareada, isto é, ligada a essa sessão. Token é a credencial da instância. O site da documentação explica as chamadas, mas não substitui a Server URL.

Comece conferindo o que você tem. Primeiro, confirme que existem uma instância e um número reservados para teste. Se ainda não há instância, a criação é uma operação administrativa, que precisa acontecer no ambiente apropriado do serviço. Depois de criada, o uso comum segue com o token da instância. E atenção: criar a instância não faz o pareamento do WhatsApp. São duas etapas separadas.

Segundo, abra a documentação atual e confira a versão, os endereços de cada chamada e o cabeçalho do token. Cabeçalho é o campo da chamada, separado do texto da mensagem, onde a credencial viaja. O nome do cabeçalho e os endereços administrativos podem variar conforme a versão do servidor, então confirme na sua antes de testar.

Terceiro, inicie a conexão. Na versão documentada para o exercício, ela começa por uma chamada a /instance/connect. Sem número de pareamento, o fluxo pode devolver um QR Code, que é uma imagem que você lê com o aplicativo do número reservado. Com a opção correspondente, pode usar um código de pareamento, que você digita. Siga o que a versão do seu servidor oferece. E faça essa parte fora da captura compartilhada, porque o QR Code e o código dão acesso à sessão.

Quarto, consulte /instance/status. Espere um estado que confirme a conexão antes de pedir qualquer mensagem. Os nomes exatos dos estados dependem da versão; o que importa é distinguir conectado de desconectado, conectando ou pausado. Se a sessão está em qualquer um destes últimos, o diagnóstico começa ali, e não no envio. Registre o estado observado, sem copiar nenhum segredo.

Repare que a consulta de status não envia nada ao destinatário. Esse primeiro teste separa a preparação da sessão da operação de comunicação: se algo falhar daqui em diante, você já sabe que a sessão estava de pé.

### m06-a03-b02 — Conectar, enviar e acompanhar

Slide m06-a03-s02

Agora vamos ver o caminho inteiro na ordem em que ele acontece, para você saber em que ponto está a cada passo.

Primeiro, consultamos o estado da instância. Se ela ainda não estiver conectada, iniciamos a conexão e concluímos o pareamento conforme o serviço indicar, fora da gravação, como vimos. Depois, consultamos o estado de novo. Aqui, o que queremos confirmar é a conexão, e só isso.

Segundo, damos ao agente uma ferramenta com duas operações apenas: consultar o estado e enviar texto ao destino de teste. Na próxima parte, vamos montar essa ferramenta.

Terceiro, pedimos o envio de uma atualização fictícia ao destino de teste que você definiu. Depois da chamada, guarde a identificação da mensagem, que é o número que o serviço devolve para ela, e consulte o estado dessa mensagem.

Cada passo gera uma evidência diferente, e elas não se substituem. Uma mensagem na fila, ou marcada como enviada, mostra que o serviço aceitou o pedido. Isso ainda não é evidência de entrega. Entrega é a mensagem aparecer no aparelho do destinatário. Leitura é um terceiro estado, com condições próprias.

Se a integração usar eventos de atualização, que são avisos que o serviço manda quando o estado de uma mensagem muda, relacione cada evento à mensagem certa pela identificação. Um recibo não é uma mensagem nova do usuário, então não deve disparar resposta automática. E mantenha o exercício numa conversa individual, para não somar a complexidade dos recibos de grupo.

Um cuidado de vocabulário. A UazAPI é uma API comum, chamada por endereço web, o que chamamos de HTTP. Ela não vira automaticamente um conector MCP, que é o protocolo aberto para ligar o Claude a ferramentas. Para o Claude usá-la, é preciso produzir e testar um adaptador, que é a peça intermediária entre o pedido do Claude e a chamada à API. Até esse adaptador existir e ser testado, não dizemos que o Claude já está conectado ao WhatsApp.

### m06-a03-b05 — Dar ao Claude uma ferramenta de verdade

Slide m06-a03-s05

Para o Claude chamar a UazAPI, precisa haver uma ferramenta ou integração configurada. Uma skill com a frase “envie pelo WhatsApp” não cria esse acesso, e escrever o endereço da API numa instrução também não. A skill guarda o procedimento; o acesso acontece pela integração configurada no ambiente. Vamos separar o procedimento da ferramenta que faz a chamada HTTP.

O primeiro passo é usar o arquivo contrato-uazapi.md para definir a ferramenta e a validação. O contrato do material limita a ferramenta a duas operações: consultar o estado e enviar texto ao destino de teste. Nada além disso.

O segundo passo é configurar o segredo no ambiente protegido. A configuração protegida fornece a Server URL e o token. O procedimento recebe somente o que precisa para a tarefa, nunca o token em si. Quando a ferramenta é chamada, ela mesma valida o destinatário permitido e o conteúdo antes de falar com a API. Assim, mesmo que o pedido venha errado, a ferramenta recusa o que estiver fora do combinado.

O terceiro passo é conferir os campos. Na referência atual, enviar texto usa POST /send/text com dois campos: number e text. POST é o tipo de chamada que entrega dados ao serviço. O número individual segue o formato internacional exigido pelo serviço, com o código do país. Confira os dados do destinatário de teste por uma fonte confiável; não deduza um telefone a partir de um identificador desconhecido.

O quarto passo é a mensagem. Use a mensagem fictícia do arquivo mensagem-whatsapp.txt, que avisa que um documento de exercício aguarda revisão. Ela não contém dado de cliente nem pedido real.

Por fim, habilite o envio somente para o ensaio de teste preparado. Antes de executar, leia o pedido concreto: para quem, qual texto e qual finalidade. Enviar uma mensagem é uma ação com efeito fora do seu computador, e ela não se desfaz. Por isso, o envio fica sujeito à sua aprovação. No Claude Code, o modo padrão de permissões pergunta antes de cada ação. Existe também um modo automático, em que o próprio sistema avalia as ações; ele não garante que tudo esteja correto, e não é o mesmo que liberar tudo. A regra é dar permissão na medida do efeito: ler o estado é uma coisa, enviar mensagem é outra, e aqui você aprova cada envio. Só execute quando a conexão e o destino estiverem preparados e a ação estiver autorizada. A identificação da mensagem retornada será usada para acompanhar o resultado.

### m06-a03-b06 — Enviar, conferir o destino e fechar o ensaio

Slide m06-a03-s06

Com a sessão conectada e a ferramenta pronta, execute uma única mensagem de teste, depois de aprovar o destinatário e o texto. Guarde a identificação retornada e observe o estado informado pelo serviço. Depois, confira o recebimento no aparelho do destinatário combinado. Essas duas evidências respondem a perguntas diferentes: a primeira diz se o serviço aceitou o pedido, a segunda diz se a mensagem chegou.

Registre a identificação e o estado no arquivo registro-testes.md. Se houver atualização de status, relacione o evento à mensagem correta e anote também o recibo correspondente, quando o serviço o oferecer. Um recibo não deve iniciar uma resposta automática.

Se você quiser testar o caminho de volta, combine com o destinatário um texto simples e identifique a origem da mensagem. Trate o que chegou como entrada do processo, e não como permissão para acessar outros dados. Ou seja, o texto recebido não autoriza o agente a abrir arquivos nem a fazer mais envios.

Se ocorrer tempo esgotado ou uma resposta incerta, pare e consulte o estado antes de repetir. Não queremos duas mensagens só porque a primeira resposta se perdeu. Se a mensagem não chegou ao destino, registre a diferença entre aceite e entrega e não declare sucesso completo.

Ao terminar, encerre ou desative o acesso de teste que não precisa permanecer ativo, e confira o que ficou nos registros. Não deixe nenhuma rotina agendada ativa. Não publique token, QR Code nem número pessoal.

A atividade termina com um registro do que foi preparado, aceito, entregue e, se foi observado, lido. Se você não tem uma instância disponível, pode estudar o contrato e preparar a integração, mas o pareamento e a comunicação continuam não executados, e é assim que devem ser marcados no registro de testes. Esse limite deve ficar explícito no resultado do ensaio.

### m06-a03-b03 — Conferir o caminho completo

Slide m06-a03-s03

Agora temos três conferências: a instância estava conectada, a operação de envio foi aceita e a mensagem chegou ao destino. Confira cada uma separadamente, com o apoio do arquivo uazapi-ensaio.md. A leitura é outro estado, com condições próprias, e não é sinônimo de entrega.

Se algo falhar, anote em que parte o processo parou. Antes de tentar de novo, verifique a conexão, a resposta da operação e a identificação da mensagem. Um erro de acesso ou um número incorreto não se resolve com várias tentativas de envio.

O exercício termina quando você consegue mostrar o resultado e explicar o caminho que usou. Isso inclui confirmar que o acesso de teste foi encerrado e que nenhuma rotina ficou ativa.

Depois, aplique a mesma lógica a um processo seu. Defina a entrada com clareza, o procedimento, as ferramentas com o acesso adequado e uma saída que alguém consiga conferir. Esse é o fio que atravessa toda a formação: a autonomia do agente cresce na medida em que você entende o processo e consegue observar o que foi feito. Comece pequeno, com um caso que você conhece, e amplie o time conforme consiga conferir cada nova responsabilidade.

# 6.2 — Conectando no WhatsApp com api não oficial

ID m06-a03. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Dependências e ensaio:** BLOCKED_FOR_LIVE_DEMO: usuário já confirmou ausência de instância UazAPI. Não houve pareamento, envio, recebimento ou prova de entrega.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m06-a03-b01 | m06-a03-s01 / p. 1 | Criar/configurar previamente uma instância UazAPI dedicada. Confirmar versão e Server URL; não usar conta de atendimento. Pareamento e testes ainda NOT_RUN. | Instância dedicada tem configuração e estado identificados sem revelar token ou pareamento. |
| m06-a03-b04 | m06-a03-s04 / p. 2 | Preparar Server URL/token de instância e pareamento fora da captura; consultar status. | Sessão de teste conectada e status observado; nenhum envio confundido com conexão. |
| m06-a03-b02 | m06-a03-s02 / p. 3 | Usar o caminho atual documentado: consultar /instance/status, conectar/parear via /instance/connect quando necessário, expor operação limitada ao agente e enviar texto de teste por /send/text. Observar ID e recibo; não apresentar API HTTP como MCP existente sem produzir/testar o adaptador. | Status/conexão são conferidos; um único POST /send/text retorna identificação da mensagem. |
| m06-a03-b05 | m06-a03-s05 / p. 4 | Configurar integração limitada e preparar envio de texto com destino permitido e mensagem fictícia. | Ferramenta real disponível, segredo fora do prompt e efeito limitado ao destino de teste. |
| m06-a03-b06 | m06-a03-s06 / p. 5 | Executar mensagem única, conferir recebimento e encerrar acesso de teste. | Aceite e entrega demonstrados separadamente; leitura só se observada; sem credenciais ou números publicados. |
| m06-a03-b03 | m06-a03-s03 / p. 6 | Conferir a mensagem no destino e o estado no provedor. Não repetir envios incertos; encerrar o exercício sem rotina ativa. Usar apoio/uazapi-ensaio.md. | Instância conectada, ferramenta validada e mensagem aceita/entregue conferidas separadamente; nenhuma repetição cega. |

## m06-a03-b01 — Preparar a instância de teste

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Criar/configurar previamente uma instância UazAPI dedicada. Confirmar versão e Server URL; não usar conta de atendimento. Pareamento e testes ainda NOT_RUN. | slides/m06-a03.pptx e slides/m06-a03.pdf, página 1, ID m06-a03-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a03-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a03-b01. Sem trilha prevista. |

**Estado inicial:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/contrato-uazapi.md, apoio/mensagem-whatsapp.txt, apoio/uazapi-ensaio.md, apoio/registro-testes.md

**Passos de captura:**
1. Criar/configurar previamente uma instância UazAPI dedicada. Confirmar versão e Server URL; não usar conta de atendimento. Pareamento e testes ainda NOT_RUN.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Instância dedicada tem configuração e estado identificados sem revelar token ou pareamento.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a03-b01; SHA-256 cd6471e332a5d8e2afd5157a4a02616763b10e790e2e3333c56709f6bd81c204.

**Função visual:** Criar/configurar previamente uma instância UazAPI dedicada. Confirmar versão e Server URL; não usar conta de atendimento. Pareamento e testes ainda NOT_RUN.


## m06-a03-b04 — Servidor, instância, número e conexão

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Preparar Server URL/token de instância e pareamento fora da captura; consultar status. | slides/m06-a03.pptx e slides/m06-a03.pdf, página 2, ID m06-a03-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a03-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a03-b04. Sem trilha prevista. |

**Estado inicial:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/contrato-uazapi.md, apoio/mensagem-whatsapp.txt, apoio/uazapi-ensaio.md, apoio/registro-testes.md

**Passos de captura:**
1. Confirmar existência de instância e número reservados para teste.
2. Conferir versão, endpoints e cabeçalho token na documentação atual.
3. Iniciar conexão e parear fora da gravação.
4. Consultar status e registrar estado sem segredo.

**Saída e conferência:** Sessão de teste conectada e status observado; nenhum envio confundido com conexão.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a03-b04; SHA-256 6180e4c2c29a3c7ba5a5b24ae489ae71ca9a19dc556e65dbd8082874f344da1e.

**Função visual:** Preparar Server URL/token de instância e pareamento fora da captura; consultar status.


## m06-a03-b02 — Conectar, enviar e acompanhar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Usar o caminho atual documentado: consultar /instance/status, conectar/parear via /instance/connect quando necessário, expor operação limitada ao agente e enviar texto de teste por /send/text. Observar ID e recibo; não apresentar API HTTP como MCP existente sem produzir/testar o adaptador. | slides/m06-a03.pptx e slides/m06-a03.pdf, página 3, ID m06-a03-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a03-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a03-b02. Sem trilha prevista. |

**Estado inicial:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/contrato-uazapi.md, apoio/mensagem-whatsapp.txt, apoio/uazapi-ensaio.md, apoio/registro-testes.md

**Passos de captura:**
1. Usar o caminho atual documentado: consultar /instance/status, conectar/parear via /instance/connect quando necessário, expor operação limitada ao agente e enviar texto de teste por /send/text. Observar ID e recibo; não apresentar API HTTP como MCP existente sem produzir/testar o adaptador.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Status/conexão são conferidos; um único POST /send/text retorna identificação da mensagem.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a03-b02; SHA-256 f80f83d2eeca88a40b9fbc57b105817c0a14270d3e318b4ac13d99d26337716b.

**Função visual:** Usar o caminho atual documentado: consultar /instance/status, conectar/parear via /instance/connect quando necessário, expor operação limitada ao agente e enviar texto de teste por /send/text. Observar ID e recibo; não apresentar API HTTP como MCP existente sem produzir/testar o adaptador.


## m06-a03-b05 — Dar ao Claude uma ferramenta de verdade

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Configurar integração limitada e preparar envio de texto com destino permitido e mensagem fictícia. | slides/m06-a03.pptx e slides/m06-a03.pdf, página 4, ID m06-a03-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a03-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a03-b05. Sem trilha prevista. |

**Estado inicial:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/contrato-uazapi.md, apoio/mensagem-whatsapp.txt, apoio/uazapi-ensaio.md, apoio/registro-testes.md

**Passos de captura:**
1. Usar contrato-uazapi.md para definir ferramenta e validação.
2. Configurar segredo no ambiente protegido.
3. Conferir number/text e destinatário autorizado.
4. Habilitar envio somente no ensaio de teste preparado.

**Saída e conferência:** Ferramenta real disponível, segredo fora do prompt e efeito limitado ao destino de teste.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a03-b05; SHA-256 0b71fec69d7e8ef5b9db8837234fb0ce9df13f575e31e12ce6c94f6948ebe45e.

**Função visual:** Configurar integração limitada e preparar envio de texto com destino permitido e mensagem fictícia.


## m06-a03-b06 — Enviar, conferir o destino e fechar o ensaio

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar mensagem única, conferir recebimento e encerrar acesso de teste. | slides/m06-a03.pptx e slides/m06-a03.pdf, página 5, ID m06-a03-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a03-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a03-b06. Sem trilha prevista. |

**Estado inicial:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/contrato-uazapi.md, apoio/mensagem-whatsapp.txt, apoio/uazapi-ensaio.md, apoio/registro-testes.md

**Passos de captura:**
1. Enviar uma única mensagem autorizada em conversa individual.
2. Registrar ID e estado do serviço.
3. Conferir aparelho de destino e, se disponível, recibo correspondente.
4. Não repetir resposta incerta; encerrar acesso dispensável e revisar logs.

**Saída e conferência:** Aceite e entrega demonstrados separadamente; leitura só se observada; sem credenciais ou números publicados.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a03-b06; SHA-256 970ce27980c9cf99d678214a8195c05165dfe77648ffc7b6be1cbe7830aa834c.

**Função visual:** Executar mensagem única, conferir recebimento e encerrar acesso de teste.


## m06-a03-b03 — Conferir o caminho completo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir a mensagem no destino e o estado no provedor. Não repetir envios incertos; encerrar o exercício sem rotina ativa. Usar apoio/uazapi-ensaio.md. | slides/m06-a03.pptx e slides/m06-a03.pdf, página 6, ID m06-a03-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m06-a03-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m06-a03-b03. Sem trilha prevista. |

**Estado inicial:** Não existe instância de teste atualmente. Preparar Server URL, sessão, número e destino antes do ensaio; manter tokens e pareamento fora de captura.

**Entrada/material:** apoio/guia-whatsapp.md, apoio/contrato-uazapi.md, apoio/mensagem-whatsapp.txt, apoio/uazapi-ensaio.md, apoio/registro-testes.md

**Passos de captura:**
1. Conferir a mensagem no destino e o estado no provedor. Não repetir envios incertos; encerrar o exercício sem rotina ativa. Usar apoio/uazapi-ensaio.md.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Instância conectada, ferramenta validada e mensagem aceita/entregue conferidas separadamente; nenhuma repetição cega.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m06-a03-b03; SHA-256 85b7c341ce741fe867c9ab8bafa9d7aff68454e2aea2070f8c0b41955eb1440b.

**Função visual:** Conferir a mensagem no destino e o estado no provedor. Não repetir envios incertos; encerrar o exercício sem rotina ativa. Usar apoio/uazapi-ensaio.md.


## Atividade e solução

Com instância e destino reservados, parear, consultar status, enviar uma mensagem e conferir recebimento; sem ambiente, registrar comunicação NOT_RUN.

Instância conectada, ferramenta validada e mensagem aceita/entregue conferidas separadamente; nenhuma repetição cega.

## Materiais

- guia-whatsapp.md
- contrato-uazapi.md
- mensagem-whatsapp.txt
- uazapi-ensaio.md
- registro-testes.md