Entrega
Feature Management
Feature flags compatíveis com OpenFeature, experimentos, configurações em tempo de execução e limpeza de flags, com a avaliação pelo SDK servidor.
#O que faz
Feature flags, rollout gradual, configurações e experimentos.
| Funcionalidade | O que faz | Na área logada |
|---|---|---|
| Feature flags | Flags tipadas, segmentos e kill switch compatíveis com OpenFeature. | /plataforma/flags |
| Experimentation | Testes A/B com análise de significância. | /plataforma/flags |
| Runtime configuration | Configurações e AI Configs no motor das flags: JSON Schema validado, versões, targeting, mudança com revisão e aprovação, agendamento, volta em um clique e SDK JS/TS com avaliação local. | /plataforma/flags |
| Warehouse experiments | Análise de experimento com os dados do seu banco: consulta só leitura pelo conector de dados (SELECT validado, tabelas liberadas, auditoria sem os dados) e a mesma estatística dos experimentos. | /plataforma/flags/warehouse |
| Release monitor and flag cleanup | Depois de cada mudança de flag, compara o burn rate dos SLOs do serviço na hora antes e na hora depois e sugere o kill switch quando piorou; lista as flags que servem uma variante só (tela, API v1 e recurso MCP flag_cleanup) e abre, para cada uma, um ticket no Code Automation que tira a flag do código com plano aprovado e revisão de outra pessoa. | /plataforma/flags |
#Como ativar
- Na área logada: o dono adiciona o Cortex em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
- Pela API v1 e pela CLI: a organização precisa do Cortex ativo, de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
Nota
Produto da plataforma não ativo ou módulo não liberado para a organização: a API v1 responde
404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.#Primeiro uso
Crie a flag na tela
Em Flags, crie a flag, o ambiente e a regra. A chave do SDK de cada ambiente aparece na tela.Crie a chave de API
Com SDK de feature flags (servidor)flags:evaluate. O servidor manda as duas: a chave de API e a chave do SDK do ambiente.Avalie
Veja o exemplo abaixo.
#Avaliação pelo SDK servidor
curl -X POST https://aiuby.com/api/platform/flags/sdk/evaluate \
-H "Authorization: Bearer $AIUBY_TOKEN" -H "X-AIUBY-Flags-Key: $FLAGS_SDK_KEY" \
-H "Content-Type: application/json" \
-d '{"context":{"key":"usuario-123","plano":"pro"},"flagKey":"novo-checkout"}'- O ambiente sai da chave do SDK.
flagKeyavalia uma flag;flagKeys, várias; sem nenhuma, todas, em páginas. - Cada resultado traz
flagMetadata.exposureToken, exigido para registrar a exposição emPOST /api/platform/flags/exposures. GET /api/platform/flags/sdk/snapshotdevolve a configuração para avaliação local;POST /api/platform/flags/metricsrecebe as métricas dos experimentos. As quatro rotas pedemflags:evaluate.
#Rotas da API
| Rota | Escopo | Para quê | CLI |
|---|---|---|---|
GET /api/v1/engineering/flags | Ler a engenharia (API v1) engineering:read | Feature flags | aiuby flags list |
GET /api/v1/engineering/flag-cleanup | Ler a engenharia (API v1) engineering:read | Flags candidatas a limpeza | aiuby flags cleanup |
#O que ainda não existe
- Criar, mudar ou apagar flag por chave de API: a configuração é feita na tela, com revisão e aprovação quando o ambiente pede.
- SDK em outras linguagens além de JS/TS: use as rotas acima.
- A limpeza só aponta e abre ticket no Code Automation: nada sai do código sem plano aprovado e revisão de outra pessoa.