Pular para o conteúdo principal
Versão: v3.2.0

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​

TarefaOnde
Instalar a extensãoVisual Studio Marketplace — Raaghu Spec Kit
Iniciar trial, assinar, ativar chaves de licença, ajustar seats, adicionar Raaghu AI credits, gerenciar faturamentoAzure DevOps → Organization settings → Raaghu Spec Kit
Aprovar ou rejeitar usuários de primeira vezOrganization settings → Raaghu Spec Kit → Users → Pending requests
Atribuir ou remover seatsOrganization settings → Raaghu Spec Kit → Users → Assigned users / Available to assign
Definir conexões LLM da org e permissões de IA por projetoOrganization settings → Raaghu Spec Kit → Configurations
Habilitar Raaghu AI / LLM do projeto (após permissões da org)Hamburger do Raaghu Spec Kit → Settings → LLM Settings (administradores da organização e Project Administrators)

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​

  1. Abra a listagem do Raaghu Spec Kit no Visual Studio Marketplace.
  2. Clique em Get → selecione sua organização → Install.
  3. Confirme em Organization settings → Extensions → Installed.

Detalhes: Instalação e abertura.

2. Abrir o hub de faturamento​

  1. No Azure DevOps, abra Organization settings.
  2. No menu esquerdo, selecione Raaghu Spec Kit.

Você deve ver as abas: Subscription, Users, Configurations, License Keys e Raaghu AI Credits.

Este hub é separado do diálogo Settings dentro da extensão (menu hamburger), que administradores da organização e Project Administrators usam para chaves LLM do projeto, Raaghu AI do projeto atual e rótulos de comandos. As conexões da organização ficam em Configurations. Detalhes: Organization Settings.

3. Iniciar trial, assinar ou ativar uma chave de licença​

Escolha um caminho no hub de faturamento:

  1. 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.
  2. 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.
  3. 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​

  1. Quando os usuários autorizam pela primeira vez, eles podem enviar uma solicitação de acesso.
  2. Abra Organization settings → Raaghu Spec Kit → Users → Pending requests.
  3. Approve ou Reject cada solicitação (ou selecione várias e use Approve selected).

Detalhes: Access Requests.

5. Atribuir seats​

  1. Permaneça em Organization settings → Raaghu Spec Kit → Users.
  2. Abra Available to assign e clique em Assign seat para cada pessoa que deve usar o Raaghu Spec Kit.
  3. 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. 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:

  1. Chaves da organização — Em Configurations → Organization, clique em + Add LLM para adicionar uma conexão compartilhada do Azure OpenAI, OpenAI ou Claude. Em Configurations → Project, abra um projeto, ative Use Organization Key e atribua conexões em Assign AI Services.
  2. Chaves do projeto — Em Configurations → Project, abra um projeto e ative Use Project Key. Um admin do projeto pode então adicionar chaves em hamburger → Settings → LLM Settings.
  3. Raaghu AI — Em Configurations → Project, ative Use Raaghu AI. Se usar modelos hospedados, adicione créditos em Subscription ou Raaghu AI Credits. Os usuários então habilitam Raaghu AI em Settings → LLM Settings. Limites de gasto opcionais ficam em Raaghu AI Credits.

Azure DevOps Organization settings → Raaghu Spec Kit é para faturamento, seats e Configurations da organização. O diálogo Settings dentro da extensão é para o toggle LLM do projeto atual, Raaghu AI e Commands Mapping.

7. Testar um projeto​

  1. Abra um projeto → Raaghu Spec Kit.
  2. Inicialize o Raaghu Spec Kit uma vez.
  3. Confirme que o chat consegue enviar uma mensagem (IA conectada).
  4. Opcionalmente, execute Sua primeira Feature.

Próximos passos​