For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /docs/agents/overview.md.

Crear y configurar agente

Un agente se crea desde la sección Agentes de Kivox Studio, indicando un nombre y una descripción. Ambos campos son para uso interno del equipo: ayudan a identificar el propósito del agente sin necesidad de abrir su configuración completa.

Nombre: Soporte al cliente
Descripción: Atiende consultas de clientes sobre pedidos, entregas y devoluciones.

También puede asignarse un avatar para distinguir el agente visualmente dentro de Kivox Studio cuando el espacio de trabajo tiene varios. Este avatar también se usará en la interfaz de chat.

Secciones de configuración

La configuración de un agente se organiza en varias secciones independientes. Cada una controla un aspecto distinto del comportamiento, y no es necesario completarlas todas antes de la primera prueba.

SecciónControla
InstruccionesFunción, tono y límites del agente
ModelosEl modelo de lenguaje y sus parámetros de generación
IdiomaIdioma principal de la conversación, detección automática y zona horaria
VozProveedor de voz, velocidad, tono y detección de turnos
TelefoníaNúmero, duración de llamada, grabación, transferencia y buzón de voz
InterfazMensajes iniciales y sugerencias mostradas al comenzar una conversación
SeguridadRedacción de información sensible, filtro de lenguaje y retención de datos
Capacidades nativasFunciones propias de Kivox, como la búsqueda en la base de conocimiento
Conocimiento y herramientasBases de conocimiento y herramientas personalizadas conectadas al agente

Las instrucciones son la configuración con mayor efecto sobre el comportamiento del agente, y conviene revisarlas primero. El resto de las secciones amplían o ajustan ese comportamiento base.

Estado del agente

Un agente pasa por tres estados durante su ciclo de vida.

Borrador es el estado inicial. Un agente en estado Borrador puede modificarse y probarse libremente; ninguna conversación real depende todavía de él.

Publicado indica que el agente está operando. El cambio a Publicado debería ocurrir después de haber probado su comportamiento con casos representativos, no como parte del flujo de creación.

Archivado retira el agente de la operación sin eliminar su configuración. Antes de archivar un agente, confirme que ningún canal activo depende de él.

Modificar un agente

El nombre, la descripción, el avatar y cualquier sección de configuración pueden actualizarse después de la creación. Un cambio en las instrucciones o en las herramientas conectadas puede alterar el comportamiento del agente ante preguntas que antes funcionaban correctamente, así que conviene repetir las pruebas principales después de una modificación, tal como se describe en Diagnosticar un agente.