Settings
1. Visão Geral
A tela de Account Settings reúne as configurações gerais da conta na plataforma Nukk, em três abas:
- AI Keys — chaves de API dos provedores de IA usados pelo Copilot, e seleção de modelos disponíveis.
- Environments — ambientes da conta (namespaces isolados onde Flows, Apps e Add-ons são implantados).
- Skills — base de conhecimento de negócio reutilizável, injetada no contexto do Copilot.
2. Aba AI Keys
Configura as chaves de API usadas pelo Copilot/IA no preview do Code Editor. Essas chaves ficam compartilhadas entre todos os Frontend Apps da conta.
Chaves de provedor
| Campo | Descrição |
|---|---|
| Anthropic API Key | Chave de API da Anthropic. Depois de salva, aparece como "Anthropic API key is configured." Pode ser revelada (ícone de olho), atualizada (Save) ou removida (Remove). Obtida em console.anthropic.com. |
| Google Gemini API Key | Chave de API do Google Gemini. Mesmo comportamento da chave da Anthropic (configurar, revelar, salvar, remover). Obtida em aistudio.google.dev. |
As chaves ficam criptografadas e armazenadas com segurança — a tela só confirma que "está configurada", sem exibir o valor por padrão.
System Model
Define o modelo de IA usado pela própria plataforma para validações de segurança e inicialização do preview (não é o modelo usado pelo desenvolvedor no Copilot). Exemplo: claude-sonnet-4-20250514.
Model Selection
Define quais modelos de IA ficam disponíveis no Copilot para os desenvolvedores escolherem, agrupados por provedor:
- Anthropic: Claude Sonnet 4.6, Claude Opus 4.6, Claude Sonnet 4.5, Claude Opus 4.5, Claude Haiku 4.5.
- Google Gemini: Gemini 3.1 Pro, Gemini 3.5 Flash, Gemini 3 Flash, Gemini 3.1 Flash-Lite.
Cada modelo é habilitado/desabilitado individualmente via checkbox. Só aparecem no seletor de modelo do Copilot (em Frontend/Backend Apps) os modelos habilitados aqui — e cada provedor só funciona se a respectiva API Key estiver configurada.
3. Aba Environments
Gerencia os ambientes da conta. Cada ambiente mapeia para um namespace Kubernetes isolado, onde Flows, Apps e Add-ons são implantados.
A tabela mostra:
| Coluna | Descrição |
|---|---|
| Name | Nome do ambiente (ex: test, production). |
| Type | Tipo do ambiente. Ambientes padrão da conta aparecem como System. |
| Actions | Ações disponíveis para o ambiente. |
O botão + Create environment cria um novo ambiente além dos padrão (test e production).
4. Aba Skills
O Business Skills Registry guarda conhecimento de negócio reutilizável (regras, contexto, glossário) que fica sempre disponível no contexto do Copilot — útil para que a IA gere código já alinhado com as regras específicas do seu negócio, sem precisar repeti-las a cada prompt.
O botão + Create skill abre o formulário Create business skill:
| Campo | Descrição |
|---|---|
| Name | Nome da skill. |
| Description | Descrição curta do propósito da skill. |
| Content (markdown) | Conteúdo em markdown com o conhecimento/regras de negócio. É sempre carregado no contexto do Copilot. |
O botão Generate with AI permite gerar o conteúdo da skill automaticamente a partir de uma descrição, em vez de escrever o markdown manualmente.
5. Perguntas frequentes
As AI Keys valem para todos os ambientes (test/production) ou só um deles? TODO: confirmar se as chaves configuradas em AI Keys são globais da conta ou específicas por ambiente.
Existe limite de skills que podem ser criadas, ou de tamanho do conteúdo em markdown? TODO: confirmar limites da Business Skills Registry.
Quem pode criar/remover ambientes? TODO: confirmar regra de permissão para a aba Environments.