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/getting-started/your-first-agent.md.

Crear su primer agente

Esta guía demuestra el camino mínimo para tener un agente funcional en Kivox: crearlo, escribir sus instrucciones y comprobar su comportamiento en una conversación real. No incorpora todavía conocimiento, herramientas ni voz. Esas capacidades se añaden cuando el caso de uso lo requiere, y se tratan en Canales y capacidades.

El ejemplo utiliza un agente de soporte al cliente para una tienda en línea, pero el flujo es el mismo para cualquier dominio.

Crear el agente

Abra la sección Agentes en Kivox Studio y seleccione Nuevo agente.

[Captura de pantalla: Listado de agentes con el botón "Nuevo agente" destacado]

Asigne un nombre que identifique la función del agente sin necesidad de abrir su configuración, y una descripción breve de su propósito.

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

Un agente comienza en estado borrador. En este estado puede modificarse y probarse libremente sin afectar ninguna conversación real.

Escribir las instrucciones

Abra la configuración del agente y localice el campo de instrucciones del sistema.

Una instrucción útil describe tres cosas: la función del agente, las reglas que debe seguir y qué debe hacer cuando no puede resolver una solicitud.

## Rol

Eres el asistente de soporte de una tienda en línea.

Tu función es ayudar a los clientes con consultas sobre pedidos, entregas y devoluciones.

## Estilo de respuesta

- Responde de forma clara, profesional y concisa.
- Si una solicitud requiere una acción para la que no dispones de una herramienta, indícalo claramente y explica qué puede hacer el cliente a continuación.

Esta estructura es deliberada. La primera sección define el ámbito del agente y facilita determinar qué consultas le corresponden. La segunda establece cómo debe responder y cómo actuar cuando no dispone de la capacidad necesaria para completar una solicitud.

Sobre instrucciones extensas

No es necesario anticipar cada conversación posible. Es preferible comenzar con pocas reglas claras y ajustarlas a partir de lo que muestren las pruebas reales, en lugar de escribir una instrucción exhaustiva desde el primer intento.

Definir los mensajes iniciales

Kivox permite configurar varios mensajes iniciales que el agente envía dentro de la misma conversación. En conjunto, estos mensajes presentan al asistente y dan la bienvenida al cliente.

Mensaje 1:

Hola. Soy el asistente de soporte de la tienda.

Mensaje 2:

Estoy aquí para ayudarle con pedidos, entregas y devoluciones.

Mensaje 3:

¿En qué puedo ayudarte?

[Captura de pantalla: Configuración de interfaz del agente mostrando el mensaje inicial y las sugerencias de conversación]

Probar el agente

Para validar el comportamiento del agente, inicie un nuevo chat en Kivox Studio con el agente seleccionado.

No se limite a una sola pregunta. Pruebe al menos tres situaciones distintas:

Una pregunta general que el agente debería poder responder con sus instrucciones actuales:

¿Cuánto tarda una entrega estándar?

Una pregunta que requiere información específica sobre un pedido:

¿Dónde está mi pedido 58291?

Una solicitud que requiere realizar una acción:

¿Puedes cancelar mi pedido 58291?

En esta etapa, sin una base de conocimiento ni herramientas conectadas, el agente no debería inventar información sobre el pedido ni afirmar que ha realizado una acción que no puede ejecutar. En su lugar, debería reconocer sus limitaciones y explicar qué información necesita o qué acción no puede realizar.

Este comportamiento es importante: un agente bien configurado reconoce cuándo no puede completar una solicitud, en lugar de improvisar una respuesta que parezca plausible. Verificarlo antes de añadir conocimientos o herramientas permite comprobar que las instrucciones básicas funcionan correctamente.

[Captura de pantalla: Chat del agente mostrando una conversación en la que el agente reconoce que no puede consultar un pedido específico]

Qué indica cada resultado

Si el agente responde bien a la primera pregunta pero improvisa en la segunda o la tercera, el problema no está en las instrucciones. Está en que la conversación necesita una capacidad que el agente todavía no tiene. Eso es lo esperado en este punto, y se resuelve añadiendo una base de conocimiento o una herramienta.

Si el agente responde con un tono distinto al esperado, o ignora alguna de las reglas definidas, el ajuste corresponde a las instrucciones. Modifíquelas y repita las mismas preguntas antes de dar por resuelto el cambio: comparar contra el mismo conjunto de pruebas es la forma confiable de saber si una modificación mejoró el comportamiento o simplemente lo cambió.