Agentes

Un agente reúne las instrucciones, el modelo, las fuentes de Knowledge y las Tools configuradas en Inceptiva Studio. El SDK consulta y ejecuta un agente que ya tiene activo el canal API para productos; no crea ni administra agentes.

Identificador público

agentId es el identificador público del canal API, representado habitualmente por INCEPTIVA_AGENT_ID. No utilices el identificador numérico de las rutas privadas de Studio.

Información y capacidades

const agent = await client.getAgent();

console.log(agent.id, agent.name, agent.description);
console.log(agent.capabilities.citations);
console.log(agent.capabilities.documents);

Invocar el agente

const result = await client.responses.create({
  message: "Resume las señales de compra de este lead",
});

console.log(result.response);
console.log(result.conversationId);
console.log(result.citations);

message admite entre 1 y 10.000 caracteres. Knowledge y Tools pueden intervenir internamente, pero el SDK no ofrece métodos para administrarlos ni expone retrieval_sources.

Consulta Conversaciones para continuar el contexto.

Las capacidades informan qué puede utilizar la integración, pero no convierten el SDK en una API administrativa. Las operaciones quedan aisladas por el agente público asociado a la clave.