Feedback
El SDK permite enviar feedback (thumbs up/down) sobre mensajes individuales del agente. Esto ayuda a mejorar la calidad de las respuestas y aparece en las metricas del tenant.
Obtener el messageId
El messageId necesario para feedback se obtiene del evento response.completed o de la metadata de la respuesta:
// Via streaming
const stream = thaliq.agent.stream('Analiza mis gastos');
let messageId: string | undefined;
for await (const event of stream) {
if (event.type === 'content.delta') {
process.stdout.write(event.delta);
}
if (event.type === 'response.completed') {
messageId = event.metadata?.messageId;
}
}
// Via chat
const response = await thaliq.agent.chat('Analiza mis gastos');
messageId = response.metadata.messageId;
Enviar feedback
await thaliq.agent.feedback({
conversationId: 'conv-123',
messageId: 'msg-456',
feedback: 'positive', // 'positive' | 'negative'
});
Parametros
| Parametro | Tipo | Requerido | Descripcion |
|---|
conversationId | string | Si | ID de la conversacion |
messageId | string | Si | ID del mensaje a calificar |
feedback | 'positive' | 'negative' | Si | Calificacion |
Ejemplo completo
const stream = thaliq.agent.stream('¿Cuales son mis gastos mas altos?');
let messageId: string | undefined;
let conversationId: string | undefined;
for await (const event of stream) {
if (event.type === 'meta') {
conversationId = event.conversationId;
}
if (event.type === 'content.delta') {
appendToUI(event.delta);
}
if (event.type === 'response.completed') {
messageId = event.metadata?.messageId;
}
}
// Mostrar botones de feedback en la UI
showFeedbackButtons({
onThumbsUp: async () => {
await thaliq.agent.feedback({
conversationId: conversationId!,
messageId: messageId!,
feedback: 'positive',
});
},
onThumbsDown: async () => {
await thaliq.agent.feedback({
conversationId: conversationId!,
messageId: messageId!,
feedback: 'negative',
});
},
});
El endpoint de feedback es POST /api/agent/feedback. El feedback se persiste en DynamoDB y es visible en la plataforma.
Insights
Los agentes pueden extraer insights automaticamente del contexto de la conversacion. Estos son observaciones, alertas, oportunidades o logros que el agente detecta al analizar datos.
Tipos de insight
| Tipo | Descripcion | Ejemplo |
|---|
warning | Alerta que requiere atencion | ”Gasto inusual detectado en restaurantes” |
opportunity | Oportunidad identificada | ”Puedes ahorrar S/200 reduciendo suscripciones” |
info | Informacion relevante | ”Tu gasto promedio mensual es S/3,200” |
achievement | Logro o hito positivo | ”Ahorraste 15% mas que el mes pasado” |
Severidad
| Severidad | Significado |
|---|
low | Informativo |
medium | Requiere atencion eventual |
high | Importante |
critical | Requiere atencion inmediata |
Consumir insights
Los insights vienen incluidos en la respuesta:
// Via chat
const response = await thaliq.agent.chat('Dame un resumen de mis finanzas');
for (const insight of response.insights) {
console.log(`[${insight.severity}] ${insight.type}: ${insight.title}`);
console.log(insight.description);
if (insight.amount) console.log(`Monto: ${insight.amount}`);
}
// Via streaming (en response.completed)
const stream = thaliq.agent.stream('Dame un resumen');
for await (const event of stream) {
if (event.type === 'response.completed') {
renderInsights(event.insights);
}
}
// O via finalResponse()
const response = await stream.finalResponse();
renderInsights(response.insights);
Interfaz Insight
interface Insight {
type: 'warning' | 'opportunity' | 'info' | 'achievement';
severity: 'low' | 'medium' | 'high' | 'critical';
title: string;
description: string;
category?: string; // Ej: "gastos", "ahorros", "inversiones"
amount?: string; // Ej: "S/ 1,200" (para insights financieros)
}
Ejemplo: renderizar insights en una app
function renderInsights(insights: Insight[]) {
const iconMap = {
warning: '⚠️',
opportunity: '💡',
info: 'ℹ️',
achievement: '🏆',
};
for (const insight of insights) {
const icon = iconMap[insight.type];
console.log(`${icon} ${insight.title}`);
console.log(` ${insight.description}`);
if (insight.category) console.log(` Categoria: ${insight.category}`);
if (insight.amount) console.log(` Monto: ${insight.amount}`);
console.log('');
}
}
Los insights dependen de las tools del agente y del contexto de la conversacion. No todas las respuestas incluyen insights — solo aquellas donde el agente detecta informacion relevante.
