Crea tu primer agente

Un agente es un prompt del sistema, un modelo y un conjunto de canales, además del conocimiento, las herramientas y las habilidades que le adjuntes. En esta página, se recorre el formulario del agente campo por campo.

Antes de comenzar

Agrega la clave de API del proveedor de modelos que planeas usar en la configuración del espacio de trabajo. Sin ella, el agente se guarda, pero falla la primera vez que alguien habla con él.

Crear el agente

Abre Agents y selecciona New agent.
Completa Identity y System Prompt.
Elige los Channels en los que responde el agente.
Configura el modelo en AI Model Configuration.
Selecciona Create Agent.

Si el único canal que activaste es Web Chatbot, el agente se abre en el lienzo visual después de crearse, para que puedas adjuntar conocimiento y herramientas de inmediato. De lo contrario, regresas a la lista de agentes.

Los administradores del espacio de trabajo también ven Create with AI, que abre el Agent Builder: un agente que diseña y crea agentes por ti mediante una conversación.

Identidad

Campo	Qué hace
Agent ID	Obligatorio. Un identificador estable que se usa en las URLs de integración del agente. Letras, números, guiones bajos y guiones, hasta 100 caracteres. No se puede cambiar después de crear el agente.
Agent Name	Obligatorio. El nombre que las personas ven en la lista de agentes, en el selector del chat web y en el lienzo.
Description	Para qué sirve el agente. Se muestra en la lista de agentes.
Avatar	Después de guardar por primera vez, puedes establecer la URL de una imagen de avatar. Aparece junto a las respuestas del agente en el chat web.

Prompt del sistema

Las instrucciones que el agente sigue en cada turno: su rol, su público, su tono, lo que nunca debe hacer y cuándo derivar la conversación a una persona. Es obligatorio. El contador que aparece debajo del campo muestra su longitud en caracteres.

Escríbelo como si le dieras instrucciones a un nuevo miembro del equipo: el objetivo, el público, las reglas y qué hacer cuando tenga dudas.

Canales

Selecciona una tarjeta para activar o desactivar un canal. Web Chatbot, CLI y Google Chat vienen activados en un agente nuevo; desactiva los que no necesites. La configuración paso a paso de cada canal está en la descripción general de los canales.

Canal	Qué significa
Web Chatbot	El agente aparece en el selector del chat web del espacio de trabajo. Si está desactivado, se oculta del selector.
CLI	El agente se puede usar desde el cliente de línea de comandos de VirtuAI.
WhatsApp	El agente responde los mensajes de WhatsApp enviados al webhook que se muestra en sus URLs de integración.
Voice	Llamadas telefónicas a través de Twilio.
Web Voice Widget	Un widget de voz que puedes incorporar en tu sitio web. Requiere que Voice esté activado.
Telegram	Un bot de Telegram. Abre una tarjeta Telegram Configuration.
Slack	Un bot de Slack. Abre una tarjeta Slack Configuration.
Google Chat	El agente responde en los espacios de Google Chat.

Configuración de Telegram

Configuración completa: Telegram.

Campo	Qué hace
Bot Token	Obligatorio. El token que obtienes de @BotFather.
Bot Username	El nombre de usuario del bot sin `@`. Es necesario para generar vínculos de invitación.
Waiting Message	Se muestra mientras el agente trabaja en una solicitud.

Después de guardar por primera vez, la tarjeta también muestra lo siguiente:

Webhook Registration: Register Webhook hace que tu bot apunte a este agente y genera un secreto nuevo que Telegram envía con cada mensaje; Unregister libera el bot para que otro agente pueda usarlo. Telegram requiere una URL HTTPS pública.
Invite Link: + Generate crea un vínculo que autoriza a un usuario de Telegram a hablar con el bot. Los vínculos vencen después de 24 horas y se pueden usar una sola vez.
Authorized Users: los usuarios de Telegram que se unieron mediante una invitación. Revoke quita el acceso de un usuario.

Configuración de Slack

Configuración completa: Slack.

Campo	Qué hace
Bot Token	Obligatorio. El token OAuth de usuario del bot (`xoxb-…`) de la página OAuth & Permissions de tu app de Slack.
Signing Secret	Obligatorio. Se encuentra en la página Basic Information de tu app de Slack.
Waiting Message	Se muestra mientras el agente trabaja en una solicitud.

Los tokens de bot y los secretos de firma se cifran al guardarlos y nunca se vuelven a mostrar. En Telegram y Slack, uno guardado aparece marcado como Configured y su campo indica “Stored — leave blank to keep it”. Déjalo en blanco para conservarlo o escribe un valor nuevo para reemplazarlo.

Después de guardar por primera vez, la tarjeta muestra las dos URLs que debes pegar en tu app de Slack en api.slack.com/apps: Event Subscriptions → Request URL y Slash Commands → Request URL.

Configuración del modelo de IA

La tarjeta AI Model Configuration aparece siempre que haya un canal de texto activado, es decir, en todos los agentes, excepto en los que solo usan voz.

