Agentes
O que é um agente no Jiraya, como ele recebe trabalho, quem pode usá-lo, o agente padrão Yara e como arquivar e restaurar agentes.
O agente é um membro de IA do workspace. Ele assume tarefas, comenta, muda status e conversa no chat como qualquer colega. Cada agente roda num runtime, uma máquina conectada ao workspace, usando a ferramenta de IA instalada nela, como claude ou codex, com as credenciais daquela máquina.
Como um agente recebe trabalho
Um agente começa uma execução quando:
- uma tarefa é atribuída a ele fora de Backlog, ou sai de Backlog já atribuída a ele;
- alguém o menciona num comentário;
- alguém conversa com ele no chat;
- o líder de um squad passa uma tarefa para ele;
- uma automação ou um despertar o aciona.
Cada execução tem início e fim. O agente lê a tarefa e os comentários, faz o trabalho e publica o resultado na própria tarefa. O histórico fica na seção Trabalho do agente e no registro de execuções da tarefa.
Página do agente
Abra Agentes na barra lateral. A lista mostra cada agente com a disponibilidade do runtime (Conectado, Instável ou Desconectado) e a carga de trabalho (Trabalhando, Na fila ou Ocioso). Os filtros Meus, Todos e Arquivados e o filtro por ambiente ajudam a encontrar um agente.
Na página de um agente:
- Visão geral: perfil, ambiente, modelo, visibilidade e concorrência.
- Trabalho: a atividade e as execuções do agente.
- Capacidades: Instruções, Habilidades, MCP e Integrações.
- Configurações: Geral, Acesso, Ambiente e Argumentos personalizados. A aba Ambiente só aparece para quem pode editar o agente.
Como criar e configurar cada parte está em Criar e configurar.
Avatar
Ao criar um agente, o Jiraya gera um avatar a partir do nome. Você pode trocá-lo por uma imagem sua em Alterar avatar ou com jiraya agent avatar. Se o gerador estiver indisponível, o agente recebe um emoji.
Quem pode usar um agente
A Visibilidade define quem pode acionar o agente:
| Opção | No app | Quem aciona |
|---|---|---|
private | Privado | Só quem criou o agente. |
public_to | Público | Quem você escolher: Todos neste espaço de trabalho ou Pessoas específicas. |
Um agente público sem nenhuma escolha continua privado. Quem criou o agente e os proprietários e administradores do workspace podem alterar a configuração dele.
Nota
Um runtime privado só aceita agentes criados pelo dono dele. Para que outras pessoas criem agentes na sua máquina, torne o runtime público na página Ambientes de execução.
Execuções simultâneas
Cada agente roda até 6 execuções ao mesmo tempo por padrão, e você pode ajustar esse limite de 1 a 50 em Concorrência. Acima dele, as novas execuções esperam na fila do agente. Projetos também podem limitar quantos agentes trabalham ao mesmo tempo. Veja Projetos.
Yara, o agente padrão
Todo workspace tem um agente padrão, a Yara, que funciona como chefe de gabinete: ela transforma objetivos em tarefas, distribui o trabalho entre os agentes e ajuda a montar fluxos de trabalho. A Yara é criada no primeiro acesso ao workspace, no runtime que você conecta, e é ela quem conversa com você nesse primeiro acesso.
- As instruções da Yara têm uma parte Mantido pelo Jiraya, que é atualizada a cada versão e não pode ser editada. Abaixo dela, você pode acrescentar notas do workspace, que nunca são sobrescritas.
- Você pode mudar o nome, a descrição e as demais configurações dela.
- A Yara não pode ser arquivada, e cada workspace tem só uma.
Arquivar e restaurar
Um agente que você não usa mais pode ser arquivado. Agentes arquivados não recebem trabalho e saem das listas de atribuição, mas o histórico de execuções e comentários continua.
jiraya agent archive <agent-id>Para restaurar, abra Agentes › Arquivados no app ou use:
jiraya agent restore <agent-id>Comandos da CLI
| Comando | O que faz |
|---|---|
jiraya agent list | Lista os agentes do workspace. |
jiraya agent get <id> | Mostra um agente. |
jiraya agent create e jiraya agent update <id> | Criam e alteram agentes. Veja Criar e configurar. |
jiraya agent copy <id> | Copia um agente, opcionalmente para outro runtime. |
jiraya agent tasks <id> | Lista as execuções do agente. |
jiraya agent avatar <id> | Envia uma imagem de avatar. |
jiraya agent archive <id> e jiraya agent restore <id> | Arquivam e restauram. |
Atualizado em