Criar e configurar

Para criar um agente você precisa de ao menos um runtime conectado ao workspace e disponível para você. Se nenhum aparecer, conecte a sua máquina como mostra o Início rápido.

Criar pelo appCopiar link da seção

Para começar de um agente existente, use Duplicar agente: instruções, ambiente e habilidades são copiados para o novo agente.

Criar pela CLICopiar link da seção

--name e --runtime-id são obrigatórios. Liste os runtimes com jiraya runtime list.

$jiraya agent create --name "Revisor" --runtime-id <runtime-id> --model claude-sonnet-4-6 --instructions "Revise o código das tarefas em revisão." --public-to-workspace --permission-mode public_to

Para copiar um agente, inclusive para outro runtime:

$jiraya agent copy <agent-id> --runtime-id <outro-runtime-id> --model <modelo>

Ao trocar de runtime na cópia, informe --model (ou --model "" para usar o padrão do runtime). Variáveis de ambiente e configuração MCP próprias do agente nunca são copiadas.

Modelo, raciocínio e concorrênciaCopiar link da seção

Na Visão geral do agente:

• Modelo: o modelo usado pela ferramenta de IA, como claude-sonnet-4-6. Vazio usa o padrão do runtime. Na CLI, prefira --model a passar o modelo em --custom-args.
• Raciocínio: o nível de esforço, quando a ferramenta oferece, por exemplo low, medium ou high no Claude. Os valores aceitos dependem da ferramenta e do modelo.
• Concorrência: quantas execuções o agente roda ao mesmo tempo, de 1 a 50. O padrão é 6.

Variáveis de ambienteCopiar link da seção

Os agentes recebem as variáveis de ambiente do workspace, definidas por proprietários e administradores em Configurações › Variáveis de ambiente. Cada agente também pode ter as suas na aba Ambiente.

Quando a mesma chave existe nos dois lugares, o valor do agente vence, mesmo que esteja vazio.

A aba Ambiente só aparece para quem criou o agente e para proprietários e administradores, e toda leitura dos valores fica registrada. Pela CLI:

$jiraya agent env set <agent-id> --custom-env-file ./env.json

Prefira --custom-env-file ou --custom-env-stdin a --custom-env, para que os valores não fiquem no histórico do terminal.

SegredosCopiar link da seção

Valores sensíveis, como tokens de API, ficam em Configurações › Segredos, gerenciados por proprietários e administradores. Um segredo é cifrado e nunca é exibido de novo na tela. Se o valor aparecer no registro da execução ou nas memórias do agente, ele é ocultado; em comentários, tarefas, base de conhecimento e chat, não. Veja Segredos.

Para usar um segredo, referencie-o pelo nome como ${secret:NOME}:

• no valor de uma variável de ambiente do workspace, como Bearer ${secret:GITHUB_TOKEN};
• nos campos env e headers de um servidor MCP do workspace.

O valor real só é colocado no lugar da referência quando um agente começa a execução.

Servidores MCPCopiar link da seção

Servidores MCP dão ferramentas extras ao agente. Há dois caminhos:

• Biblioteca do workspace: proprietários e administradores cadastram servidores em Configurações › MCP, que podem usar segredos. Depois, cada agente recebe os servidores que deve usar na aba MCP.
• Configuração própria do agente: um JSON no formato {"mcpServers": {...}}, passado com --mcp-config-file.

$jiraya workspace mcp add github --server-config-file ./github-mcp.json

$jiraya agent mcp add <agent-id> <server-id>

Com jiraya agent mcp disable e enable, você desliga um servidor para um agente sem removê-lo.

Argumentos personalizadosCopiar link da seção

Em Argumentos personalizados, ou com --custom-args, você passa argumentos extras para a ferramenta de IA, como um array JSON. Use só para opções que não têm campo próprio.

Comandos da CLICopiar link da seção