Configuração do administrador
Use esta checklist se você for um administrador da organização. Você instalará o Raaghu Spec Kit, assinará, aprovará usuários, atribuirá seats e definirá os padrões de IA no nível da organização para que a equipe possa trabalhar.
Pré-requisitos
- Direitos de administrador da organização no Azure DevOps
- Capacidade de instalar extensões do marketplace
- Acesso de faturamento para pagar com cartão (assinatura e créditos), ou uma chave de licença emitida para a organização
O que só administradores podem fazer
| Tarefa | Onde |
|---|---|
| Instalar a extensão | Visual Studio Marketplace — Raaghu Spec Kit |
| Iniciar trial, assinar, ativar chaves de licença, ajustar seats, adicionar Raaghu AI credits, gerenciar faturamento | Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit |
| Aprovar ou rejeitar usuários de primeira vez | Organization settings → Extensions → Raaghu Spec Kit → Users → Pending requests (aprovar também atribui um seat) |
| Atribuir ou remover seats | Organization settings → Extensions → Raaghu Spec Kit → Users → Users |
| Definir conexões de IA da org e permissões por projeto | Organization settings → Extensions → Raaghu Spec Kit → AI Settings |
| Habilitar Raaghu AI ou IA do projeto (após permissões da org) | Menu do Raaghu Spec Kit → Settings → LLM Settings (administradores da organização e Project Administrators) |
Os membros podem autorizar e usar o Raaghu Spec Kit após a aprovação de acesso (quando exigida). Aprovar uma solicitação pendente também atribui um seat.
Etapas
1. Instalar a extensão
- Abra a listagem do Raaghu Spec Kit no Visual Studio Marketplace.
- Clique em Get → selecione sua organização → Install.
- Confirme em Organization settings → Extensions → Installed.
Detalhes: Instalação e abertura.
2. Abrir o hub de faturamento
- No Azure DevOps, abra Organization settings.
- Em Extensions no menu esquerdo, selecione Raaghu Spec Kit.
No Azure DevOps Server (local), abra o mesmo hub em Collection settings → Extensions → Raaghu Spec Kit.
Você deve ver as abas: Subscription, Users, AI Settings e License Keys.
Esta página fica em Organization settings do Azure DevOps. Não é o mesmo que o menu → Settings dentro do Raaghu Spec Kit, que administradores da organização e Project Administrators usam para chaves de IA do projeto, Raaghu AI do projeto atual e rótulos de comandos. As conexões da organização ficam em AI Settings. Detalhes: Organization Settings.
3. Iniciar trial, assinar ou ativar uma chave de licença
Escolha um caminho no hub de faturamento:
- Trial gratuito (recomendado para orgs novas): Em Subscription, admins elegíveis veem Choose Your Plan. Selecione Free Trial e clique em Start Free Trial (up to 5 seats, no credit card required). Confirme que o selo do plano mostra Free Trial e que Subscription details lista Trial ends on.
- Assinatura paga: Em Choose Your Plan, selecione Paid, defina os seats, clique em Subscribe Now (ou use Subscribe for $…/month quando o trial não estiver disponível) e pague com cartão (US$ 9 por seat / mês). Se você tiver um código promocional, digite-o ao pagar com cartão. Confirme que o status mostra Active.
- Chave de licença: Em License Keys, digite uma chave (
RAAGHU-XXXX-XXXX-XXXX), visualize a prévia e clique em Confirm & activate. Subscription passa a mostrar o selo License key e Expires on.
Após o fim do trial, mantenha o acesso pagando com cartão ou ativando uma chave de licença. Se Choose Your Plan / Start Free Trial não aparecer, a org não é elegível para trial — pague com cartão ou ative uma chave de licença.
Veja os detalhes em Organization Settings.
4. Aprovar solicitações de acesso (atribui um seat)
- Quando os usuários autorizam pela primeira vez, eles podem enviar uma solicitação de acesso.
- Abra Organization settings → Extensions → Raaghu Spec Kit → Users → Pending requests.
- Approve ou Reject cada solicitação (ou selecione várias e use Approve selected). Confirme Approve and assign seat? — isso concede acesso e atribui um seat juntos.
- Para alterar seats depois, abra a subaba Users e use Assign / Unassign (ou em lote Assign selected / Unassign selected). Atribua um seat a si mesmo se for usar o hub.
Detalhes: Access Requests.
5. Conectar a IA (opcional, mas recomendado)
A equipe precisa de pelo menos uma fonte de IA antes de o chat e os Workflows funcionarem. Use uma ou mais destas opções:
- Chaves da organização — Em AI Settings → Organization, clique em Add AI connection para adicionar uma conexão compartilhada do Azure OpenAI, OpenAI ou Claude. Em AI Settings → Project, abra um projeto, ative Use organization AI e atribua conexões em Assign AI Services.
- IA do projeto — Em AI Settings → Project, abra um projeto e ative Use project AI. Um admin do projeto pode então adicionar chaves em menu do Raaghu Spec Kit → Settings → LLM Settings.
- Raaghu AI — Em AI Settings → Project, ative Use Raaghu AI. Se usar Raaghu AI, adicione créditos em Subscription ou AI Settings → Raaghu AI Credits. Os usuários então habilitam Raaghu AI em Settings → LLM Settings. Limites de gasto opcionais ficam em AI Settings → Raaghu AI Credits.
Azure DevOps Organization settings → Extensions → Raaghu Spec Kit é para faturamento, seats e AI Settings da organização. Dentro do Raaghu Spec Kit, Settings é para o toggle de IA do projeto atual, Raaghu AI e Commands Mapping.
6. Testar um projeto
- Abra um projeto → Raaghu Spec Kit.
- Inicialize o Raaghu Spec Kit uma vez.
- Confirme que o chat consegue enviar uma mensagem (IA conectada).
- Opcionalmente, execute Sua primeira Feature.
Próximos passos
- Compartilhe o Início rápido com sua equipe
- Sua primeira Feature
- Solução de problemas