La API de IA de SuperCognit: crea, publica y monitoriza agentes desde tu propio código

SuperCognit es una plataforma no-code y, para la mayoría, con eso basta: describe el agente, asocia tu conocimiento, publica. Pero en cuanto gestionas agentes para cien clientes, conectas conversaciones a un CRM o integras SuperCognit dentro de tu propio producto, hacer clic deja de escalar. Para eso está la API — el mismo espacio de trabajo, gobernado por tu código.

Una clave, una cabecera

Crea una clave de API en tu espacio de trabajo y envíala en la cabecera X-Api-Key. Las claves declaran alcances — se necesita escritura para todo lo que no sea un GET — y una clave puede limitarse a un único producto, en cuyo caso no toca recursos del espacio de trabajo como herramientas, bases de conocimiento o webhooks. Esa es toda la autenticación: sin OAuth, sin SDK que instalar.

curl https://api.supercognit.com/v1/products \
  -H "X-Api-Key: $SUPERCOGNIT_API_KEY"

Crear y publicar un agente sin abrir el panel

Un producto — agente de chat o servidor MCP — se crea como borrador, se configura y después se publica. Es exactamente el ciclo que sigue el panel, y por eso las agencias lo usan para aprovisionar un agente por cliente desde su propio onboarding.

curl -X POST https://api.supercognit.com/v1/products \
  -H "X-Api-Key: $SUPERCOGNIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "kind": "chat_agent",
    "title": "Acme support",
    "intro": "Hi! Ask me anything about Acme.",
    "systemPrompt": "You answer Acme customer questions from the attached knowledge."
  }'

La respuesta trae el id y el slug del nuevo producto. A partir de ahí asocias herramientas y bases de conocimiento, cambias el prompt o el precio y lo publicas — todo por la misma API.

Qué cubre la API

• Productos — crear, actualizar, publicar y despublicar agentes de chat y servidores MCP.
• Herramientas — la biblioteca del espacio de trabajo: herramientas LLM, HTTP y estáticas, sus inputs y qué productos las usan.
• Bases de conocimiento — el conocimiento que sostiene tus respuestas y dónde está asociada cada base.
• Conversaciones — sesiones y transcripciones completas, con el modelo y el recuento de tokens en cada mensaje.
• Webhooks — endpoints, su registro de entregas y sus reintentos.
• Monedero — el saldo de créditos de uso y cada recarga, cargo y reembolso.
• Usuarios finales — validar un token de sesión en tu servidor, para que tu aplicación sepa con quién habla.

Eventos, enviados a ti

Consultar la API sirve para recuperar histórico, pero el tiempo real debería llegar solo. Registra un endpoint y SuperCognit envía JSON por POST según ocurren las conversaciones: conversation.created cuando alguien inicia una conversación, message.created en cada mensaje, message.completed cuando el agente termina su respuesta. Las entregas se reintentan hasta cinco veces con espera exponencial y quedan registradas con el estado de la respuesta, así que nada desaparece en silencio.

Cada petición va firmada. Calcula el HMAC-SHA256 del cuerpo ORIGINAL con el secreto del endpoint y compáralo con la cabecera X-Supercognit-Signature — sobre los bytes exactos que recibiste, nunca sobre una copia reserializada del JSON.

import { createHmac, timingSafeEqual } from "node:crypto";

const expected = "sha256=" + createHmac("sha256", WEBHOOK_SECRET).update(rawBody).digest("hex");
const valid = timingSafeEqual(Buffer.from(expected), Buffer.from(signatureHeader));

Qué construyen los equipos con ella

REST para tus sistemas, MCP para clientes de IA

Las dos superficies para desarrolladores responden a preguntas distintas. La API es cómo tu código gobierna SuperCognit. MCP es cómo los clientes de IA — Claude, Cursor, tus propios agentes — usan lo que publicas. Ambos corren sobre el mismo espacio de trabajo, así que una herramienta creada una vez es accesible por los dos caminos, y el propio servidor MCP de la plataforma expone los mismos recursos dentro del asistente donde ya trabajas.

Empieza por la referencia

La referencia completa es pública e interactiva en api.supercognit.com/docs, generada a partir de un documento OpenAPI 3.1 que puedes pasar directamente a un generador de clientes. Crea una clave, ejecuta la primera llamada de arriba y mira cómo tu espacio de trabajo responde en JSON — gratis durante 7 días.