00:00:00A equipe do Claude lançou os "managed agents" (agentes gerenciados), que eles chamam de a próxima evolução
00:00:09após o SDK de agentes.
00:00:11Isso permite que você crie agentes personalizados sem escrever uma única linha de código.
00:00:16E esses agentes rodam na própria infraestrutura gerenciada da Anthropic, que tem uma arquitetura muito legal
00:00:22perfeita para lançar agentes seguros, escaláveis e prontos para produção que podem fazer quase
00:00:27qualquer coisa que você desejar.
00:00:28Também respondem a consultas de clientes com base na sua base de conhecimento, ou até fazem pesquisas regulares
00:00:32para você e as enviam em um horário específico usando o Slack.
00:00:36Mas por que alguém usaria isso em vez de instalar o Claude Code em seu próprio VPS?
00:00:40Inscreva-se no canal e vamos conferir.
00:00:46Mas antes de começarmos, vamos falar um pouco sobre a Anthropic, pois eles estiveram ocupados
00:00:49nestas últimas semanas.
00:00:50Digo, eles recentemente impediram as pessoas de usar a assinatura do Claude em ferramentas
00:00:55de terceiros como o OpenClaw, o que as pessoas acham que é por causa dos agentes gerenciados, mas
00:01:00não são exatamente a mesma coisa.
00:01:01Eu diria que o OpenClaw é um pouco como o Linux.
00:01:04É um agente para quem gosta de fuçar.
00:01:06Você escolhe seu hardware, escolhe seu modelo, lida com a segurança e tudo
00:01:11o mais no meio do caminho.
00:01:12Já os agentes gerenciados do Claude são, ouso dizer, como a Apple, porque você não precisa
00:01:17fazer nada disso.
00:01:19O Claude cuida da infraestrutura, da segurança, você apenas diz o que quer em
00:01:24inglês simples, e ele seguirá em frente para construir seu agente perfeito.
00:01:28Na verdade, deixe-me mostrar como é fácil através de um exemplo simples, mas muito pessoal.
00:01:34Tenho um repositório privado no GitHub que contém todas as minhas informações médicas extraídas do
00:01:39aplicativo do NHS.
00:01:40E eu quero me comunicar com esses dados ou obter informações deles usando o Slack.
00:01:45Assim posso usá-lo do meu desktop, do celular, basicamente de onde eu estiver.
00:01:49Entre essas duas coisas, eu gostaria que um agente gerenciado do Claude fizesse o trabalho de extrair
00:01:54os dados, usando ferramentas para obter a informação correta e traduzindo-a de uma forma que eu possa entender.
00:02:01entender.
00:02:02Então, para começar, eu poderia ir ao console do Claude, acessar a nova opção de agentes gerenciados
00:02:07e digitar aqui em linguagem natural para criar meu agente do zero.
00:02:11Isso se comunicará com a API do Claude usando comandos curl e hospedará qualquer código
00:02:16necessário na infraestrutura da Anthropic.
00:02:19Mas eu também poderia usar a skill de agente gerenciado em qualquer linguagem que eu preferir.
00:02:23Neste caso, escolherei TypeScript e esta skill usará o SDK de TypeScript para Claude
00:02:29para criar um agente para mim.
00:02:31Para fazer isso, você precisará ter esta versão do código do Claude ou superior, que possui a
00:02:36skill de agente gerenciado integrada.
00:02:38No meu caso, tenho uma versão superior e posso acionar a skill usando o comando
00:02:42slash Claude API seguido por managed agents onboarding.
00:02:46Após dar enter, ele me pergunta se eu sei que tipo de agente quero construir, o que
00:02:50eu não sei, mas veremos o que ele faz.
00:02:52E ele me diz que me guiará por estes três passos.
00:02:55Ferramentas, habilidades, arquivos e repositórios, e então ambiente e identidade.
00:02:59Surpreendentemente, ele usa muito contexto, então pode haver alguma compactação, mas
00:03:04veremos o que acontece.
00:03:05Enfim, darei o comando para criar um agente médico que leia arquivos markdown de
00:03:10um repositório privado do GitHub, entenda a informação como um médico e me deixe comunicar com
00:03:15ele usando o Slack.
00:03:17Ele me recomenda usar o conjunto de ferramentas pré-definido, como read, glob e grep, e não usar
00:03:22write, edit e bash, já que o médico não tem razão para alterar o repositório, o que faz sentido.
00:03:27Também pede a URL do repositório, então direi para seguir com as ferramentas e permissões
00:03:31recomendadas, e fornecerei o link para o repositório.
00:03:35Depois disso, ele sugere o que as rodadas B e C devem ser, que, como este é um agente muito
00:03:39básico, são bem autoexplicativas.
00:03:41E então ele cria um prompt de sistema para meu agente, além de sugerir o modelo que ele deve
00:03:45utilizar.
00:03:46Vou dizer para usar o Sonnet porque não quero gastar muito dinheiro com o Opus.
00:03:49Explicarei o porquê depois, mas tirando isso, parece bom e fornecerei estas
00:03:53credenciais, bem como o idioma que desejo.
00:03:56E agora ele criou os dois arquivos para mim em TypeScript.
00:03:59O primeiro é a configuração, que definirá coisas como o ambiente, o agente,
00:04:04e quaisquer habilidades necessárias dentro da infraestrutura da Anthropic.
00:04:07O segundo é o runtime, que será de fato o que se comunica com
00:04:12os servidores da Anthropic e envia essa informação para o Slack.
00:04:15Vou configurar tudo isso e mostrar como fica quando estiver pronto.
00:04:19Após rodar este arquivo de configuração, ele me dá um ID de ambiente, que está bem aqui.
00:04:24E também me fornece o ID do agente, que também está aqui.
00:04:27Como mencionei antes, essas coisas são criadas na infraestrutura da Anthropic.
00:04:32Então, dentro do console do Claude, posso ver meu agente aqui, assim como o ambiente que
00:04:36acabei de criar.
00:04:37Também criei meu aplicativo do Slack e coloquei todas as informações no meu arquivo .env para
00:04:42que este arquivo apps.ts as use, o que significa que, se eu rodar esse arquivo, meu bot do Slack deve funcionar.
00:04:48Então eu poderia perguntar: qual modelo você está usando?
00:04:50E depois de um tempo ele responde: Sou o Claude, criado pela Anthropic.
00:04:54Existe algo médico em que eu possa ajudar?
00:04:56Isso é muito legal.
00:04:57Mas o que é ainda mais legal é que posso ver a sessão aqui no console do Claude.
00:05:01Sim, eu testei isso algumas vezes e aqui temos mais detalhes do que aconteceu.
00:05:04Se eu fechar isso para aumentar, você pode ver a pergunta que o usuário fez.
00:05:09Então ele usou a ferramenta de mensagem do Slack e o agente respondeu.
00:05:12Esqueci de mencionar antes como funciona o preço para isso.
00:05:15Se formos à documentação, vemos que todos os tokens usados pelos agentes gerenciados
00:05:20são tarifados com o modelo de preço que a API do Claude utiliza, que está aqui.
00:05:25Infelizmente, sua assinatura Pro Max ou Team não serve para agentes gerenciados, mas além
00:05:30de pagar pelos tokens, você também terá que pagar pelas sessões, que custam 8 centavos por hora
00:05:35de sessão.
00:05:36E isso é apenas quando a sessão está em execução.
00:05:38Se eu voltar ao console do Claude e clicar em sessões para todas essas sessões inativas,
00:05:42não estou sendo cobrado.
00:05:43Ok, vamos fazer algo um pouco mais interessante com este bot.
00:05:46Vou perguntar: com base no que você sabe sobre mim medicamente, tudo bem eu comer
00:05:50lula?
00:05:51Aqui ele executou a ferramenta bash para obter informações do repositório.
00:05:56Fez duas leituras de arquivos e, alguns segundos depois, me enviou uma mensagem no Slack, dizendo
00:06:01que eu devo ter cautela com lula porque sou alérgico a camarão, o que é verdade.
00:06:06Eu diria que ele deu informações demais falando sobre minha língua formigando até garganta inchada
00:06:11e assim por diante.
00:06:12Mas, para ser sincero, funciona muito bem.
00:06:13Na verdade, eu dei uma ajustada no agente.
00:06:15Se clicarmos aqui no console do Claude, podemos ver que há três versões, indicando
00:06:19que este agente foi alterado três vezes.
00:06:21Mudei o prompt de sistema para parecer um pouco mais humano e mudei o modelo
00:06:26de Opus para Sonnet.
00:06:27Mas aqui na interface, posso mudar o prompt de sistema do agente, o modelo e
00:06:32as ferramentas às quais ele tem acesso, o que é útil para testes.
00:06:35Então é basicamente isso.
00:06:36Além de alguns pequenos ajustes de código que descobri conversando com o Claude, é
00:06:41assim tão fácil construir um agente.
00:06:44Não há necessidade de aprender como funciona o SDK de agentes do Claude.
00:06:47Você pode apenas se comunicar com o Claude usando uma skill e criar seu próprio agente.
00:06:51Mas como tudo isso funciona por baixo do capô?
00:06:54A Anthropic escreveu um artigo detalhado sobre como tudo funciona, para o qual deixarei um
00:06:58link na descrição.
00:07:00Mas eu diria que toda a arquitetura é composta por três componentes principais.
00:07:05O session harness (suporte de sessão) e orquestração; isso não quer dizer que a sandbox e as ferramentas sejam menos
00:07:09importantes, mas eu diria que estes três são bem únicos.
00:07:12O harness, também conhecido como as mãos do sistema, é onde o modelo Claude é usado.
00:07:17E também é conhecido como um roteador sem estado porque ele roteia chamadas de ferramentas, recursos e MCPs para
00:07:23seu lugar relevante ou executa código e edita arquivos em um ambiente de sandbox.
00:07:28Falarei sobre os benefícios de ter as chamadas de ferramentas separadas do harness
00:07:32em si.
00:07:33Mas a sessão aqui é como a memória do sistema e contém logs apenas de acréscimo
00:07:37do harness.
00:07:38Você pode estar pensando que o harness é o Claude Code, mas na verdade é um harness feito sob medida
00:07:43para os agentes gerenciados.
00:07:44Também explicarei o porquê um pouco mais tarde.
00:07:47E, finalmente, o orquestrador é o que decide em quais modos o harness deve estar.
00:07:51Como plano de construção e assim por diante.
00:07:54E, crucialmente, ele cria um novo harness se este falhar.
00:07:58Imagine que você tem um harness aqui que falha ou cai.
00:08:02O orquestrador pode criar um novo harness.
00:08:04E como os logs da sessão são separados do harness em si, o novo harness pode ler
00:08:09os logs para saber o que estava acontecendo e exatamente de onde continuar.
00:08:13Na verdade, tudo foi construído para escala.
00:08:15Então você pode ter quantos modelos e quantos ambientes quiser, e a arquitetura
00:08:20será capaz de lidar com isso.
00:08:21Outro benefício desta arquitetura é o aspecto da segurança.
00:08:25Se eu voltar ao console do Claude e clicar no cofre de credenciais, verão que
00:08:30as credenciais são armazenadas em um local seguro.
00:08:32Se eu tiver um agente rodando localmente, poderia ser um arquivo .env ou algo personalizado que
00:08:36eu tenha implementado.
00:08:37Mas se estou usando o console do Claude ou a interface, todas as credenciais são armazenadas
00:08:41aqui.
00:08:42E a beleza disso é que essas credenciais são chamadas em tempo de execução.
00:08:45Portanto, se você tem uma chave de API específica para MCP ou uma chave de ferramenta, o harness ou o modelo
00:08:50não sabe nada sobre ela e não pode ter acesso a ela.
00:08:54Por exemplo, se eu precisasse chamar a ferramenta MCP de clima e tivesse aquela chave de API, o harness
00:09:00chamaria a ferramenta e a chave de API existiria dentro da própria chamada da ferramenta ou do MCP.
00:09:05E ela será usada em tempo de execução.
00:09:07Da mesma forma, se a sandbox precisasse usar uma chave, ela estaria armazenada no cofre.
00:09:12E isso também seria usado em tempo de execução e o modelo não saberia disso.
00:09:15Na verdade, ele nem sabe sua própria chave de API da Anthropic, já que ela também é usada
00:09:20em tempo de execução.
00:09:21Recomendo muito ler o resto deste artigo para ter uma visão detalhada de como
00:09:25tudo foi montado, mas é muito único.
00:09:28Honestamente, eu realmente gosto de criar agentes gerenciados do Claude.
00:09:31Existem pessoas por aí que acham que isso vai morrer, assim como os
00:09:36agentes da OpenAI.
00:09:37Se os agentes da OpenAI não morreram, por favor me avisem nos comentários, porque não ouço
00:09:39falar muito deles.
00:09:40Mas acho que isso aqui vai durar muito tempo puramente porque é muito fácil
00:09:45criar um agente.
00:09:46Você não precisa aprender sobre SDKs, não precisa usar o terminal para criar um se
00:09:51não quiser, e pode fazer quase toda a conexão com servidores MCP e ferramentas tudo
00:09:56dentro da interface, o que é muito bom para quem não quer escrever código.
00:10:01Mas devo dizer que algo um tanto decepcionante é o fato de que você tem que pagar usando
00:10:06tokens de API ou faturamento de API, porque, como assinante do Claude Pro,
00:10:12eu adoraria usar meus limites, os limites que estão na faixa do Pro, nos agentes gerenciados,
00:10:17para não ter que pagar por duas coisas diferentes.
00:10:20Mas, para ser justo, não é absurdamente caro se você usar um modelo mais barato como Sonnet ou Haiku.
00:10:26E embora seja meio curado, como podem ver, ele dá acesso ao Notion,
00:10:31servidores MCP do Slack e assim por diante, se você quiser criar algo que não existe dentro
00:10:36desses limites, teria que escrever seu próprio código, para o qual o OpenClaw é
00:10:40muito bom.
00:10:41O OpenClaw é super aberto, está no nome, e tem muitos canais, do Telegram ao
00:10:46Discord e WhatsApp, enquanto se você quiser fazer o mesmo com agentes gerenciados,
00:10:51pode ter que programar sua própria solução ou pedir para o Claude programar uma para você.