Isso Mudou Minha Forma de Trabalhar com Agentes

AAI LABS
컴퓨터/소프트웨어창업/스타트업경영/리더십AI/미래기술

Transcript

00:00:00O Co-work oferece a não-desenvolvedores o poder do cloud code, permitindo que criem
00:00:04automações reais, fluxos de documentos, pipelines e tarefas de pesquisa que antes eram restritas
00:00:10apenas ao terminal.
00:00:11Mas a maioria ainda recebe resultados de baixa qualidade e reclama que o uso do co-work
00:00:15tem consumido todos os seus limites.
00:00:17Isso não acontece por causa da ferramenta em si, mas porque não há nenhum esforço
00:00:21dedicado à configuração prévia.
00:00:22Não existe um jeito único de fazer essa configuração; é sempre uma série de passos para
00:00:26deixar o fluxo de trabalho sob medida para o que você precisa.
00:00:28Eu sei que já falamos sobre essas boas práticas na maioria dos nossos vídeos anteriores,
00:00:32mas encontramos algumas novas que são realmente boas e impactaram muito nossos fluxos.
00:00:37A primeira coisa a fazer, antes de qualquer outra, é criar um arquivo manifest.md para cada
00:00:42pasta com a qual você trabalha.
00:00:43Este arquivo fica na raiz da pasta e contém orientações sobre como a estrutura da pasta
00:00:47está organizada.
00:00:48Para usuários do cloud code, esse arquivo equivale ao arquivo claud.md.
00:00:52Se você, como nós, trabalha em pastas com muita informação aninhada
00:00:56e estruturada, o manifest ajuda muito a lidar com esses diretórios.
00:01:00O Claude tende a se perder e puxar ruído de arquivos irrelevantes.
00:01:03Isso ocorre porque, sem um arquivo manifest, o Claude navega pela pasta tentando adivinhar
00:01:07onde está o arquivo correto.
00:01:09Isso infla o contexto desnecessariamente, levando ao uso da fonte errada e gerando
00:01:14um resultado de má qualidade.
00:01:15Este arquivo indica quais documentos são a fonte da verdade, quais subpastas mapeiam cada domínio
00:01:20e o que deve ser totalmente ignorado.
00:01:21O manifest.md contém 3 níveis de prioridade de arquivos para que o Claude saiba em quais arquivos
00:01:27deve focar e quais deve ignorar.
00:01:28O Nível 1 contém todos os arquivos que seu modelo deve sempre carregar e que servem como
00:01:33fonte da verdade, listando o que não pode ser ignorado de jeito nenhum.
00:01:36O Nível 2 são os arquivos que você quer que sejam carregados sob demanda.
00:01:39Isso inclui arquivos que você não precisa imediatamente, mas que podem vir a ser úteis.
00:01:43E, por fim, o terceiro nível é o de dados de arquivo, que são versões antigas de dados que você
00:01:48não precisa, mas mantém para registro.
00:01:50É por isso que o marcamos como “Ignore, a menos que seja solicitado”.
00:01:53Com essa configuração, sempre que fazemos uma pergunta no cowork, ele carrega o manifest.md
00:01:59primeiro e, a partir dele, localiza o arquivo com os dados necessários, respondendo
00:02:03à nossa consulta de forma muito mais rápida e confiável do que sem ele.
00:02:07Além do manifest.md, você precisa criar mais 3 arquivos de contexto que definem
00:02:12a sua identidade.
00:02:13Estes arquivos são: Sobre Mim, Voz da Marca e Estilo de Trabalho, cada um explicando como você prefere as respostas
00:02:19para que o Claude saiba como se comportar.
00:02:20Isso elimina resultados genéricos de IA, pois o Claude passa a conhecer o seu estilo de trabalho.
00:02:25Nós colocamos esses arquivos na pasta de contexto do Claude, dentro da pasta Documentos, e os
00:02:29deixamos acessíveis de qualquer lugar informando o Claude nas instruções.
00:02:33Isso garante que o Claude responda de acordo com o que precisamos e não se comporte de uma
00:02:38maneira que não gostamos.
00:02:39Esses arquivos não devem ser criados uma vez e usados para sempre.
00:02:42Eles precisam ser refinados com frequência; se você notar que o Claude não seguiu as instruções
00:02:46dadas nos arquivos, avalie se o problema é o prompt ou o contexto.
00:02:51Seja qual for o caso, você pode adicionar linhas a esses arquivos para corrigir as coisas.
00:02:52Além desses arquivos, você precisa criar arquivos de memória para que, se estiver trabalhando continuamente
00:02:54em uma pasta específica, ele mantenha a memória entre as sessões através desses arquivos.
00:02:59Isso funciona de forma similar à programação, deixando os arquivos agirem como nossa memória externa para todas as decisões
00:03:03e tarefas que precisam ser feitas.
00:03:08A próxima coisa é algo que as pessoas costumam ignorar: as instruções globais.
00:03:10Muitos simplesmente as deixam em branco, mas elas são poderosas porque essas instruções
00:03:13são carregadas antes de qualquer outra coisa, até mesmo antes do seu prompt.
00:03:17Elas servem como ponto de partida para todos os seus comandos.
00:03:21Para o Claude code, isso equivale às instruções no arquivo Claude.md na pasta .Claude
00:03:23do diretório home.
00:03:28Nas minhas instruções globais, eu declarei especificamente que o manifest.md é a primeira coisa que o Claude
00:03:30deve olhar e como navegar por ele.
00:03:35Mas também existem outras práticas que tornam o trabalho com o Claude mais gerenciável.
00:03:37Por exemplo, eu permito que o Claude faça perguntas de esclarecimento antes de agir.
00:03:41Assim, ele não executa cegamente o que acha que é certo e pode corrigir o curso com
00:03:45perguntas relevantes.
00:03:48Outra coisa para incluir nas configurações globais é pedir para o Claude mostrar um plano breve antes
00:03:50de entrar em ação.
00:03:54Quando ele apresenta um plano primeiro, você consegue ver se a direção está correta ou não.
00:03:55Você pode adicionar outras regras como preferir.
00:03:59Por exemplo, eu adicionei instruções para evitar palavras de preenchimento e não enrolar na resposta, algo
00:04:00que o Claude costuma fazer normalmente.
00:04:05Também declarei explicitamente que, se a confiança for baixa, o Claude deve perguntar em vez de dar
00:04:06respostas erradas com convicção.
00:04:11Tudo isso contribui para uma experiência muito melhor com o cowork.
00:04:12Mesmo com prompts vagos, essa configuração faz com que ele responda com precisão.
00:04:16E como já mencionei, usamos arquivos de contexto do Claude para orientar o tom e a personalidade, então
00:04:19também incluí isso nas instruções globais para que ele possa consultá-los sempre que necessário.
00:04:24Embora isso seja algo que você ouve repetidamente em nossos vídeos, você também precisa
00:04:28garantir que o contexto dado ao seu agente seja mínimo, seja declarando isso explicitamente
00:04:32no prompt ou controlando-o com arquivos como o manifest.md ou similares.
00:04:36Quanto menos a janela de contexto estiver cheia de ruído, melhor será o desempenho.
00:04:41Agora, os prompts, instruções de configuração e modelos estão disponíveis no AI Labs Pro.
00:04:44Para quem não sabe, é a nossa comunidade recém-lançada onde você recebe modelos prontos para usar
00:04:48que pode aplicar diretamente nos seus projetos, deste vídeo e de todos os anteriores.
00:04:52Se você encontrou valor no que fazemos e quer apoiar o canal, esta é a melhor forma
00:04:57de fazer isso; o link está na descrição.
00:05:01Outra coisa que precisamos fazer é definir o estado final do que você quer alcançar, em vez
00:05:03de definir apenas o processo.
00:05:07Como sempre dizemos, se mostrarmos ao modelo como é o resultado correto, ele tende a
00:05:09ter um desempenho melhor e a iterar em direção a esse objetivo.
00:05:13Esse resultado correto pode ser qualquer coisa: casos de teste, o resultado final no prompt ou referências semelhantes.
00:05:16Este princípio se aplica a todos os agentes, seja o cowork, o Claude code ou qualquer outro.
00:05:21Quando quisemos realizar uma tarefa de reorganização em nossa pasta, declaramos especificamente
00:05:26qual versão de cada arquivo deveria ir para qual pasta e o que cada pasta deveria conter
00:05:31após a reorganização ser concluída, em vez de apenas pedir para reorganizar os arquivos.
00:05:36Também detalhamos como ele deveria tratar pastas aninhadas e mencionamos explicitamente o que ele
00:05:40não deveria tocar.
00:05:45Este prompt permitiu que o Claude trabalhasse em direção a esse objetivo de forma ordenada, tornando a tarefa
00:05:46muito mais fácil, pois agora ele sabia como deveria ser o resultado final.
00:05:50Precisamos dizer explicitamente ao Claude o que ele deve fazer se estiver incerto sobre qualquer tarefa.
00:05:54Geralmente damos instruções claras em nossos prompts sobre o que ele precisa fazer e
00:05:58o melhor caminho a seguir, mas não mencionamos como ele deve lidar com casos omissos.
00:06:03Nessas situações, o Claude tende a adivinhar e, na maioria das vezes, erra porque
00:06:06não conhece a nossa abordagem preferida.
00:06:10Então, você precisa declarar especificamente o que ele deve fazer nessas situações.
00:06:12Fizemos isso adicionando nas instruções globais que, se o Claude estiver incerto sobre algo,
00:06:16ele deve perguntar usando palavras, e se a confiança for baixa, ele deve informar.
00:06:21Nas nossas pastas de documentos, em Estilo de Trabalho, também especificamos que se ele estiver em dúvida
00:06:25sobre algo, deve dizer e explicitamente não adivinhar ou apresentar como fato.
00:06:30Com isso configurado, o Claude sinaliza a incerteza antecipadamente em vez de errar com convicção.
00:06:34Mas antes de prosseguirmos, vamos dar uma palavra com o patrocinador, Scrimba.
00:06:39A maioria de nós aprende a programar assistindo a um vídeo, travando e alternando constantemente entre
00:06:42o navegador e um editor até o cérebro derreter.
00:06:46O Scrimba resolve isso.
00:06:49Eles criaram a tecnologia Scrim, onde o reprodutor de vídeo é, na verdade, um editor de código ao vivo.
00:06:50A qualquer momento, você pode pausar, clicar diretamente no código do instrutor e começar a editar
00:06:54ali mesmo para ver o que acontece.
00:06:58É como fazer programação em par com especialistas, e é isso que faz o aprendizado
00:07:00realmente fixar.
00:07:04O Scrimba oferece o treinamento especializado necessário para dominar a engenharia de IA e o desenvolvimento full stack
00:07:05para um portfólio de alta qualidade.
00:07:09Se você é estudante ou está se preparando para entrevistas, esses mergulhos profundos ajudam a se preparar para
00:07:11testes técnicos cobrindo estruturas de dados em Git.
00:07:15É a maneira mais eficiente de encurtar a distância entre a curiosidade e a engenharia profissional.
00:07:18Pare de assistir a tutoriais passivos e comece a ganhar experiência real através da construção
00:07:22interativa hoje mesmo.
00:07:26Comece hoje com os cursos gratuitos deles e, quando estiver pronto, use nosso link no
00:07:27comentário fixado abaixo para economizar 20% extras nos planos pro.
00:07:31Em vez de usar uma sessão diferente para cada tarefa, você precisa agrupar o trabalho relacionado em uma
00:07:35única sessão.
00:07:39Como identificar quais tarefas podem ser agrupadas em uma única sessão e quais não?
00:07:40A primeira pista é que algumas tarefas compartilham o mesmo contexto, pois o resultado
00:07:45de uma tarefa serve como entrada para a próxima e assim por diante.
00:07:49Por exemplo, gerar o relatório de resumo do orçamento mensal costuma envolver várias tarefas
00:07:51interconectadas.
00:07:56Nesses casos, precisamos agrupar tarefas semelhantes para que rodem de forma mais rápida, barata e com
00:07:57maior qualidade.
00:08:01Isso também ajuda a evitar atingir os limites de sessão com frequência, já que você conclui mais tarefas
00:08:02em menos sessões.
00:08:06Ao dar comandos ao Claude, começamos explicitamente com um objetivo, depois mencionamos o primeiro
00:08:08passo necessário, depois o próximo e assim por diante, até que o objetivo seja alcançado.
00:08:12Essa abordagem nos permitiu concluir mais tarefas de forma muito mais rápida.
00:08:16No entanto, se as tarefas não estiverem interconectadas, agrupá-las não só desperdiçará
00:08:19tokens como também poderá resultar em saídas incorretas.
00:08:23O agrupamento de tarefas não precisa ser feito apenas sequencialmente.
00:08:26Se houver tarefas que possam ser feitas em paralelo, você pode integrá-las utilizando
00:08:29agentes paralelos.
00:08:34O Claude consegue identificar automaticamente a necessidade de paralelismo e executá-lo por conta própria.
00:08:35Mas não custa nada mencionar isso explicitamente no seu prompt.
00:08:39Também usamos subagentes intensamente para tornar nossas tarefas mais rápidas e convenientes.
00:08:42Com subagentes, um grande número de tarefas pode ser concluído rapidamente e suas janelas de contexto
00:08:46dedicadas evitam que o contexto principal fique inchado com informações desnecessárias.
00:08:50No entanto, um ponto de atenção é que subagentes consomem muitos tokens, então você deve
00:08:55usá-los apenas quando for absolutamente necessário.
00:08:59Além disso, se você estiver gostando do nosso conteúdo, considere apertar o botão de hype, pois isso nos ajuda
00:09:02a criar mais conteúdos como este e a alcançar mais pessoas.
00:09:06O Co-work leva vantagem porque podemos agendar tarefas que antes fazíamos manualmente
00:09:10dando prompts repetidamente.
00:09:14Agora podemos agendar uma série de tarefas que realizamos todos os dias.
00:09:15Essas tarefas agendadas só rodam quando o seu computador está ligado e o Claude desktop aberto,
00:09:18então essa é uma consideração importante.
00:09:23Como já tínhamos um sistema rodando o tempo todo, usando o Open Claude para pesquisar novas ideias,
00:09:24acompanhar lançamentos de ferramentas e nos reportar no Discord, pedimos ao Co-work para agendar
00:09:29outra automação.
00:09:34Agora usamos a habilidade de agendamento e pedimos ao Claude para analisar as notas de reunião onde discutimos
00:09:35novas ideias e ferramentas, e para escrever um relatório baseado nessas notas para o mesmo dia
00:09:39nesta pasta.
00:09:44Também fornecemos um formato de nome de arquivo adequado e pedimos para identificar itens acionáveis.
00:09:45Em resposta a esse prompt, o Claude nos fez perguntas sobre a frequência e agendou
00:09:49a tarefa para nós.
00:09:54E agora recebemos relatórios frequentes das nossas notas de reunião, ideias e ferramentas que
00:09:55podemos usar em nossos vídeos, tudo derivado das nossas discussões.
00:09:59Este processo pode ser melhorado ainda mais usando conectores para ligar o Gmail ou o Google Drive,
00:10:02permitindo escrever e-mails ou salvar arquivos diretamente na caixa de entrada.
00:10:07Também podemos fazer isso configurando cron jobs no Claude code e deixando-o interagir com
00:10:11ferramentas MCP e CLIs para realizar o mesmo trabalho.
00:10:15Para tornar nosso fluxo de trabalho muito mais eficiente, precisamos usar plugins para combinar capacidades.
00:10:18Cada plugin contém essencialmente um pacote de habilidades ou comandos, junto com integrações de subagentes,
00:10:22todos voltados para uma área específica e especializados em trabalhar naquele domínio por
00:10:27incluírem instruções personalizadas.
00:10:32O Claude já possui muitos plugins integrados para casos de uso comuns, mas também podemos criar os nossos.
00:10:34Esses plugins são de código aberto e estão disponíveis no GitHub.
00:10:38O conjunto de plugins contém até um plugin para criar outros plugins.
00:10:41Quando quisemos criar um plugin próprio, simplesmente pedimos à interface de chat para fazê-lo
00:10:44e ele executou a função de construção do novo plugin.
00:10:49O Claude nos fez uma série de perguntas em uma sessão e depois apresentou um plano.
00:10:51Assim que aprovamos o plano, ele começou a construir tudo.
00:10:55Isso torna o processo ainda mais fácil, pois agora não precisamos depender apenas de plugins
00:10:58feitos por outros; podemos criar os nossos, adaptados para nossos casos de uso exclusivos.
00:11:02Outra coisa que vale a pena mencionar é o uso de habilidades (skills).
00:11:07Já falamos detalhadamente sobre como construir uma boa habilidade e mostramos o
00:11:09processo de criação de novas habilidades, incluindo como lidar com os problemas que encontramos
00:11:13ao construir as nossas.
00:11:17Você pode conferir esses guias no nosso canal; eles vão te ajudar quando for construir suas
00:11:18próprias habilidades.
00:11:22O Claude também vem com muitas habilidades nativas para tarefas comuns, mas podemos
00:11:23criar habilidades personalizadas projetadas especificamente para nossos casos de uso.
00:11:27Finalmente, temos que tratar o cowork como um funcionário, não como um brinquedo.
00:11:31O cowork ainda é uma prévia de pesquisa com proteções limitadas, o que significa que ele pode modificar coisas
00:11:35que não deveriam ser alteradas se não houver restrições adequadas.
00:11:39Precisamos dar limites claros para tirar o máximo proveito dele.
00:11:42Dados sensíveis devem ser mantidos em pastas separadas, expondo apenas o que é realmente necessário,
00:11:45garantindo que o cowork não acesse informações privadas.
00:11:49Também precisamos delimitar bem suas tarefas para garantir um bom desempenho.
00:11:52Por exemplo, adicionar instruções como “não delete nada” garante que ele não
00:11:56exclua arquivos e peça permissão antes de remover algo se for necessário, como fazíamos
00:12:00durante nossos comandos.
00:12:04Também existe o risco de injeção de prompt (prompt injection).
00:12:05Se um documento ou site contiver instruções prejudiciais, o cowork pode executá-las e causar problemas.
00:12:07Além disso, o cowork consome mais recursos do que um chat normal, então, se usado excessivamente,
00:12:12seu limite de contexto será atingido rapidamente.
00:12:17Você precisa utilizá-lo com cuidado para obter o melhor resultado possível.
00:12:19Isso nos traz ao final deste vídeo.
00:12:22Se você quiser apoiar o canal e nos ajudar a continuar fazendo vídeos como este, você pode
00:12:23fazer isso usando o botão Super Thanks abaixo.
00:12:27Como sempre, obrigado por assistir e vejo você no próximo vídeo.
00:12:30Como sempre, obrigado por assistir e vejo você no próximo.

