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.

nota

Membros regulares do time não veem Settings. Se você não o vir, peça a um admin do projeto ou da organização para conectar a IA deste projeto. No produto, as conexões de IA podem aparecer rotuladas como LLM — isso significa o modelo ou provedor de IA.

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 AI Settings em toda a org ficam em Azure DevOps → Organization settings → Extensions → 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 → Extensions → Raaghu Spec Kit	Configurações da organização no Azure DevOps	Assinatura, seats, AI Settings, 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 AI deste projeto	Administradores da org e Project Administrators (alguns toggles dependem das permissões em AI Settings)
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 de LLM vs Raaghu AI

• Trazer sua própria chave de LLM — você fornece as próprias credenciais de API do Azure OpenAI, OpenAI ou Claude para este projeto, ou usa conexões atribuídas por um admin em AI Settings. Você paga ao provedor diretamente.
• Raaghu 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

1. 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 / Raaghu AI.
2. Caso contrário, ligue Project LLM, adicione um provedor, salve e defina-o como Default.
3. Se o chat ainda disser que a IA não está configurada, peça a um admin da organização para configurar conexões em AI Settings, habilitar Use organization AI, Use project AI 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 da sua própria chave de LLM:

• Off — o projeto usa conexões LLM da organização atribuídas por um administrador (quando Use organization AI é permitido no projeto).
• On — você pode adicionar credenciais específicas do projeto aqui.

Quando as conexões da organização são exibidas, a seção Organization LLM fica inativa apenas com Project LLM On (Disabled while Project LLM is on.) ou com Raaghu AI permitido e ligado neste projeto (Disabled while Raaghu AI is on.). Se Raaghu AI não for permitido no projeto, Organization LLM permanece disponível (não fica esmaecido só porque Raaghu está bloqueado).

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 → Extensions → Raaghu Spec Kit → AI Settings → Project (Use project AI).

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 Raaghu AI.

• Toggle On / Off — liga ou desliga a Raaghu AI neste projeto (admins da org e project admins quando Use Raaghu AI é permitido)
• Credit balance — saldo atual de Raaghu AI da organização
• Model — modelo Raaghu AI a usar
• Add 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 → AI Settings, 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.

Próximos passos

• My AI usage
• Seu primeiro feature
• Organization Settings
• Solução de problemas