Instalar el paquete
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.