Configurações
O diálogo Settings é onde você conecta a IA deste projeto e escolhe como os rótulos dos comandos do Raaghu Spec Kit aparecem. Abra pelo menu hamburger do Raaghu Spec Kit (canto superior direito) → Settings.
Quem pode abrir Settings
O item Settings no menu aparece apenas para:
| Função | Grupo no Azure DevOps | O que pode fazer em Settings |
|---|---|---|
| Administrador da organização | Project Collection Administrators (admin da org) | LLM Settings e Commands Mapping completos; pode gerenciar Project LLM e Raaghu AI do projeto |
| Administrador do projeto | [Project]\Project Administrators | O mesmo acesso ao Settings da extensão no projeto atual — Project LLM e Raaghu AI (quando Organization Settings permitir essas fontes) |
Usuários comuns do hub não veem Settings no menu hamburger. Peça a um administrador do projeto ou da organização para configurar a IA do projeto.
Cobrança, seats, chaves de licença e Configurations em toda a org ficam em Azure DevOps → Organization settings → Raaghu Spec Kit e continuam exclusivos de administradores da organização. Consulte Organization Settings.
Dois “Organization Settings” diferentes
| Nome no produto | Onde | Finalidade |
|---|---|---|
| Settings (menu hamburger) | Dentro do hub do Raaghu Spec Kit | Project LLM, Raaghu AI e Commands Mapping do projeto atual |
| Organization settings → Raaghu Spec Kit | Configurações da organização no Azure DevOps | Assinatura, seats, Configurations, chaves de licença e créditos |
Esta página cobre apenas o diálogo Settings dentro da extensão.
Abas
| Aba | Finalidade | Quem pode usar |
|---|---|---|
| LLM Settings | Chaves Project LLM e Raaghu-hosted AI deste projeto | Administradores da org e Project Administrators (alguns toggles dependem das permissões em Configurations) |
| Commands Mapping | Como os comandos do Raaghu Spec Kit aparecem no dropdown do chat | Administradores da org e Project Administrators |
Trazer sua própria chave vs IA hospedada no Raaghu
- Bring your own key (BYOK) — forneça credenciais do Azure OpenAI, OpenAI ou Claude para este projeto, ou use conexões atribuídas por um admin em Configurations. Você paga ao provedor diretamente.
- Raaghu-hosted AI — habilite Raaghu AI na aba LLM Settings para usar os créditos Raaghu da organização. Project LLM e Raaghu AI podem ficar On ao mesmo tempo quando Organization Settings permitir essas fontes; escolha o modelo ativo no rodapé do chat.
Forma mais rápida de desbloquear o chat
- Se um admin já atribuiu conexões LLM da org ou habilitou Raaghu AI neste projeto → deixe Project LLM Off e use o caminho org / hosted.
- Caso contrário, ligue Project LLM, adicione um provedor, salve e defina-o como Default.
- Se o chat ainda mostrar "LLM is not configured", peça a um admin da organização para configurar conexões em Configurations, habilitar Use Project Key ou Use Raaghu AI no projeto, ou completar Raaghu AI credits.
LLM Settings
A aba LLM Settings tem duas seções: Project LLM setting e Raaghu AI.
Project LLM setting
Um toggle controla se este projeto usa credenciais BYOK próprias:
- Off — o projeto usa conexões LLM da organização atribuídas por um administrador (quando Use Organization Key é permitido no projeto).
- On — você pode adicionar credenciais específicas do projeto aqui.
O Project LLM pode aparecer desabilitado com uma mensagem como "Custom project LLM settings are not enabled for this project. Contact your organization admin." Um admin da org habilita em Organization settings → Raaghu Spec Kit → Configurations → Project (Use Project Key).
Com o toggle On, clique em + para adicionar uma configuração:
| Campo | Observações |
|---|---|
| Title | Nome desta configuração |
| AI Provider | Azure OpenAI, OpenAI ou Claude (Anthropic) |
| Model | Catálogo ou nome custom. Azure OpenAI / OpenAI incluem GPT-5.6 Sol (recomendado), GPT-5.5, GPT-5.4, GPT-4.1 e GPT-4o. Claude inclui Sonnet 5 (recomendado), Opus 5, Fable 5 e Haiku 4.5. Multi-select e nomes custom são suportados |
| Endpoint | Obrigatório para Azure OpenAI (e conforme o provedor) |
| API Version | Somente Azure OpenAI (por exemplo, 2024-10-21) |
| API Key | Chave de API do seu provedor |
| Expiration | 7, 30, 60 ou 90 dias, uma data custom, ou sem expiração |
Você pode adicionar várias configurações e marcar uma como Default. As credenciais são criptografadas. Estado vazio: "No Project LLM configurations found. Click '+' to add one."
Raaghu AI
A seção Raaghu AI aparece quando a organização pode usar créditos de IA hospedada.
- Toggle On / Off — liga ou desliga a IA hospedada neste projeto (admins da org e project admins quando Use Raaghu AI é permitido)
- Credit balance — saldo atual de IA hospedada da organização
- Model — modelo hospedado a usar
- Top up Raaghu AI credits — abre o hub de cobrança para adicionar saldo (caminho do admin da org)
Se o admin da org não permitiu Raaghu AI neste projeto, o toggle fica desabilitado e você vê "Raaghu AI is not enabled for this project. Contact your organization admin."
Somente administradores da organização alteram permissões no nível da org e fazem top-up de Raaghu AI credits. Top-ups: Organization Settings.
Conexões em toda a organização (chaves compartilhadas atribuídas a projetos) são gerenciadas em Organization Settings → Configurations, não neste diálogo.
Commands Mapping
A aba Commands Mapping controla como os comandos do Raaghu Spec Kit aparecem no dropdown Command do chat. O toggle Spec Kit / Default alterna o modo de exibição:
- Default — nomes amigáveis (por exemplo, "Create Specification")
- Spec Kit — IDs técnicos (por exemplo,
speckit.constitution)
Se o dropdown mostrar "Create Specification", isso é o mesmo que /speckit.specify. Os rótulos são somente leitura. Alterar o toggle salva imediatamente.
Os comandos mapeados são: constitution, specify, clarify, plan, tasks, analyze, checklist e converge.
