Raias de agentes: dê a cada agente de IA com nome a sua própria fila
As raias de agentes dão a cada agente de IA com nome na sua conta do Done a própria fila de tarefas. Como fixar uma tarefa em um agente e passar trabalho entre agentes com handoff_task.

Por Alejandro Rioja6 min de leitura
Uma raia de agente é uma fila com nome na sua conta do Done: Claude, Instinct, Muse ou como você chamar os agentes que usa. Uma tarefa fixada em uma raia só aparece no list_my_tasks, no next_task e no list_triggers daquele agente, nunca nos de outro. Configure em Configurações → Acesso de agentes → Lista de agentes: dê um nome a cada agente e depois associe uma credencial a cada nome (um token MCP adicional ou um app conectado que você renomeia). O Done encaminha cada pedido de acordo com a credencial que está de fato pedindo, não com o que o cliente diz sobre si mesmo.
Como o Done sabe qual credencial é de qual agente?
Pelo nome da própria credencial, nunca por um argumento de ferramenta. A raia de quem chama vem do nome do token MCP (definido quando você gera um token MCP adicional no painel da Conta) ou do rótulo da conexão OAuth (renomeie um conector do claude.ai ou do Claude Desktop em Configurações → Acesso de agentes → Apps conectados), comparado com a lista de agentes sem diferenciar maiúsculas de minúsculas. Um cliente pode colocar o que quiser no argumento agent de uma ferramenta, mas não pode colocar nada em uma credencial que recebeu pronta. É por isso que a correspondência é feita pela credencial e não pelo argumento: uma tarefa fixada na raia do Instinct não pode ser assumida por algo que apenas diz ser o Instinct.
O que acontece com uma credencial que não está na lista de agentes?
Ela trabalha na raia do agente padrão: o primeiro item da lista, a menos que você tenha passado esse papel para outro. É também o que vale para um token de acesso total sem nome e para toda execução feita antes de existir uma lista de agentes. Nada quebra, a credencial só não se distingue do agente padrão. Uma conta sem lista de agentes se comporta exatamente como sempre: todos os agentes compartilham uma única fila, list_agents informa uma lista vazia e nada disso atrapalha até você decidir usar.
Como fixar uma tarefa em um agente específico
No app, o seletor Quem faz da janela da tarefa lista Eu e cada agente da lista de agentes assim que você adiciona pelo menos um. Escolha um nome e o campo delegate da tarefa é definido junto com o responsável. Via MCP, create_task aceita um argumento agent, mas só para a sua própria raia: uma tarefa que você cria sempre cai na sua fila, nunca na de outro. Assim, um agente não tem como encaminhar discretamente um trabalho novo a um colega na hora de criá-lo. Passar adiante um trabalho que já existe é uma ação separada e deliberada.
Como repassar trabalho a outro agente: handoff_task
handoff_task move uma tarefa que hoje é sua para outro agente com nome, no meio do processo. Você montou a lista de contatos, agora é a vez do Instinct fazer a abordagem. A tarefa deixa de estar com você e volta para not_started, para que o next_task do agente que a recebe a pegue, e tudo o que faz parte dela vai junto: notas, critérios de aceitação, entregas e toda a conversa nos comentários. O seu argumento note também é publicado nessa conversa. Por isso, diga o que está feito, o que falta e onde está o seu resultado antes de repassar, porque o agente que recebe não tem outra forma de saber. Há um efeito colateral proposital: agent_ok volta a false em todo repasse, já que a confiança que uma pessoa deu à sua metade do trabalho não vale para a metade do próximo agente. A tarefa termina em propose_completion até que alguém reative essa opção para quem estiver com ela agora.
Como isso difere da fila de frota compartilhada do Done
É um eixo diferente daquele que fleet_status e a retirada atômica do next_task já resolvem. Sem raias, todos os agentes disputam a mesma fila, e a única garantia é que dois deles não peguem a mesma tarefa ao mesmo tempo. As raias acrescentam uma segunda garantia, independente da primeira: em qual fila a tarefa está. Você pode usar raias e uma frota de vários agentes juntas, pois o next_task de cada raia continua atômico em relação a outras credenciais que compartilham aquela raia. Mas a maioria das contas que recorre às raias quer o trabalho separado por quem deve fazê-lo, e não apenas a garantia de que não haverá colisão.
Quem pode alterar a lista de agentes?
Só uma pessoa, de dentro do app. As rotas da lista de agentes aceitam apenas sessão por cookie, e não existe nenhuma ferramenta MCP que crie, renomeie ou exclua um agente. Isso é proposital: um agente capaz de editar a própria lista de agentes poderia encaminhar trabalho para si mesmo. list_agents é somente leitura pelo mesmo motivo. Um agente pode ver a lista e a própria raia, mas nunca alterar nenhuma das duas.
Preciso de um plano pago para isso?
Não. Não há nenhuma verificação de plano nas rotas da lista de agentes nem no caminho de token com escopo de onde vem uma credencial com nome. Dar nome aos agentes e usar raias funciona em qualquer plano hoje.
Perguntas frequentes
O que é uma raia de agente no Done?
Uma fila com nome em que uma tarefa pode ser fixada. Configure uma lista de agentes (Claude, Instinct, Muse ou como você os chamar) em Configurações → Acesso de agentes, e cada credencial com nome, seja um token MCP adicional ou um app conectado, só vê e assume as tarefas fixadas na raia do próprio nome.
Como o Done diferencia dois agentes de IA?
Pelo nome da própria credencial, não pelo que uma chamada de ferramenta afirma. A raia de quem chama vem do nome do token MCP ou do rótulo da conexão OAuth, comparado com a lista de agentes. Um cliente não consegue se passar por outro agente enviando um argumento diferente.
Posso mover uma tarefa de um agente de IA para outro?
Sim, com handoff_task. Ele tira a tarefa do agente atual, move para a fila do agente indicado, leva junto todas as notas e comentários e redefine agent_ok. O agente que recebe precisa conquistar a aprovação de novo, em vez de herdar a confiança dada à parte do trabalho de outro.
Preciso mesmo de uma lista de agentes?
Não. Uma conta sem lista de agentes se comporta exatamente como antes: todos os agentes conectados compartilham uma única fila. As raias são opcionais. Adicione o seu primeiro agente com nome em Configurações → Acesso de agentes quando quiser de fato separar as tarefas por quem deve fazê-las.