Key Takeaway

O sucesso com agentes de IA como o Co-work e Claude Code depende menos da ferramenta e mais de uma configuração rigorosa de contexto, estrutura de arquivos e instruções globais para garantir precisão e eficiência.

Highlights

A importância de configurar um arquivo manifest.md na raiz das pastas para orientar o modelo sobre a estrutura de arquivos.

Criação de arquivos de contexto personalizados (Sobre Mim, Voz da Marca, Estilo de Trabalho) para eliminar respostas genéricas.

Uso estratégico de instruções globais para definir comportamentos padrão, como pedir planos de ação antes da execução.

Agrupamento de tarefas relacionadas em uma única sessão para economizar tokens e manter a coerência do contexto.

Adoção de subagentes e plugins personalizados para especializar o fluxo de trabalho em domínios específicos.

Necessidade de definir o estado final desejado em vez de apenas descrever o processo de execução.

Tratamento da IA como um funcionário real, estabelecendo limites claros e protocolos para incertezas.

Timeline

Configuração Inicial e o Arquivo Manifest

O palestrante introduz o conceito de Cloud Code no Co-work, explicando que resultados ruins geralmente derivam da falta de configuração prévia e não de falhas na ferramenta. A solução central proposta é a criação de um arquivo manifest.md, que atua como um mapa para o agente navegar em diretórios complexos. Este arquivo utiliza três níveis de prioridade para classificar documentos como fontes da verdade, arquivos sob demanda ou dados de arquivo que devem ser ignorados. Sem esse mapeamento, o modelo tende a puxar ruído de arquivos irrelevantes, o que consome limites de contexto e degrada a qualidade da resposta. Esta etapa é fundamental para garantir que a IA localize informações de forma rápida e confiável.

