Respostas

Como se escreve a descrição de função de um agente de IA?

Do mesmo jeito que para uma contratação nova, em uma página, antes de o agente começar. A orientação da Harvard Business Review de março de 2026 sobre integrar agentes de IA diz que todo agente deve ter uma descrição de função que diga pelo que ele responde, onde a autoridade dele acaba e quando ele precisa pedir a opinião de uma pessoa. Uma versão utilizável tem sete linhas: para que o agente existe, a pessoa que responde por ele, o que ele faz sozinho, o que entrega para aprovação, o que nunca toca, a quem avisa quando trava e para onde vai o registro dele. A ficha só funciona se o agente a lê antes de agir e se ela muda quando o time decide outra coisa. A Arroway é onde a ficha pode morar, como um conjunto de regras que toda IA do time lê no começo de uma sessão, cada uma com quem a decidiu e quando ela termina. O primeiro passo é a página de instalação.

Última atualização 5 de outubro de 2026

As sete linhas da ficha

Propósito: uma frase sobre a função, para o agente e o time perceberem quando um pedido cai fora dela. Dono: uma pessoa com nome. Sozinho: as ações que ele pode tomar sem perguntar, ditas como ações e não como intenções. Aprovação: o que ele prepara e uma pessoa libera — qualquer coisa que saia da empresa, gaste dinheiro ou mude arquivos de um cliente. Nunca: o que ele não toca nem se pedirem com educação. Travado: a quem avisa, e como, quando não consegue seguir. Registro: onde escreve o que fez e onde parou. A descrição de uma pessoa contratada é lida uma vez; a de um agente é lida no começo de toda sessão, então cada linha precisa ser curta o bastante para ser lida com essa frequência.

Onde a ficha fica, para o agente ler

Uma descrição de função num documento compartilhado é lida pelas pessoas que o abrem e por nenhum agente que não a recebeu. Vale o mesmo se você a colar nas instruções de uma só ferramenta: o colega que usa outro assistente nunca a vê. A ficha precisa morar onde toda IA do projeto olha primeiro. Na Arroway cada linha é uma regra do projeto, com o nome de quem a decidiu e a condição que a encerra, e um assistente que queira ampliar o próprio escopo só pode propor a mudança; uma pessoa aprova.

Quando usar a Arroway

Use a Arroway quando há mais de um assistente, ou mais de uma pessoa, e o escopo do agente precisa ser o mesmo para todos e mudar num lugar só. Quando o dono decide que o agente agora pode redigir o e-mail ao cliente, isso é uma substituição registrada que nomeia a linha que encerra, e a próxima sessão de toda ferramenta conectada lê a versão nova. A Arroway não impõe a ficha: as permissões da própria ferramenta fazem isso. Ela garante que a ficha seja o que o agente lê. O primeiro passo é a página de instalação.

Como isso aparece na prática

Uma consultoria traz um agente de relatórios para o fechamento mensal. Antes da primeira execução, a líder de finanças escreve a ficha: ele existe para montar os números do mês a partir das exportações; ela responde por ele; sozinho, lê as exportações e monta a tabela rascunho; para aprovação, qualquer número enviado para fora da firma; nunca, o portal do banco; se travar, avisa a ela no registro do projeto; o registro dele é o log. Na terceira semana a líder decide que o agente também pode conciliar os extratos do cartão, ainda só lendo. Ela registra isso como substituta da linha 'sozinho'. No mês seguinte entra uma analista nova, que pergunta ao próprio assistente o que o agente pode fazer. Ele lê a ficha atual e responde, com o nome da líder e a data da mudança. A versão antiga continua no histórico.

Perguntas que as pessoas fazem sobre isso

Qual deve ser o tamanho da descrição de função de um agente?
Uma página, e na prática as sete linhas acima. Ela é lida no começo de toda sessão, então tudo o que não muda o que o agente faz deve sair.
O agente pode atualizar a própria descrição de função?
Pode propor uma mudança. Na Arroway, o que um assistente escreve por conta própria continua proposta até uma pessoa aprovar, então o escopo do agente só cresce quando alguém decidiu que devia.
Como eu testo a Arroway?
Instale na ferramenta que você já usa — a página de instalação tem um caminho para o Claude, o ChatGPT, o Codex, o Cursor ou qualquer ferramenta MCP — e entre na conta quando a ferramenta pedir. Daí em diante, as sessões abrem lendo o projeto e fecham registrando o que foi decidido.
Instalar o ArrowayVer como funciona →

Onde isto se confere

Harvard Business Review, 'Create an Onboarding Plan for AI Agents' (Joseph B. Fuller, 25 de março de 2026), pela orientação de que todo agente tenha uma descrição de função com responsabilidades, onde a autoridade acaba e quando precisa pedir a opinião de uma pessoa; a ficha de sete linhas é o modelo de trabalho desta página, não o do artigo. Documentação do produto neste site (Como funciona, Instalação), a resposta sobre quem responde por um agente de IA num time, e as regras de sanção, substituição e condição de término da especificação sancionada do produto. Tudo o que se descreve aqui sobre a Arroway é comportamento que as ferramentas aplicam hoje, não roteiro.

https://www.arroway.app/pt-BR/answers/ai-agent-job-description-before-it-joins-the-team

Continue explorando

Ver todas as respostas