Plataforma para desarrolladores

Construye sobre el runtime gobernado.

Un SDK tipado, una API REST y una CLI para la plataforma de agentes de IA gobernados: registra agentes, propón acciones, redacta políticas, consulta la ontología y lee un Trust Ledger con evidencia de manipulación. Las mismas puertas que protegen la consola se aplican en cada petición.

Únete a la lista de esperaVer la arquitectura

SDK @cortex/client · REST · CLI · Webhooks · Sandbox

agent.tspolicy.tscurl
ejemplo
// Escríbelo una vez. Cada ejecución pasa por las puertas, cada acción es demostrable.
import { Cortex } from "@cortex/client";
const cortex = new Cortex({ apiKey, tenantId });
// Propón una acción de alto riesgo: deciden las puertas.
const res = await cortex.actions.propose({
key: "refund.issue",
input: { amount: 5000 },
});
pending_approval{ status: "pending_approval", riskLevel: "high" }
// Las acciones de alto riesgo esperan a un admin. Apruébala y lee
// el recibo firmado: verificable sin conexión contra la cadena.
audit/verify ▸ { ok: true, brokenAtSeq: null, head: { seq: 1042, hash: "0x9f3a…c1" } }
Inicio rápido

De la instalación a un veredicto gobernado en tres pasos.

Instala el SDK, autentícate contra un inquilino y propón tu primera acción gobernada: cada llamada queda registrada en un Trust Ledger que puedes verificar sin conexión. Los fragmentos siguientes son ejemplos ilustrativos.

  1. 01

    Instalar @cortex/client

    Añade el SDK tipado a tu proyecto. Es un cliente ligero sobre la misma REST API y los mismos controles fail-closed.

  2. 02

    Autenticarse

    Construye el cliente con tu clave de API acotada al tenant y tu tenantId. Cada llamada queda ligada a tu tenant en la ruta de datos — sin lecturas entre tenants.

  3. 03

    Ejecutar una acción gobernada y leer el veredicto

    Propón una acción. Las ejecuciones de bajo riesgo se ejecutan; las acciones de alto riesgo o que requieren aprobación quedan retenidas como pending_approval. Lee el veredicto y verifica el comprobante.

instalarejemplo
# 01 · instala el SDK tipado
npm i @cortex/client
 
# 02 · autentícate (clave de API + tenant)
import { Cortex } from "@cortex/client";
const cortex = new Cortex({
  apiKey: process.env.CORTEX_KEY,
  tenantId: process.env.CORTEX_TENANT,
});
ejecutar una acción gobernadaejemplo
// 03 · propose: las puertas deciden el veredicto
const res = await cortex.actions.propose({
  key: "refund.issue",
  input: { amount: 5000 },   // alto riesgo
});
 
// → { status: "pending_approval", riskLevel: "high" }
// las acciones de bajo riesgo devuelven { status: "executed" }
Conceptos básicos

Seis ideas sobre las que se construye toda integración.

Las superficies son clientes ligeros sobre el mismo runtime gobernado. Aprende el concepto y sigue cada uno hasta su página de capacidad para verlo completo.

Runtime gobernado y controles
  • Cada ejecución pasa por las mismas puertas en el mismo orden
  • Denegar es lo predeterminado: fallo cerrado
  • Códigos estables: 402 · 403 · 409 · arquitectura
Ontología y permisos
  • Modelo de objetos empresarial tipado
  • RBAC a nivel de objeto y propiedad (none/read/write)
  • Las lecturas ocultan lo que está por debajo de read · ontología
Action Fabric
  • Acciones con nombre y nivel de riesgo
  • dry-run → propose → approve → execute
  • Registro de invocaciones inmutable · action fabric
Trust Ledger y procedencia
  • Auditoría encadenada por hash y a prueba de manipulación
  • Recibos firmados, verificables sin conexión
  • Linaje de 10 saltos · trust ledger
Agent IAM
  • Los agentes son identidades gobernadas
  • Propietario · nivel de riesgo · caducidad · modelos permitidos
  • Identidad caducada → 403 · agent IAM
Solution Packs
  • Ontología, políticas y acciones en un solo artefacto
  • Firmado · verificado · con diff al importar
  • Vuelve a desplegarlo en tu tenant · packs
API y recursos

Las áreas de recursos con las que trabajarás.

Llega a cada superficie gobernada por REST, por el SDK tipado @cortex/client o por la CLI. A continuación se describe qué hace cada área de recursos; no es una referencia exhaustiva de endpoints. Sigue una tarjeta para ver la capacidad completa.

Agentes e identidades
client.agentIdentities

Registra agentes como identidades gobernadas con propietario, nivel de riesgo, caducidad y modelos/acciones permitidos. Las identidades caducadas o suspendidas se rechazan en tiempo de ejecución (403).

Más información
Acciones
client.actions

Acciones con nombre, nivel de riesgo y política de aprobación. Dry-run → propose → approve/deny → execute → compensate: cada paso queda registrado en un registro de invocaciones inmutable, con su pack de evidencias.

Más información
Políticas
client.governance

Escribe reglas y, antes de publicar, simula una decisión (con la traza regla a regla) o ejecuta pruebas golden de políticas contra un conjunto de reglas candidato: gana el efecto más restrictivo.

Más información
Ontología y permisos
client.ontology

Un modelo de objetos empresarial tipado con RBAC a nivel de objeto y propiedad. Los permisos se resuelven en none / read / write; las lecturas ocultan las propiedades por debajo de read y las escrituras se controlan por tipo.

Más información
Auditoría y verificación
GET /v1/audit/verify

Un registro de auditoría encadenado por hash y a prueba de manipulación. verify devuelve { ok, brokenAtSeq, head } sobre un rango, y head devuelve la cabeza actual de la cadena para anclarla externamente.

