Arquivos de habilidades para agentes de IA: empacote um procedimento

Um arquivo de habilidade para agente de IA é um documento curto e versionado que descreve um procedimento repetível: quando ele se aplica, as etapas a seguir, as ferramentas que pode usar, os pontos em que uma pessoa precisa aprovar e como saber que o trabalho está concluído. O harness carrega o arquivo quando uma tarefa corresponde a ele. Assim, o procedimento fica fora do modelo, e a equipe consegue revisar, atualizar ou aposentar a regra sem treinar nada de novo nem reescrever um prompt longo e cheio de exceções. Bem feito, o arquivo transforma conhecimento que vive na cabeça de alguém em algo que um líder de operações consegue ler, questionar e delegar.

Principais pontos

• Um arquivo de habilidade cobre um procedimento, não a base de conhecimento inteira da empresa.
• Mantenha cada arquivo no harness sob controle de versão, com um responsável nomeado que aprova as mudanças.
• Todo arquivo deve declarar o gatilho, as etapas em ordem, o escopo das ferramentas, os pontos de aprovação e uma checagem de conclusão que um revisor consiga inspecionar.
• Teste cada nova versão com casos reais anteriores registrados antes de ela tocar no trabalho em produção, e mantenha a versão anterior pronta para restaurar.
• Aposente uma habilidade quando o procedimento mudar ou quando o arquivo gerar mais risco do que valor, sem editar habilidades não relacionadas.

O que deve existir em um arquivo de habilidade

Um arquivo de habilidade é mais estreito do que um manual da empresa. Ele descreve um procedimento que se repete, como preparar uma revisão de orçamento, cobrar uma entrega atrasada ou redigir um lembrete para fornecedor. A maioria dos arquivos úteis compartilha os mesmos campos, o que facilita comparar um com o outro lado a lado:

• Nome e finalidade, escritos em uma frase que um gestor reconheceria
• Condições de gatilho, indicando quais pedidos a habilidade trata e quais devem ser encaminhados para outro lugar
• Entradas obrigatórias e as fontes que o agente pode ler
• Etapas ordenadas, curtas o bastante para serem seguidas sem interpretação
• Ferramentas no escopo, com as ações específicas que cada uma pode executar
• Pontos de aprovação, em que o agente para e aguarda uma pessoa nomeada
• Checagem de conclusão, a evidência que um revisor consegue verificar
• Responsável e histórico de versões, incluindo o motivo da última mudança aprovada

O gatilho e a checagem de conclusão são os campos mais importantes. Sem gatilho, o harness carrega o arquivo para pedidos que ele nunca deveria atender. Sem checagem de conclusão, ninguém consegue saber se uma tarefa terminada de fato foi concluída.

Por que o procedimento deve ficar fora do modelo

Um procedimento enterrado em um prompt de sistema longo é difícil de mudar com segurança. Alguém copia um parágrafo para outro prompt, ajusta uma linha para um caso novo e esquece o original. Quando o modelo subjacente muda, a equipe precisa retestar tudo o que estava misturado no mesmo texto. O harness resolve isso decidindo, para cada tarefa, qual contexto, quais ferramentas e quais permissões o modelo recebe. O arquivo de habilidade é a unidade que o harness carrega, então o procedimento pode mudar no próprio ritmo.

As ferramentas seguem a mesma lógica. O Model Context Protocol oferece uma forma padrão de conectar modelos a ferramentas e dados externos. Dessa forma, o arquivo de habilidade pode citar a ferramenta e a ação permitida, sem carregar credenciais ou lógica de integração própria. Para uma visão mais ampla da camada que faz esse trabalho, veja o que é harness de IA? Um guia prático para negócios. Sobre o padrão de procedimentos reutilizáveis, Skills para agentes de IA: procedimentos reutilizáveis explica por que procedimentos curtos funcionam melhor do que um único prompt que só cresce.

Passo a passo: escreva seu primeiro arquivo de habilidade

Escolha um procedimento que já segue o mesmo caminho na maioria das vezes e que tenha um fim visível. Deixe de fora qualquer coisa em que a resposta certa dependa de um julgamento que ninguém escreveu ainda. Depois, siga esta sequência:

• Primeiro, peça à pessoa que faz o trabalho que percorra um caso recente e, em seguida, escreva as etapas na ordem em que acontecem de verdade, incluindo as verificações que ela só pula quando o caso é simples.
• Segundo, marque todo ponto em que dinheiro, dados de clientes, mensagens externas ou compromissos agendados mudam, e atribua um aprovador a cada um.
• Terceiro, liste as ferramentas que a habilidade pode chamar e remova qualquer ação que o procedimento não precise. Mantenha o acesso de leitura separado do acesso de escrita.
• Quarto, escreva a checagem de conclusão como itens que um revisor consegue confirmar, como um campo obrigatório preenchido, um valor igual ao da fonte ou uma mensagem enviada pelo canal aprovado.
• Quinto, reúna de cinco a dez casos anteriores com resultados conhecidos como corretos e registre qual era o resultado certo em cada um.
• Sexto, execute o rascunho da habilidade contra esses casos em um ambiente de teste, revise cada diferença e só então marque a versão um como aprovada para o trabalho real.

A última etapa é onde a maioria dos primeiros rascunhos muda. Os revisores costumam encontrar uma exceção esquecida, uma ferramenta mais ampla do que o necessário ou uma checagem de conclusão que depende de algo que o agente não consegue ver.

Cenário ilustrativo: uma habilidade de revisão de orçamento

