This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

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.

FuncionalidadeO que fazNa área logada
Feature flagsFlags tipadas, segmentos e kill switch compatíveis com OpenFeature./plataforma/flags
ExperimentationTestes A/B com análise de significância./plataforma/flags
Runtime configurationConfiguraçõ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 experimentsAná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 cleanupDepois 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

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

    Veja o exemplo abaixo.

#Avaliação pelo SDK servidor

bash
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. flagKey avalia uma flag; flagKeys, várias; sem nenhuma, todas, em páginas.
  • Cada resultado traz flagMetadata.exposureToken, exigido para registrar a exposição em POST /api/platform/flags/exposures.
  • GET /api/platform/flags/sdk/snapshot devolve a configuração para avaliação local; POST /api/platform/flags/metrics recebe as métricas dos experimentos. As quatro rotas pedem flags:evaluate.

#Rotas da API

RotaEscopoPara quêCLI
GET /api/v1/engineering/flagsLer a engenharia (API v1) engineering:readFeature flagsaiuby flags list
GET /api/v1/engineering/flag-cleanupLer a engenharia (API v1) engineering:readFlags candidatas a limpezaaiuby 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.