Más información
Solution Packs
client.packs

Agrupa tipos de ontología, políticas y acciones en un artefacto firmado y versionado. verify comprueba hashOk + signatureOk; import muestra un diff previo y lo aplica en el tenant de quien realiza la llamada.

Más información
REST APISDK @cortex/clientCLIWebhooks y eventos
Formas de integrar

Cinco superficies, un runtime gobernado.

La API, el SDK, la CLI y los webhooks son clientes ligeros sobre las mismas puertas de fallo cerrado: identidad, presupuesto, guardarraíles, registro, control tower, ejecución, guarda de salida y auditoría. No hay puerta trasera sin gobernar.

REST API

Controla todas las superficies gobernadas por HTTPS: registra acciones, propónlas y apruébalas, consulta la ontología, ejecuta simulaciones de gobernanza y lee el Trust Ledger. Las mismas puertas que protegen la consola protegen la API.

con alcance de inquilino · Bearer token
  • El alcance por inquilino se aplica en la ruta de datos
  • Rutas solo para administradores (approve · deny · pack import) protegidas en el servidor
  • Códigos de estado estables sobre los que ramificar: 402 · 403 · 409
@cortex/client SDK

Cliente TypeScript tipado sobre la API REST. Recursos fuertemente tipados para agentes, acciones, gobernanza, ontología, auditoría y packs, con el mismo alcance de inquilino y la misma semántica de puertas que la API directa.

npm i @cortex/client · ESM + types
  • client.actions · client.governance · client.packs
  • client.ontology.permissions · client.agentIdentities
  • Token + tenantId en cada llamada
CLI

Publica gobernanza desde tu terminal y tu CI. Exporta y verifica Solution Packs firmados, ejecuta pruebas de políticas como barrera de regresión y consulta el Trust Ledger sin salir del pipeline.

programable · compatible con CI
  • Ejecuta pruebas de políticas antes de publicar un cambio de reglas
  • Exporta y verifica un pack firmado (hashOk · signatureOk)
  • Verifica la cadena del ledger sin conexión
Webhooks y eventos

Cortex emite eventos de ciclo de vida gobernados —ActionExecuted, ActionFailed, decisiones de aprobación— por la misma ruta de eventos de la plataforma que sella el Trust Ledger. Suscríbete para conciliar contra el rastro de auditoría con evidencia de manipulación.

orientado a eventos · sellado en el ledger
  • Ciclo de vida de la acción: proposed · approved · executed · compensated
  • Cada evento queda sellado en la cadena de hashes al registrarse
  • Concilia por secuencia del ledger (seq)
Sandbox e inicio rápido

Un inquilino gobernado que puedes aprovisionar y poblar con una ontología, políticas y acciones de ejemplo. Ejecuta tu primera acción con puertas y lee un Trust Ledger real que puedes verificar, sin tocar producción.

aislado por inquilino · 0 impacto en producción
  • Carga una ontología, políticas y acciones de ejemplo
  • Primero dry-run: valida la entrada, sin efectos secundarios
  • Inspecciona cada decisión de las puertas en el registro de invocaciones
Policy-as-Code

Versiona la gobernanza igual que versionas tu aplicación. Escribe reglas allow / require-approval / deny, simula una decisión antes de publicar y protege los cambios con pruebas de políticas de referencia en CI.

simular · probar · promover
  • Gana la más restrictiva: deny > require_approval > allow
  • simulate() devuelve la traza de decisión regla por regla
  • tests.run() como barrera de regresión antes de publicar
Demostrable, no solo registrado

Verifica el libro de registro sin conexión.

El Trust Ledger está encadenado por hash: cada registro sella al anterior. verifyChain recalcula la cadena y devuelve { ok, brokenAtSeq }; cualquier inserción, edición, borrado o reordenación pone ok en false. Los recibos de resultado son firmas separadas que puedes verificar con la clave publicada, así que un tercero puede confirmar que una ejecución ocurrió sin confiar en la base de datos de Cortex. El fragmento es un ejemplo ilustrativo.

  • Integridad de la cadena: verifyChain(records) → { ok, brokenAtSeq }
  • Recibos firmados: verifyReceipt(claims, sig, key), en tiempo constante
  • Hoy HMAC-SHA256; las claves de verificación publicables Ed25519 son la evolución documentada
Explorar el Trust LedgerVer la arquitectura
verificar sin conexiónejemplo
import {
  verifyChain, verifyReceipt,
} from "@cortex/provenance";
 
// 1 · recalcula la cadena de hashes
const v = verifyChain(records);
// → { ok: true, brokenAtSeq: null }
 
// 2 · verifica un recibo de resultado firmado
const valid = verifyReceipt(
  claims, signature, verifyKey,
);
// → true   (manipulación → false)
Profundiza

Entiende el runtime sobre el que construyes.

Las superficies para desarrolladores se apoyan en la plataforma completa. Mira cómo encajan las puertas y explora cada capacidad gobernada de principio a fin.

La arquitectura

Consola, puertas del runtime, ~22 microservicios y una única ontología y Trust Ledger sobre Postgres: el sistema por capas por el que pasa cada llamada a la API.

La plataforma

Action Fabric, Agent IAM, la ontología, los modos de supervisión, el gateway MCP y el Trust Ledger: cada capacidad gobernada, accesible desde la API y el SDK.

Crea agentes gobernados desde el primer día.

Recibe una visita guiada por la API, el SDK y la CLI, y observa cómo tu primera acción sujeta a puertas queda en un Trust Ledger verificable.

Únete a la lista de esperaHablar con ingeniería
Documentación para desarrolladores — API, SDK y CLI | Cortex AI OS