Cenário ilustrativo: uma empresa de bufê quer que um agente revise o orçamento de um evento quando a quantidade de convidados muda. O gatilho da habilidade é um pedido de alteração por escrito que inclua a nova quantidade de pessoas. Ela pode ler a tabela de preços e o registro do evento, e pode redigir um orçamento revisado, mas não pode enviar nada. O ponto de aprovação exige que o responsável comercial confirme o rascunho antes que ele saia da empresa. A checagem de conclusão exige que cada linha revisada corresponda à tabela de preços e que a alteração apareça no registro do evento. Se a quantidade de pessoas estiver ausente ou contradizer o registro, a habilidade orienta o agente a fazer uma pergunta em vez de adivinhar.

Repare no que o arquivo não contém. Ele não guarda a política de preços completa da empresa, nem os modelos de contrato, nem as regras de agenda. Esses itens pertencem a outras habilidades ou às fontes de referência para as quais a habilidade aponta. Assim, qualquer uma delas pode ser atualizada sem reescrever o procedimento de orçamento.

Versione, teste e publique cada mudança

Trate um arquivo de habilidade como um pequeno software. Cada mudança recebe um novo número de versão, uma nota curta sobre o que mudou e por quê, e a aprovação do responsável. Execute a nova versão contra os casos registrados e compare os resultados com a versão atual, prestando atenção nos casos em que as duas divergem. As orientações de engenharia da Anthropic sobre avaliação de agentes descrevem a mesma prática: tarefas fixas, resultados avaliados e execuções repetidas, para que as mudanças sejam julgadas por evidência e não por impressão. Mantenha a versão anterior carregada ou disponível de imediato, para que uma falha no trabalho real possa ser revertida trocando uma única referência no harness. Definição de pronto para agentes de IA: exija evidência mostra como exigir essa evidência antes de aceitar um resultado.

Quando aposentar uma habilidade

Aposentar é tão importante quanto criar, e é a etapa que muitas equipes deixam de lado. Um arquivo de habilidade que não corresponde mais ao negócio continua sendo carregado, e o agente segue instruções que ninguém pretendia manter. Aposente uma habilidade quando uma destas condições se aplicar:

• O procedimento de negócio mudou e o arquivo ainda descreve a versão antiga.
• Uma ferramenta ou permissão da qual a habilidade depende foi retirada ou restringida.
• Avaliações recentes mostram que a habilidade não atende mais à sua checagem de conclusão.
• Uma habilidade mais nova cobre o mesmo procedimento, e dois arquivos agora disputam o mesmo gatilho.
• Nenhum responsável nomeado consegue explicar para que serve a habilidade.

Para aposentar um arquivo, remova-o da lista de carregamento do harness, arquive o histórico de versões com o motivo e confirme que nenhuma outra habilidade o referencia. Aposentar um arquivo nunca deveria exigir a edição de vários outros. Se exigir, as habilidades estão acopladas demais, e esse acoplamento merece uma revisão própria. O escopo de ferramentas de cada arquivo é mais fácil de auditar quando está escrito, como em Autorização de agentes de IA: níveis de permissão por confiança.

Como a Be Human trata arquivos de habilidade em operação gerenciada

A Be Human trata os arquivos de habilidade como parte do contexto operacional que continua sob controle da empresa. Uma primeira etapa define o papel útil, os procedimentos necessários, as ferramentas e permissões que cada habilidade pode usar, os limites de aprovação e um critério de sucesso observável para cada uma. Durante a operação gerenciada, a equipe acompanha como as habilidades rodam, agenda avaliações recorrentes, revisa permissões, mantém as integrações das quais as habilidades dependem e trata incidentes por um caminho de resposta documentado. Mudanças nos arquivos são propostas, testadas contra casos registrados e aprovadas pelo responsável da empresa antes de chegarem ao trabalho real, e os arquivos aposentados são arquivados com seus motivos. Se você não tem certeza por qual procedimento começar, o diagnóstico gratuito de IA da Be Human pode ajudar a encontrar a primeira tarefa que vale a pena entregar a um agente.

Perguntas frequentes

Um arquivo de habilidade para agente de IA é o mesmo que um prompt de sistema? Não. O prompt de sistema define o papel geral do agente, o tom e as regras permanentes, enquanto um arquivo de habilidade guarda um único procedimento com seu gatilho, etapas, escopo de ferramentas, pontos de aprovação e checagem de conclusão. O harness pode carregar uma habilidade apenas quando surge uma tarefa correspondente, o que mantém o contexto permanente do agente mais enxuto. Os dois devem ser revisados, mas mudam por motivos diferentes e não devem ser unidos.

Preciso de uma plataforma específica para usar arquivos de habilidade? Não necessariamente. O formato é um documento, então o requisito real é um harness que consiga carregar o arquivo para tarefas correspondentes, registrar qual versão foi executada e fazer valer o escopo de ferramentas declarado no arquivo. Se você constrói essa camada internamente ou usa um produto existente é uma decisão separada, e depende de quanto do trabalho operacional a sua equipe quer manter sob responsabilidade própria.

Quantos arquivos de habilidade uma empresa deve começar a usar? Comece com um, no máximo dois. Escolha um procedimento que se repete, tem um fim claro e produz um resultado visível quando dá errado. Criar vários arquivos antes de testar o primeiro com casos reais dificulta descobrir qual deles causou um problema.

Quem deve ser responsável por um arquivo de habilidade? Uma pessoa nomeada da equipe que executa o procedimento deve ser a responsável, e não apenas a equipe técnica. O responsável aprova as mudanças, explica a intenção por trás de cada etapa e decide quando o arquivo deve ser aposentado. O lado técnico mantém as ferramentas, credenciais e permissões que o arquivo referencia.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.