POST/v1/query
GraphRAG
Pergunta em linguagem natural. Resposta com fato do grafo + trecho de documento, com fonte.
{ "question": "…" } → { facts[], sources[] }
// Devs
Construa sobre o OS.
SDK, API e MCP para times internos e fornecedores falarem com a Adaptive Layer™ — a mesma porta, a mesma permissão, a mesma trilha. O contexto da operação vira contrato de engenharia.
terminal
$ npm install @adaptive-layer/sdk
+ @adaptive-layer/sdk@1.4.2
$ layer auth login --tenant cafe-orfeu
✓ credencial de sandbox emitida · acl herdada do perfil
// Quickstart
Três caminhos para a mesma Layer.
REST para qualquer stack, SDK tipado para produto, MCP para plugar o modelo direto. Todos batem na mesma porta — com ACL e audit.
query.sh
curl -X POST https://layer.suaempresa.com/v1/query \
-H "Authorization: Bearer $LAYER_KEY" \
-d '{ "question": "Por que o pedido #4821 pode atrasar?" }'
{
"answer": "Separação do lote L-19 pendente no WMS…",
"facts": [
{ "node": "pedido:4821", "value": "entrega sexta", "source": "erp" }
],
"sources": [
{ "doc": "politica-sla-cliente-x.pdf", "clause": "4.2" }
],
"audit_id": "aud_8f2k1"
}
// Referência
A API em quatro recursos.
GET/v1/graph/nodes/:id
Knowledge graph
Nós e relações: pedido, lote, cliente, política. Navegue as conexões da operação.
pedido:4821 → { edges: [reserva → lote:l-19] }
POST/v1/events
Ingestão
Webhook para conectores próprios: o fornecedor emite o evento, a Layer resolve a identidade.
{ "type": "pedido.criado", "payload": {…} }
GET/v1/audit
Trilha
Quem consultou o quê, com qual permissão. Pessoa, agente e sistema no mesmo log.
?actor=agente-comercial&since=24h
// Governança para devs
Credencial com escopo. Sempre.
API keys com ACL herdada
A chave carrega o perfil de acesso. O fornecedor vê o que o contrato permite — nada além.
Escopo por agente e fornecedor
Cada integração tem dono, escopo e expiração. Revogar é um comando, não um chamado.
Sandbox e produção
Sandbox com dados sintéticos do tenant. Promova para produção com o mesmo contrato.
Rate limits e versionamento
Limites por chave, versões estáveis (/v1) e depreciação anunciada no changelog.
Pronto para integrar?
Pedimos o escopo, emitimos a credencial de sandbox e o seu time faz a primeira query no mesmo dia.