Conversaciones

La primera respuesta crea una conversación automáticamente y devuelve su identificador público como conversationId.

Continuidad

const first = await client.responses.create({
  message: "Analiza este lead",
});

const next = await client.responses.create({
  message: "Prepara el siguiente paso",
  conversationId: first.conversationId,
});

Guarda siempre el conversationId más reciente y no lo compartas entre usuarios que no deban compartir contexto.

Historial y citas

const history = await client.conversations.getMessages(
  next.conversationId,
  { page: 1, pageSize: 50 },
);

for (const message of history.items) {
  console.log(message.role, message.content);
  console.log(message.citations);
}

El historial incluye los datos de la conversación y sus mensajes ordenados. Las respuestas del asistente pueden incluir citas públicas. La respuesta incluye page, pageSize, total y hasMore; el máximo es 100 mensajes por página.

Referencia externa e idempotencia

externalReference correlaciona una operación con un identificador estable de tu producto. idempotencyKey evita duplicar una generación cuando el resultado de red es incierto. Una referencia incompatible o una clave reutilizada con otro payload produce un error funcional tipado.

Eliminar

await client.conversations.delete(next.conversationId);

La eliminación es definitiva. La API pública permite recuperar mensajes y eliminar una conversación concreta, pero no listar, crear explícitamente ni renombrar conversaciones.