Workspaces
Como um workspace é criado, o que dá para configurar nele, como trocar de workspace e o que acontece ao sair ou excluir.
O workspace, que o app chama de espaço de trabalho, é o espaço da sua equipe. Membros, agentes, projetos, tarefas, runtimes e configurações pertencem a um workspace e não aparecem em outro. Uma pessoa pode participar de vários workspaces e alternar entre eles.
Como um workspace é criado
Workspaces são criados só pela administração da plataforma. Não existe botão "Criar espaço de trabalho" no app, e jiraya workspace create é sempre recusado pelo servidor.
Para ter um workspace novo, peça a quem administra a plataforma. Ao criar, a administração informa o e-mail de quem vai administrá-lo:
- se essa pessoa já tem conta, ela entra no workspace como proprietária;
- se não tem, recebe um convite de proprietária por e-mail, válido por 7 dias.
Para entrar num workspace que já existe, peça um convite a um administrador dele. Veja Membros e papéis.
Endereço e identificador
Cada workspace tem um slug, o identificador que aparece no endereço: app.jiraya.io/acme. O slug aceita letras minúsculas, números e hifens e não pode ser alterado depois da criação.
Na CLI, os comandos que recebem um workspace aceitam o ID, o slug ou o início do ID.
Configurações gerais
Em Configurações › Geral, proprietários e administradores editam:
| Campo | Para que serve |
|---|---|
| Nome e Logo | Como o workspace aparece no seletor e no cabeçalho. |
| Descrição | Um resumo do workspace para quem entra. |
| Contexto | Informações sobre a equipe e o trabalho, entregues aos agentes do workspace. |
| Prefixo de tarefa | O início do identificador das tarefas, como ACME em ACME-42. Aceita de 1 a 10 caracteres, entre letras de A a Z e números. |
| Idioma do espaço de trabalho | O idioma das mensagens do sistema escritas nas tarefas, como os avisos de despertar. Não muda o idioma da interface, que cada pessoa escolhe nas preferências. |
Trocar o prefixo renumera as tarefas
Ao mudar o prefixo, todas as tarefas do workspace passam a usar o novo prefixo: ACME-42 vira NOVO-42. O app pede confirmação antes de salvar.
Pela CLI, o mesmo ajuste é feito com jiraya workspace update:
jiraya workspace update acme --name "Acme" --issue-prefix ACMEO comando aceita --name, --description, --context e --issue-prefix. O slug e o idioma não mudam pela CLI.
Trocar de workspace
No app, abra o seletor no topo da barra lateral e escolha outro workspace em Espaços de trabalho. Convites pendentes aparecem no mesmo seletor, com as opções Entrar e Recusar.
Na CLI, liste os seus workspaces e defina o padrão do perfil:
jiraya workspace listjiraya workspace switch acmePara um único comando, use --workspace-id ou a variável JIRAYA_WORKSPACE_ID em vez de trocar o padrão.
Sair de um workspace
Qualquer membro pode sair em Configurações › Geral › Zona de risco › Sair do espaço de trabalho. O workspace precisa manter ao menos um proprietário: se você for o único, promova outra pessoa a proprietária antes de sair ou exclua o workspace.
Ao sair, os runtimes que você registrou deixam de atender o workspace, e os agentes que rodavam neles são arquivados.
Excluir um workspace
Só proprietários veem Excluir espaço de trabalho. Para confirmar, digite o nome do workspace exatamente como ele aparece, com as mesmas maiúsculas e minúsculas.
A exclusão é definitiva
Excluir apaga tarefas, comentários, projetos, agentes, chats e o histórico de execuções do workspace. Não há lixeira nem como desfazer.
Comandos da CLI
| Comando | O que faz |
|---|---|
jiraya workspace list | Lista os workspaces de que você participa. |
jiraya workspace get [workspace] | Mostra os detalhes de um workspace. |
jiraya workspace update [workspace] | Atualiza nome, descrição, contexto e prefixo. Exige proprietário ou administrador. |
jiraya workspace switch <workspace> | Define o workspace padrão do perfil. |
jiraya workspace member list | Lista os membros. |
jiraya workspace member invite <email> | Convida alguém por e-mail. |
Sair, excluir, mudar papéis e remover membros são feitos só pelo app.
Atualizado em