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 o checkout do Stripe (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 |
| Iniciar trial, assinar, ativar chaves de licença, ajustar seats, adicionar créditos, gerenciar faturamento | Azure DevOps → Organization settings → Raaghu Spec Kit |
| Aprovar ou negar usuários de primeira vez | Access Requests no cabeçalho do Raaghu Spec Kit |
| Atribuir ou remover seats | Organization settings → Raaghu Spec Kit → Users |
| Definir chaves de IA compartilhadas da org / habilitar Raaghu-hosted AI | Hamburger do Raaghu Spec Kit → Settings |
Os membros só podem autorizar e usar o hub após a aprovação de acesso (quando exigida) e a atribuição de um seat.
Etapas
1. Instalar a extensão
- Abra a listagem do Raaghu Spec Kit → 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.
- No menu esquerdo, selecione Raaghu Spec Kit.
Você deve ver as abas: Subscription, Users, License Keys, Credits e Usage.
Este hub de faturamento é separado do diálogo Settings dentro da extensão (menu hamburger), usado para chaves de IA e rótulos de comandos. 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 Trial summary 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 conclua o checkout (Professional Plan — US$ 9 por seat / mês). Se você tiver um código promocional, digite-o na página de checkout do Stripe. 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 com checkout pago ou uma chave de licença. Se Choose Your Plan / Start Free Trial não aparecer, a org não é elegível para trial — use checkout pago ou uma chave de licença.
Veja os detalhes em Organization Settings.
4. Aprovar solicitações de acesso
- Quando os usuários autorizam pela primeira vez, eles podem enviar uma solicitação de acesso.
- Abra Access Requests no cabeçalho do Raaghu Spec Kit.
- Approve ou Deny cada solicitação.
Detalhes: Access Requests.
5. Atribuir seats
- Abra Organization settings → Raaghu Spec Kit → Users.
- Em Available to assign, clique em Assign seat para cada pessoa que deve usar o Raaghu Spec Kit.
- Atribua um seat a si mesmo se for usar o hub.
Importante: A aprovação sozinha não é suficiente — os usuários também precisam de um seat atribuído.
6. Financiar a IA (opcional, mas recomendado)
- BYOK: No hub do Raaghu Spec Kit, hamburger → Settings → aba Organization Settings — adicione credenciais compartilhadas do provedor para projetos que usam o modo Admin.
- Hosted AI: Adicione créditos na aba Subscription do hub de faturamento e, em seguida, habilite a Raaghu-hosted AI na aba AI Settings da extensão. Defina limites de gasto na aba Credits, se necessário.
Dica de nomenclatura: a aba Organization Settings dentro da extensão é para chaves de IA compartilhadas. O hub Organization settings → Raaghu Spec Kit do Azure DevOps é para faturamento e seats.
7. 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