Bruno Tiburcio
← Todas as análises 01 Fundamentos

Não crie agente se uma skill resolve

Bruno Tiburcio 6 de outubro de 2026 Leitura de 7 minutos

A própria Anthropic, a empresa do Claude, recomenda começar pela solução mais simples, e diz que às vezes isso significa não construir agente nenhum. No escritório, a tradução é direta: não crie agente se uma skill resolve.

Skill e agente: a diferença

Skill e agente usam a mesma IA. O que muda é quem decide os passos.

Skill é uma receita. Você decide os passos e a IA executa cada um, sempre do mesmo jeito. Chegou a intimação, a IA resume, anota o prazo na planilha e avisa a equipe. É mais barata, mais previsível e mais fácil de conferir.

Agente é um estagiário com autonomia. Você dá o objetivo, por exemplo "analise este caso e prepare o que for preciso", e ele decide sozinho o que ler, o que pesquisar e o que fazer. Vale quando cada caso pede um caminho diferente. Custa mais e erra de jeitos novos.

O teste das três perguntas

  1. Os passos são sempre os mesmos? Skill.
  2. Dá para desenhar a tarefa num papel antes de começar? Skill.
  3. Cada caso exige um caminho que você não consegue prever? Aí sim, agente.

As 100 tarefas do escritório

Separei cem tarefas das dez áreas do escritório como empresa, do jurídico ao financeiro, do comercial à gestão de pessoas. Em cada área, cinco pedem skill e cinco pedem agente. A divisão é julgamento, não medição: a mesma tarefa pode mudar de lado conforme o tamanho e a variedade dos casos do seu escritório.

Mapa com 100 tarefas das 10 áreas do escritório, cada uma marcada como skill ou agente.
O mapa completo. Salve a imagem para consultar.
01 · Jurídico e produção
SkillAgente
Formatar peça no timbradoLer autos e propor tese
Resumir decisão recebidaAchar precedente do caso
Revisar com seu checklistPreparar a audiência
Preencher peça-modeloRebater contestação nova
Conferir citações da peçaDue diligence de contratos
02 · Controladoria
SkillAgente
Ler publicação do diaDistribuir prazo por carga
Cadastrar prazo na agendaAchar prazo fora do padrão
Resumir andamento novoVigiar processo e agir
Gerar guia de custasCobrar quem está atrasado
Checklist de protocoloAuditar a pauta da semana
03 · Comercial
SkillAgente
Proposta de honoráriosQualificar lead no chat
Contrato de honoráriosPesquisar o cliente antes
Ficha de novo clienteProspectar empresas-alvo
Follow-up padrão do leadMontar proposta sob medida
Atualizar o CRMRecuperar lead perdido
04 · Marketing
SkillAgente
Legenda no tom da casaPesquisar pauta do nicho
Post de nova decisãoAnalisar concorrentes
Newsletter do mêsResponder comentários
Resumo de palestraReaproveitar artigo em 5
Calendário de postsMedir e ajustar campanha
05 · Atendimento ao cliente
SkillAgente
Relatório mensal do casoAtender dúvida no WhatsApp
Explicar decisão ao leigoResponder com o processo
Pesquisa de satisfaçãoAchar cliente em risco
Lembrete de documentosSugerir novo serviço
Resumo da reuniãoTriar e-mail do cliente
06 · Financeiro
SkillAgente
Emitir cobrança mensalNegociar honorário vencido
Calcular repasse de êxitoAchar caso que dá prejuízo
Conciliar o extratoPrever caixa do trimestre
Relatório de caixaAuditar despesas do mês
Lembrete de vencimentoCobrar inadimplentes
07 · Administrativo
SkillAgente
Pedido de compra padrãoCotar três fornecedores
Controle de fornecedoresOrganizar viagem
Agenda de salasRever contrato de aluguel
Renovação de contratosAchar gasto a cortar
Inventário de materiaisResolver chamado interno
08 · Gestão de pessoas
SkillAgente
Anúncio de vagaTriar 200 currículos
Roteiro de integraçãoMontar trilha por pessoa
Avaliação pelo formulárioAchar gargalo na equipe
Controle de fériasPlano de carreira próprio
Manual do estagiárioTreinar com casos reais
09 · Tecnologia e LGPD
SkillAgente
Checklist de backupMapear dados de clientes
Termo de consentimentoInvestigar acesso estranho
Cadastro de acessosAvaliar fornecedor de IA
Registro de incidenteResponder titular de dados
Política de senhasTestar falhas de segurança
10 · Sócios e indicadores
SkillAgente
Painel de produtividadePlanejamento estratégico
Ata da reunião de sóciosAchar área mais lucrativa
Rentabilidade por clienteSimular novo sócio
Relatório de metasComparar com o mercado
Checagem de conflitoDiagnosticar o escritório

Os 17 cuidados antes de ligar um agente

Quando o agente for mesmo necessário, ele vai ler documento, usar ferramenta e agir sem você olhar cada passo. Os 17 cuidados abaixo estão em português simples, com o nome que a documentação usa em inglês, para você pesquisar ou pedir à IA.