Arquivos de Contexto e Identidade

Nesta seção, discute-se a criação de três arquivos fundamentais: Sobre Mim, Voz da Marca e Estilo de Trabalho. Esses documentos servem para definir a identidade do usuário e como ele prefere que as respostas sejam estruturadas, evitando o tom genérico típico das IAs. É recomendado que esses arquivos sejam armazenados em uma pasta de contexto dedicada e sejam refinados constantemente com base no desempenho do agente. O palestrante também menciona a importância dos arquivos de memória, que funcionam como uma memória externa para manter o histórico de decisões entre diferentes sessões. Isso transforma a interação com o Claude em um processo contínuo e personalizado.

Potencializando Instruções Globais

As instruções globais são apresentadas como uma ferramenta poderosa que o Claude carrega antes de qualquer prompt específico do usuário. O palestrante detalha como usa esse espaço para ordenar que o manifest.md seja a primeira consulta e para estabelecer regras de comportamento. Entre as práticas recomendadas estão permitir que a IA faça perguntas de esclarecimento e exigir a apresentação de um plano breve antes da execução das tarefas. Outras diretrizes incluídas visam eliminar palavras de preenchimento e garantir que o modelo admita quando sua confiança for baixa em vez de alucinar. Essas configurações criam uma base sólida que permite ao agente responder com precisão mesmo a prompts mais vagos.

