Tutorial completo

Este tutorial acompanha uma tarefa do começo ao fim. Você entra num workspace vazio, conecta a sua máquina, cria um agente, entrega uma tarefa a ele e revisa o resultado. Ao final, a tarefa estará em done (Concluído), com o trabalho do agente registrado nela.

O Início rápido cobre a parte da CLI em menos passos. Aqui cada etapa é explicada, com o que aparece na tela.

1. Entre no workspaceCopiar link da seção

Abra o convite que chegou por e-mail, entre em app.jiraya.io e clique em Aceitar e entrar. O convite de quem vai ser proprietário de um workspace novo vale por 7 dias.

Depois de aceitar, o Jiraya abre a integração inicial direto na etapa Conheça a Yara, que conecta uma máquina ao workspace.

2. Conecte a sua máquinaCopiar link da seção

Os agentes não rodam nos servidores do Jiraya: eles usam a ferramenta de IA de uma máquina conectada ao workspace, que o app chama de ambiente de execução.

Na etapa Conecte um computador aos seus agentes, escolha Conectar pelo terminal e depois Mostrar passos. O app mostra os dois comandos para o seu sistema. No macOS ou no Linux:

$curl -fsSL https://api.jiraya.io/install.sh | bash

No Windows, pelo PowerShell:

>irm https://api.jiraya.io/install.ps1 | iex

Depois, conecte a máquina ao workspace, trocando acme pelo identificador do seu, o trecho do endereço logo depois de app.jiraya.io/:

$jiraya setup --workspace acme

O setup abre o navegador para você aprovar o login, inicia o daemon e registra cada ferramenta de IA encontrada como um ambiente de execução. Em 10 a 30 segundos a máquina aparece na tela de integração.

3. Conheça a YaraCopiar link da seção

Com a máquina conectada, a tela pergunta Onde a Yara deve rodar?. Escolha um dos ambientes de execução da lista e clique em Começar com a Yara.

A Yara é o agente padrão de todo workspace: uma chefe de gabinete que transforma objetivos em tarefas e distribui o trabalho entre os agentes. Ela é criada nesse momento, no ambiente que você escolheu, e o app abre o chat com ela. Veja Agentes.

Para conferir a conexão pelo terminal:

$jiraya daemon status

O status deve ser running, com ao menos uma ferramenta de IA na lista e o seu workspace na linha Workspaces.

4. Crie um agenteCopiar link da seção

Neste tutorial você entrega a tarefa a um agente criado para ela. Em Agentes, clique em Novo agente e preencha:

• Nome: por exemplo, "Redator".
• Acesso: Privado, para que só você possa acioná-lo.
• Ambiente: o ambiente de execução da sua máquina.
• Instruções: o que o agente faz, por exemplo "Você escreve documentação técnica curta e objetiva. Ao terminar, comente o resultado na tarefa."

Clique em Criar. Os demais campos estão em Criar e configurar.

5. Crie a tarefaCopiar link da seção

No quadro, clique em Nova tarefa. Escreva um título e uma descrição com o pedido e o que conta como pronto, por exemplo "Liste os arquivos de configuração do repositório e explique para que serve cada um, numa tabela".

Dois campos decidem o que acontece depois:

• Status: toda tarefa nova começa em backlog (Backlog), e uma tarefa em Backlog não aciona ninguém. Escolha todo (A Fazer) para que o agente comece assim que receber a tarefa.
• Revisor: vem preenchido com você, quem criou a tarefa. Mantenha assim para revisar a entrega.

6. Atribua a tarefa ao agenteCopiar link da seção

No campo Responsável, escolha o agente que você criou. O seletor separa pessoas, agentes e equipes.

Ao salvar, o agente é acionado e uma execução começa no seu ambiente de execução. A atividade da tarefa registra a atribuição. Pela CLI, o mesmo pedido fica assim:

$jiraya issue create --title "Documentar arquivos de configuração" --status todo --assignee "Redator"

7. Acompanhe a execuçãoCopiar link da seção

Abra a tarefa. O agente lê a descrição e os comentários, trabalha na sua máquina e publica o resultado num comentário. O registro de execução da tarefa mostra cada execução e a origem dela, como Execução inicial.

No terminal, acompanhe o daemon enquanto o agente trabalha:

$jiraya daemon logs -f

8. Receba a entregaCopiar link da seção

Ao terminar, o agente move a tarefa para in_review (Em revisão). Se ele terminar sem mudar o status, o Jiraya faz a troca sozinho. No quadro, o cartão aparece na coluna Em revisão.

Como revisor, você recebe na Caixa de entrada o aviso Revisão solicitada, e a tarefa ganha um comentário do sistema. Veja Revisão de entregas.

9. Revise e concluaCopiar link da seção

Leia o comentário do agente e confira o resultado. Você decide pelo status da tarefa:

• Aprovar: mude o status para done (Concluído).
• Pedir ajustes: escreva um comentário na tarefa explicando o que mudar. Um comentário numa tarefa atribuída ao agente o aciona de novo, e ele volta a trabalhar com o seu pedido. Quando terminar, a tarefa volta para Em revisão.

Com a tarefa em Concluído, o ciclo está completo: a tarefa guarda o pedido, a execução, a entrega e a sua decisão no histórico.

Próximos passosCopiar link da seção