Herramientas para Desarrolladores y Documentación

Todo lo que necesitas para integrar Divinci AI en tus aplicaciones. SDKs para cada plataforma, un potente CLI y acceso completo a la API REST.

Documentación del SDK Referencia de la API

Elige tu Herramienta

Elige la integración adecuada para tu caso de uso — desde flujos de trabajo en terminal hasta widgets de chat en el navegador.

Divinci CLI

@divinci-ai/cli

Gestiona espacios de trabajo, chatea con IA, busca en bases de conocimiento y controla versiones desde tu terminal. Soporta perfiles, scripting y CI/CD.

npm install -g @divinci-ai/cli

Ver documentación del CLI →

Server SDK

@divinci-ai/server

Acceso completo a la plataforma desde Node.js — espacios de trabajo, versiones, operaciones RAG, gestión de claves de API y pagos blockchain x402.

npm install @divinci-ai/server

Ver referencia →

Client SDK

@divinci-ai/client

SDK para navegador diseñado para integración de chat headless. Respuestas en streaming, burbujas de contexto RAG, gestión de hilos y autenticación de usuarios externos.

npm install @divinci-ai/client

Ver referencia →

MCP SDK

@divinci-ai/mcp

Integración del Model Context Protocol para Claude Desktop, Cursor y otros asistentes de IA. Transporte SSE, invocación de herramientas y pagos x402.

npm install @divinci-ai/mcp

Ver referencia →

Embed Client

embed-script.js

Widget de chat listo para insertar en cualquier sitio web. Personalización white-label, sugerencias de conversación, visualización de contexto RAG, recomendaciones de productos y comentarios sobre mensajes (pulgar arriba/abajo). Activa las valoraciones con message-feedback="true" (o new DivinciChat({ messageFeedback: true })).

Ver referencia →

API REST

api.divinci.ai/api/v1

Acceso HTTP directo a la plataforma Divinci. Gestiona espacios de trabajo, versiones, colecciones RAG, claves de API y analíticas mediante endpoints REST.

curl -H "x-api-key: YOUR_KEY" https://api.divinci.ai/api/v1/

Ver referencia de la API →

Inicio Rápido

Ponte en marcha en minutos con estos ejemplos.

Terminal — CLI

# Instalar y autenticarse npm install -g @divinci-ai/cli divinci auth login

# Empezar a chatear divinci workspace list divinci workspace use ws_abc123 divinci chat

TypeScript — Server SDK

import { DivinciServer } from "@divinci-ai/server";
const divinci = new DivinciServer({
apiKey: process.env.DIVINCI_API_KEY,
});
// Subir documentos al RAG
await divinci.rag.uploadDocument({
workspaceId: “ws_abc123”,
ragVectorId: “rag_xyz”,
file: fs.createReadStream(“./knowledge.pdf”),
});
// Buscar en la base de conocimiento
const results = await divinci.rag.search({
workspaceId: “ws_abc123”,
query: “return policy”,
});

TypeScript — Client SDK

import { DivinciClient } from "@divinci-ai/client";
const client = new DivinciClient({
releaseId: “rel_abc123”,
apiKey: “divinci_key_…”,
});
// Transmitir una respuesta en streaming
for await (const chunk of client.chat.stream(“Tell me about your products”)) {
process.stdout.write(chunk.content);
}
// Pulgar arriba/abajo + comentarios sobre una respuesta del asistente
await client.chat.submitMessageFeedback(chatId, messageId, { sentiment: -1, feedback: “missed the warranty terms” });

TypeScript — MCP SDK

import { McpClient } from "@divinci-ai/mcp";
const client = new McpClient({
serverUrl: “https://mcp.divinci.app”,
apiKey: “divinci_key_…”,
});
await client.connect();
const tools = await client.listTools();
const result = await client.callTool(“search_knowledge”, { query: “return policy” });

Comparación de SDKs

Cada SDK sirve para un caso de uso distinto. Usa esta tabla para encontrar el más adecuado.

Característica	CLI	Client	Server	MCP
Entorno	Terminal	Navegador	Node.js	Ambos
Mensajes de Chat	Sí	Sí	—	Sí
Streaming	Sí	Sí	Sí	—
Gestión de Espacios de Trabajo	Sí	—	Sí	—
Gestión de Versiones	Sí	—	Sí	—
Operaciones RAG	Sí	—	Sí	Sí
Gestión de Claves de API	—	—	Sí	—
Pagos x402	—	—	Sí	Sí
Auth0 PKCE	—	Sí	—	Sí
Protocolo MCP	—	—	—	Sí
Acceso Directo a la API	Sí	—	Sí	—

Autenticación

Tres métodos de autenticación para adaptarse a tu arquitectura.

Clave de API (Server)

Ideal para servicios de backend y CI/CD. Pasa tu clave mediante una variable de entorno o el constructor.

const divinci = new DivinciServer({
  apiKey: process.env.DIVINCI_API_KEY,
});

Clave de API + Usuario Externo

Ideal para clientes embebidos que identifican a los usuarios finales para experiencias personalizadas.

const client = new DivinciClient({
  releaseId: "rel_abc123",
  apiKey: "divinci_key_...",
  externalUser: { id: "user_123" },
});

Token JWT (Navegador)

Ideal para aplicaciones de navegador con tu propio backend gestionando el intercambio de tokens.

const client = new DivinciClient({
  releaseId: "rel_abc123",
  getToken: async () => {
    return fetch("/api/token");
  },
});

Empieza a construir con Divinci AI

Consigue tu clave de API e integra capacidades de IA en tu aplicación en minutos.

Obtener claves de API Referencia completa de la API