Estratégias de Contexto e Estado Final

O foco aqui recai sobre a minimização do ruído na janela de contexto para otimizar o desempenho do modelo. O palestrante enfatiza a importância de definir o estado final desejado de uma tarefa, como o layout final de uma pasta organizada, em vez de apenas descrever os passos do processo. Ao fornecer exemplos do resultado esperado ou casos de teste, o agente consegue iterar de forma mais assertiva em direção ao objetivo. O vídeo exemplifica isso com uma tarefa de reorganização de arquivos onde regras específicas sobre pastas aninhadas e arquivos intocáveis foram estabelecidas. Essa abordagem baseada em objetivos reduz drasticamente a margem de erro durante execuções complexas.

Lidando com Incertezas e Aprendizado Interativo

O orador aborda a tendência da IA de adivinhar quando as instruções são omissas, o que frequentemente leva a erros. Para mitigar isso, ele sugere instruir explicitamente o agente a sinalizar dúvidas e nunca apresentar suposições como fatos. No meio desta explicação, há uma inserção sobre a plataforma Scrimba, que oferece uma tecnologia onde o player de vídeo funciona como um editor de código ao vivo. Essa ferramenta é destacada como uma forma eficiente de aprender engenharia de IA e desenvolvimento full stack através da prática interativa. O conceito central reforçado é que a transparência sobre o que o modelo não sabe é tão vital quanto o que ele executa.

