Inceptiva· SDKv0.4.0
GitHub ◉EN
GETTING STARTED

Tu primer agente

Antes de invocar un agente desde el SDK debes activar su canal API para productos en Inceptiva Studio.

Obtener las credenciales

  1. Accede a Inceptiva Studio y abre el workspace correspondiente.
  2. Selecciona el agente que quieres integrar.
  3. Abre Canales → API para productos.
  4. Configura el canal y actívalo.
  5. Copia el identificador público y la API key mostrados al crear el canal.

El endpoint generado tiene esta forma:

text
https://api.inceptiva.com/v1/agents/AGENT_ID/responses
Guarda la API key al crearlaLa clave completa solo se entrega al crear o rotar el canal. Después, Studio conserva únicamente un prefijo identificativo y un hash seguro.

AGENT_ID

AGENT_ID es el public_id del canal API y normalmente tiene formato UUID. Es diferente del identificador numérico utilizado internamente por Studio.

Configuración opcional

El canal permite controlar:

  • estado activo o inactivo;
  • límite de 1 a 1.000 solicitudes por minuto;
  • lista permitida de direcciones IP o rangos CIDR;
  • exposición de referencias procedentes de Knowledge.

Si rotas la API key, la clave anterior deja de autorizar nuevas llamadas. Continúa con Autenticación para almacenarla correctamente.