Os 17 cuidados antes de ligar um agente, em quatro blocos, com o que cada um evita.
Os 17 cuidados em quatro blocos.

Antes de criar

01Fluxo ou agente? Se os passos são sempre os mesmos, faça um fluxo. Evita: pagar por autonomia que não precisa.Workflow vs. Agent
02Teste com casos reais Separe casos já resolvidos e veja se ele acerta. Evita: mudar a instrução no escuro.Evals
03Explique cada ferramenta Diga quando usar e quando não usar. Evita: consultar o sistema na hora errada.Tool Design

Segurança

04Ele pede licença Enviar, protocolar ou apagar só com o seu ok. Evita: e-mail ao cliente sem você ler.Human-in-the-Loop
05Só a chave da sala certa Acesso apenas ao que a tarefa usa. Evita: abrir a pasta de outro cliente.Least Privilege
06Trabalho em sala fechada Pasta isolada e internet só onde você liberar. Evita: dado do cliente indo para fora.Sandboxing
07Documento não dá ordem O que ele lê é informação, nunca instrução. Evita: obedecer frase escondida no PDF da outra parte.Prompt Injection
08Confere antes de agir A ação precisa vir completa e no formato certo. Evita: agir com dado faltando.Input Validation

Enquanto trabalha

09Limite de voltas e de gasto Um teto para ele não girar sem parar. Evita: conta alta no fim do mês.Loop Guards
10Nada sai em dobro Se repetir a tarefa, o envio não se repete. Evita: o cliente receber o e-mail duas vezes.Idempotency
11Saber por que parou Terminou, travou ou faltou espaço? Evita: tarefa entregue pela metade.Stop Reasons
12Memória organizada Resume o que fez e guarda o essencial. Evita: esquecer o começo do processo.Context Management

No dia a dia

13Instrução fixa sai mais barata O texto que se repete fica guardado. Evita: pagar de novo pelo mesmo texto.Prompt Caching
14Registro de tudo O que fez, quanto gastou, onde errou. Evita: erro que ninguém vê.Observability
15Versão fixa do modelo Só troque a versão depois de testar. Evita: mudar de comportamento sem aviso.Model Pinning
16Um chefe, vários assistentes Cada assistente cuida de uma parte. Evita: um agente só, confuso com tudo.Orchestrator-Workers
17Quem faz não revisa Um segundo agente confere o primeiro. Evita: erro que passa sem conferência.Evaluator-Optimizer

Por onde começar

Não precisa aplicar os 17 de uma vez. Comece pelo que o seu agente faz:

  • Se o agente lê documento de terceiro: cuidados 07 · 05 · 06.
  • Se o agente envia, protocola ou paga alguma coisa: cuidados 04 · 10.
  • Se o agente roda sozinho, à noite ou em lote: cuidados 09 · 14 · 11.
  • Se o agente escreve peça ou parecer que vai ao cliente: cuidados 17 · 02.

No escritório, dois importam antes de todos. Uma petição da parte contrária pode trazer uma frase escondida mandando o agente agir: o que ele lê é informação, nunca ordem. E nenhum agente deveria protocolar ou mandar e-mail ao cliente sem a sua confirmação.

O que o mapa não resolve sozinho

  • A sala fechada não cobre tudo. Ela isola os comandos que o agente roda. Ler, editar e os conectores seguem as permissões que você der.
  • Ninguém evita o envio em dobro por você. Quem impede o e-mail repetido é o sistema que você monta, não a IA.
  • Não existe filtro automático. Separe o agente que lê o documento da outra parte do agente que pode enviar ou editar.

[Mapeado da documentação oficial da Anthropic, conferida em 03/10/2026. Ainda não rodei os 17 no meu ambiente.]

Fontes

  • Anthropic — Building Effective Agents começar pela solução mais simples; workflows e agentes; orquestrador e avaliador.
  • Claude Code — Secure deployment, Hooks, Permissions aprovação humana, privilégio mínimo e prompt injection.
  • Claude Code — Sandboxing o isolamento cobre os comandos de terminal, não leitura, edição e conectores.
  • Claude Code — CLI reference e Monitoring usage limite de turnos e de gasto; telemetria.
  • Claude API — Stop reasons, Context editing, Prompt caching, Model deprecations, Tool use itens 08, 11, 12, 13 e 15.
  • Documentação conferida em 03/10/2026.
Bruno Tiburcio
Bruno Tiburcio

Advogado e dono de escritório. Escreve sobre o que testa na própria operação.

Material gratuito

Comece pelo Guia da Reconstrução.

Onde a inteligência artificial mexe em cada área do escritório — e por onde começar sem parar a operação. São sete páginas escritas de dentro de um escritório em operação. Sem cadastro: o arquivo abre direto.

Abrir o Guia (PDF)

Análise semanal

Receber minhas análises

Uma por semana, sobre o que testei no meu escritório — inclusive o que não funcionou.

Um e-mail por semana. Você sai quando quiser.