# Crea tu primer agente # Crea tu primer agente Este es el camino de principio a fin para construir un agente de voz con IA: créalo, configura las pestañas del constructor, pruébalo en voz y chat, y luego publícalo. Cada pestaña tiene su propia página de profundización — esta las une en el orden en que realmente las trabajarás. ## Antes de empezar - Necesitas una cuenta con permiso para construir agentes — un **administrador de la organización** o un **gerente de proyecto** del proyecto. Consulta [roles](../organization-login#roles-y-permisos). - Decide a qué **proyecto** pertenece el agente, ya que el proyecto establece la zona horaria y el idioma. Consulta [Proyectos](../organization-login#proyectos). ## Paso 1 — Crear el agente ![La pestaña Agent](/img/screenshots/portal/agent-tab.png) *La pestaña Agent: nombre, proyecto, descripción, prompt del sistema y el análisis en vivo de la fortaleza del prompt.* Abre el constructor de agentes en **/agent/setup** y empieza en la pestaña **Agente**. Aquí es donde viven la identidad del agente *y* las palabras que dice. 1. Dale al agente un **nombre** claro. 2. Agrega una breve **descripción** de lo que hace. 3. Elige el **caso de uso** que coincida con tu objetivo. 4. Elige una **plantilla** desde la que empezar, si alguna encaja — las plantillas rellenan ajustes sensatos que puedes cambiar después. 5. Escribe el **prompt del sistema** — el conjunto de instrucciones central que define quién es el agente y qué debe hacer. 6. Configura el **saludo** (la primera línea cuando se conecta una llamada) y los mensajes de **fin**, **respaldo**, **ocupado** y **buzón de voz**. Guarda para crear el agente. Ahora puedes recorrer el resto de las pestañas. :::note[El prompt y los mensajes viven en la pestaña Agente] El prompt del sistema, el saludo y los mensajes clave están todos en la pestaña **Agente** — no en la pestaña **Behavior** (Engine). Esa pestaña ajusta el *ritmo* (interrupciones, silencio, muletillas), no lo que el agente dice. ::: ## Paso 2 — Configurar las pestañas centrales Recorre las pestañas, guardando a medida que avanzas. No necesitas cada pestaña para una primera versión — las cuatro de abajo son las esenciales. ### Modelo de lenguaje En la pestaña **[LLM](./llm)**, primero elige el **modo de pipeline de voz** (impulsa toda la llamada), luego elige el **proveedor y modelo** de LLM, configura la temperatura, los límites de tokens y un modelo de respaldo. Esto decide cómo razona el agente y cuán consistente suena. ### Voz y audio En la pestaña **[Voz y audio](./voice-audio)**, elige cómo escucha y habla el agente: elige un proveedor y modelo de **voz a texto** y un proveedor, modelo y voz de **texto a voz**, luego ajusta los controles específicos del proveedor. ### Comportamiento de la conversación En la pestaña **[Motor](./engine-behavior)**, ajusta el *ritmo*: barge-in y manejo de interrupciones, relleno de detección de actividad de voz, retardo de respuesta, manejo del silencio y muletillas. El prompt del sistema, el saludo y los mensajes se configuran en la pestaña **Agente**. ### Llamadas En la pestaña **[Llamadas](./calling-telephony)**, configura el uso entrante y saliente, la duración máxima de la llamada, el corte automático, los números asignados y los webhooks. (La transferencia de llamada se configura por separado, mediante la función "Transferir llamada" de Herramientas → Flujo de trabajo.) ## Paso 3 — Agregar conocimiento y herramientas (opcional) Una vez que lo básico suene bien, haz al agente más capaz: - **[Conocimiento y RAG](./knowledge-rag)** — en la pestaña **Model** (LLM), activa RAG, vincula una base de conocimiento para que el agente responda a partir de tus propios documentos, y ajusta la similitud y top-k. - **[Herramientas y MCP](./tools-mcp)** — dale al agente funciones, conecta servidores MCP y diseña flujos de llamada en el Constructor de Flujo de trabajo para que pueda tomar acciones reales durante una llamada. :::tip Construye por capas. Acierta primero con la voz y el saludo, confírmalo en una prueba, y luego agrega conocimiento y herramientas. Es mucho más fácil saber qué cambió cuando agregas una capacidad a la vez. ::: ## Paso 4 — Probar el agente Prueba el agente antes de que toque llamadas reales. El Portal te da dos superficies de prueba: - **Prueba de voz** en **/agent/interface** — habla con el agente y escúchalo responder con la voz y el comportamiento que configuraste. - **Prueba de chat** en **/agent/chat** — intercambia turnos de texto para comprobar el prompt y la lógica rápidamente, sin usar voz. Itera: ajusta una pestaña, guarda y prueba de nuevo hasta que suene y se comporte como quieres. ## Paso 5 — Publicar y poner el agente a trabajar Cuando el agente pase tus pruebas, publícalo. Publicar no es un flujo separado — en la pestaña **Agente**, activa el interruptor **Publicado** (y asegúrate de que el interruptor **Activo** también esté encendido). Un agente publicado y activo está listo para usarse en llamadas reales. Desde ahí: - apunta una **[campaña](../campaigns)** hacia él para ejecutar llamadas salientes, o - asígnalo para manejar llamadas **entrantes** (consulta [Llamadas y telefonía](./calling-telephony)). Cada llamada que maneja el agente se graba y analiza en [Registros de llamadas y analítica](../call-logs), donde encontrarás la grabación, la transcripción, el resumen de IA y el sentimiento para guiar tu siguiente ronda de ajuste. ## Próximos pasos - [Configura el LLM](./llm) - [Configura la voz y el audio](./voice-audio) - [Da forma al comportamiento de la conversación](./engine-behavior) - [Ejecuta una campaña con tu agente](../campaigns)