Campo	Qué hace
Provider	Google Gemini, Google Gemini (Vertex AI), OpenAI, Anthropic, Anthropic (Vertex AI), Local (Ollama) u OpenCode Go.
Model	El modelo que el agente usa de forma predeterminada. La lista muestra los modelos disponibles para el proveedor seleccionado.
Temperature	De 0.0 a 2.0. El valor predeterminado es 0.7. Los valores más bajos generan respuestas más coherentes, y los más altos, respuestas más variadas.
Max Output Tokens	La respuesta más larga que el modelo puede escribir en un turno. El valor predeterminado es 1000. El límite superior depende del modelo y se muestra debajo del campo.
Prompt Caching	Reutiliza el prompt del sistema y las definiciones de herramientas entre turnos para reducir el costo de tokens y la latencia. Está disponible para Anthropic, OpenAI y OpenCode Go. OpenAI almacena en caché de forma automática, por lo que, para OpenAI, el interruptor solo registra tu intención. No está disponible como interruptor para Gemini.
Thinking level	Solo se muestra para los modelos que lo admiten. Fast, Balanced (predeterminado) o Deep. Un razonamiento más profundo consume más tokens de salida y tarda más. El nivel se asigna a los niveles del modelo que elijas, por lo que sigue funcionando si cambias de modelo.

Debajo de los campos, está la lista de modelos permitidos en el chat web: los modelos que un empleado puede elegir en el chat web del espacio de trabajo cuando habla con este agente. Cada agente tiene su propia lista. Debes seleccionar al menos un modelo para poder guardar un agente que tenga un canal de texto activado.

Agentes locales (Ollama)

Con Local (Ollama), el modelo se ejecuta en la máquina del propio usuario a través de la CLI de VirtuAI. Estos agentes se usan desde la CLI, no desde el selector de modelos del chat web.

Model se convierte en una etiqueta de Ollama de texto libre, por ejemplo, qwen2.5-coder:7b. El modelo ya debe estar descargado en la máquina del usuario. Prefiere los modelos que admiten llamadas a herramientas.
Fallback provider (cloud) y Fallback model son obligatorios. Cuando la CLI u Ollama no están disponibles, el agente responde con el modelo de respaldo y muestra un aviso.
Max Output Tokens establece el límite de generación por turno de Ollama. No hay un máximo predefinido; alrededor de 4096 es un punto de partida seguro.

Configuración de voz

La tarjeta Voice Configuration se muestra cuando Voice está activado.

Campo	Qué hace
Voice Provider	Gemini o ElevenLabs.
Language	Solo para Gemini. El idioma en el que habla el agente, por ejemplo, inglés (EE.UU.), español (México) o portugués (Brasil).
Gemini Voice	Solo para Gemini. Una de las voces predefinidas de Gemini, como Aoede, Puck o Kore.
ElevenLabs Voice ID	Obligatorio con ElevenLabs. Encuentra los IDs de tus voces en tu panel de ElevenLabs.

Modo de agente Deep

El campo Harness, en Deep Agent Mode, elige cómo funciona el agente:

Classic: un agente conversacional estándar.
Deep: agrega planificación, habilidades, memoria a largo plazo y subagentes.

Consulta Agentes Deep para saber qué cambia y dónde se aplica el modo Deep.

URLs de integración

Después de guardar, vuelve a abrir el agente y expande Integration URLs. Cada entrada tiene un botón para copiar y pertenece solo a este agente, por lo que distintos agentes pueden atender distintos canales, números o bots.

Entrada	Úsala para
Web Chat UI	La página del chat web del espacio de trabajo.
Web Chat API, Web Chat API (Stream)	Llamar al agente desde tu propia aplicación, como una sola respuesta o como una transmisión.
Web Voice Widget, Voice WebSocket	El widget de voz web y su conexión de voz.
WhatsApp Webhook	La URL que debes configurar en Twilio para WhatsApp.
Google Chat Webhook	La URL que debes configurar en tu app de Google Chat.
Slack Events URL, Slack Slash Commands URL	Las URLs que debes configurar en tu app de Slack.
A2A Agent Card, A2A Endpoint (JSON-RPC)	Conectar el agente con otra plataforma de agentes mediante el protocolo Agent2Agent (A2A).

Cuando la aplicación obligatoria de claves de integración está activada, el Voice WebSocket aparece marcado con Requires X-API-Key. Es la única entrada que necesita la clave. WhatsApp y Google Chat se verifican con el mecanismo de su plataforma (una firma de Twilio, o un token de Google verificado con el número de tu proyecto).

Cuando Web Voice Widget está activado, la sección también muestra Web Voice Widget Embed Code, el fragmento HTML que debes pegar en tu sitio web. Consulta Widget de voz web.

Cambiar un agente existente

Abre el agente, haz los cambios y selecciona Update Agent. El Agent ID es fijo; todo lo demás se puede cambiar.

De forma predeterminada, un cambio guardado llega a todos los canales de inmediato. Activa el control de versiones en la parte superior del formulario para trabajar en un borrador y publicarlo cuando esté listo. Consulta Borradores y publicación.

Próximos pasos

Adjunta conocimiento, herramientas y subagentes en el lienzo visual.
Dale al agente conocimiento de la empresa con Bases de conocimiento.
Permite que realice acciones con Herramientas.
Mídelo con Evaluaciones.
Pruébalo con la lista de verificación para el lanzamiento.