Skip to main content

Instalar el paquete

npm install @thaliq/sdk

Quick Start

1. Inicializar el SDK

import { Thaliq } from '@thaliq/sdk';

const thaliq = new Thaliq({
  apiKey: 'tq_live_TU_API_KEY',
});

2. Enviar un mensaje (sin streaming)

const response = await thaliq.agent.chat('Hola, ¿que puedes hacer?');
console.log(response.message);

3. Enviar un mensaje (con streaming)

const stream = thaliq.agent.stream('Analiza las ventas del Q4');

for await (const event of stream) {
  switch (event.type) {
    case 'content.delta':
      process.stdout.write(event.delta);
      break;
    case 'tool.start':
      console.log(`Ejecutando: ${event.tool}`);
      break;
  }
}

4. Identificar un usuario (opcional)

Si tu app tiene usuarios autenticados y necesitan acceder a tools protegidas:
thaliq.identify({
  userId: 'usr_123',
  name: 'Maria Garcia',
  token: 'jwt_del_usuario',
});

Configuracion

const thaliq = new Thaliq({
  // Requerido
  apiKey: 'tq_live_xxx',

  // Opcionales
  baseUrl: 'https://api.thaliq.com',  // URL de la API
  timeout: 30000,                      // Timeout en ms (default: 30s)
  maxRetries: 2,                       // Reintentos automaticos (default: 2)
  integrationType: 'sdk',              // 'sdk' | 'widget' (default: 'sdk')
  defaultHeaders: {                    // Headers adicionales en cada request
    'X-Custom-Header': 'valor',
  },
});
Ver la referencia completa de configuracion para todas las opciones.
El SDK requiere un plan Growth o Enterprise. En plan Starter, las peticiones con X-Integration-Type: sdk seran rechazadas.

Siguiente paso

Streaming

Aprende a consumir respuestas en tiempo real con 12 tipos de eventos.

Identidad de usuario

Configura autenticacion para tools protegidas.

Human-in-the-Loop

Maneja acciones interactivas (consent, confirm, select, form).

Feedback e Insights

Califica respuestas y consume insights extraidos.