Search

Jump to a page or agent

Deploy

Claves API

Claves de consumo para el widget, y qué se puede hacer con ellas.

Las claves se administran en API keys. Hay dos tipos y confundirlos es el error caro.

La lista de claves API, mostrando solo los últimos caracteres de cada una

Clave de consumo

La que va en el widget. Es publicable: cualquiera que vea el HTML de la página puede extraerla, y el diseño lo asume.

Lo que puede hacer está acotado a eso — abrir sesiones contra un agente y mandar mensajes. No lista agentes, no lee configuración, no toca nada de administración.

Se muestra una sola vez, al crearla. No hay forma de recuperarla después; se crea otra y se revoca la anterior.

Qué NO puede leer un visitante

Aunque tenga la clave:

  • El resultado crudo de una herramienta no sale de la plataforma. Si el agente consulta un inventario, el widget recibe la respuesta redactada, no las filas. Es estructural, no una opción — un resultado puede traer datos de tu cliente o salida de una shell.
  • Con identidad de usuario final, tampoco las conversaciones de otro visitante.

Rotar

Crear la nueva, cambiar el embed, y revocar la vieja en ese orden. Revocar primero corta el chat de quien esté conversando en ese momento.

Las claves del Playground

El panel de vista previa del agente crea sus propias claves de consumo automáticamente, con nombre por fecha. Es lo que hace que la vista previa use exactamente el mismo camino que un cliente en vez de una ruta privilegiada.

Si ves claves que no creaste con nombre de fecha, son esas.