Agrupamento de Tarefas e Uso de Agentes

Esta seção explica como identificar tarefas que podem ser agrupadas em uma única sessão para economizar tokens e tempo, especialmente quando compartilham o mesmo contexto. O palestrante diferencia tarefas sequenciais de tarefas que podem ser executadas em paralelo por subagentes especializados. O uso de subagentes é recomendado para manter o contexto principal limpo, embora exija cautela devido ao alto consumo de recursos. É ressaltado que o agrupamento incorreto de tarefas não relacionadas pode causar confusão no modelo e desperdício de processamento. A estratégia ideal envolve iniciar com um objetivo macro e listar os passos ordenados dentro de um mesmo fluxo de trabalho.

Agendamentos, Plugins e Segurança

O vídeo encerra demonstrando as capacidades avançadas de agendamento de tarefas no Co-work, como a criação automática de relatórios diários baseados em notas de reuniões. São discutidos o uso de plugins e habilidades (skills) para estender as funcionalidades da IA, incluindo a possibilidade de criar plugins personalizados através do próprio chat. O palestrante faz um alerta sério sobre segurança, tratando o agente como um funcionário que precisa de limites claros para evitar a modificação acidental de dados sensíveis. Ele menciona os riscos de injeção de prompt e o esgotamento rápido de limites de contexto se a ferramenta for usada sem critério. O encerramento reforça que a organização e a cautela são os pilares para transformar a IA em um aliado profissional produtivo.

Community Posts

View all posts