---
title: "Crear un agente"
description: "Decide qué trabajo hará tu agente, créalo paso a paso en el Dashboard, entiende su página y déjalo listo para atender en un canal."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un agente

Crea un agente cuando quieras que la IA atienda un nuevo tipo de llamada o de chat, por ejemplo la recepción de citas por WhatsApp o los recordatorios por teléfono. En el menú del Dashboard, los agentes se llaman **Trabajadores**. Esta guía va desde decidir qué hará el agente hasta tenerlo respondiendo en un canal.

## El camino completo

Tipo, nombre, idioma y objetivo.

Quién es, qué hace y qué no.

Los documentos que consulta.

Chat, llamada o WhatsApp de prueba.

Un número o el chat de tu sitio.

Revisar conversaciones y ajustar.

## Antes de empezar

- Necesitas un rol que pueda **Crear y ajustar agentes**, como **Diseño de agentes**, **Administración** o **Propietario**.
- Para darle un canal después necesitas un rol que pueda **Conectar canales: teléfono, WhatsApp y chat web**, como **Administración** o **Propietario**.

## Decide el trabajo del agente

Un agente hace bien un trabajo concreto. Antes de crearlo, responde tres preguntas:

1. **¿Por dónde lo van a buscar?** Las llamadas las atiende un agente de voz. WhatsApp y el chat de tu sitio web los atiende un agente de mensajería.
2. **¿Qué debe resolver?** Por ejemplo: dar horarios y sedes, agendar, confirmar citas o recoger datos para que tu equipo llame.
3. **¿Qué nunca debe hacer?** Por ejemplo: dar recomendaciones clínicas, prometer precios o atender quejas. Eso lo pasará a tu equipo.

Ejemplos para una clínica:

| Trabajo | Tipo de agente | Canal |
| --- | --- | --- |
| Contestar el teléfono de citas fuera de horario | **Contesta el teléfono** (voz) | Un número para llamadas |
| Llamar a confirmar las citas del día siguiente | **Contesta el teléfono** (voz) | Un número para llamadas o la línea compartida de salida |
| Responder dudas y agendar por WhatsApp | **Responde mensajes** (mensajería) | Un número de WhatsApp |
| Atender el chat de tu sitio web | **Responde mensajes** (mensajería) | El chat de tu sitio |

Un mismo agente de mensajería puede atender WhatsApp y el chat de tu sitio a la vez, y un agente de voz puede tener varios números. Cada canal, en cambio, responde con un solo agente.

> **El tipo no se puede cambiar**
>
> El tipo decide en qué canales trabaja el agente y qué ajustes tiene. Si te equivocas, crea otro agente del tipo correcto y elimina el primero.

## Crear el agente

1. En el menú, haz clic en **Trabajadores** y luego en **Crear trabajador**.

2. En **¿Qué clase de trabajador necesitas?**, elige una opción:

   - **Contesta el teléfono**: atiende llamadas entrantes y hace llamadas salientes, con su propia voz.
   - **Responde mensajes**: atiende por WhatsApp y por el chat de tu sitio. Escucha audios y lee fotos.

3. En **Empecemos por lo esencial**, completa:

   - **Nombre** (hasta 50 caracteres): así se presenta el agente. Al escribirlo aparece a su lado la cara del agente, la misma que verás en la lista y en su página.
   - **Idioma**: el idioma del saludo y de las respuestas. Puedes elegir español, inglés, portugués, francés, alemán, italiano, chino, japonés, coreano o árabe.
   - **Qué debe lograr** (opcional, hasta 600 caracteres): su objetivo en una o dos frases. Si lo dejas vacío, Raíz crea un asistente general.

   Ejemplo: Nombre "Sofía, recepción", idioma **Español** y en **Qué debe lograr**: "Responder dudas sobre servicios, sedes y horarios de Clínica Ejemplo y agendar citas de medicina general".

4. Continúa según el tipo:
   - Agente de mensajería: haz clic en **Crear trabajador** y sigue en el paso 6.
   - Agente de voz: haz clic en **Elegir voz**.

5. Solo para agentes de voz: en **Elige cómo suena**, haz clic en **Reproducir muestra** junto a cada voz para escucharla. Primero aparecen las voces grabadas en el idioma del agente, y la muestra suena en ese idioma cuando la voz lo tiene. Selecciona una y haz clic en **Crear trabajador**. El botón se activa cuando eliges una voz.

6. Espera unos segundos. En **Estamos dando forma a…** ves las instrucciones y el **Primer mensaje** que Raíz escribió, y luego **Guardando configuración**. Cuando termina, verás el aviso "… ya está listo" y se abre la página del agente.

Puedes volver atrás con **Atrás** sin perder lo que escribiste. Si cambias el idioma después de elegir una voz, tendrás que elegir la voz de nuevo, porque cada voz se ofrece para un idioma. La **X** de arriba cierra el asistente sin crear nada.

## Qué escribe Raíz por ti

Raíz no deja al agente vacío: arma unas instrucciones iniciales con lo que elegiste. Tu objetivo queda tal cual como **Objetivo principal**, y alrededor van estos bloques:

| Bloque | Qué dice |
| --- | --- |
| **Personalidad** | Quién es (el nombre que le diste) y que nunca adopta otro personaje. |
| **Entorno** | Si atiende una llamada en vivo o una conversación escrita. |
| **Comunicación** | En voz: hablar sin listas ni enlaces, decir números y fechas de forma natural, repetir lo que la persona deletrea, pedir que repitan si no entendió y avisar antes de una consulta que tome unos segundos. En mensajería: mensajes breves y confirmar nombres, documentos y teléfonos. |
| **Forma de trabajar** | Saludar, entender antes de proponer, pedir solo los datos necesarios, confirmar lo acordado y ofrecer más ayuda. |
| **Tono** | Una o dos frases por turno y una sola pregunta a la vez. |
| **Reglas** | No inventar información, verificar la identidad antes de compartir datos sensibles, pasar a una persona si se bloquea dos veces y no dar recomendaciones que no esté autorizado a dar. |

También escribe el saludo. En un agente de voz es el **Mensaje de bienvenida**, por ejemplo "Hola, te habla Sofía, recepción, ¿en qué te puedo ayudar?". En un agente de mensajería, el saludo de WhatsApp empieza en **La IA responde como quiera**, y puedes cambiarlo después.

Si el idioma del agente no es el español, estas instrucciones quedan escritas en inglés. Revísalas y adáptalas a tu clínica: son un punto de partida, no conocen tus servicios ni tus reglas (ver [Escribir las instrucciones](/raiz/write-instructions/)).

## La página del agente

Cada agente tiene su página. Ábrela desde **Trabajadores** haciendo clic en su nombre.

### El encabezado

- **El nombre y la cara del agente.** Haz clic en el nombre para cambiarlo.
- **El estado**: **Activo** o **Inactivo** (en pausa).
- **Sus canales**: **Llamadas**, **WhatsApp**, **Chat web**, o **Sin canales activos**.
- **Creado** y la fecha.
- **Los botones de arriba a la derecha**: **Llamada de prueba** (voz) o **Probar en WhatsApp** (mensajería), **Desactivar** o **Activar**, y el menú de tres puntos con **Mejoras del equipo** (mensajería), **Preguntar a IA**, que abre a Arbi, y **Eliminar agente**.

En un agente de voz, si sus últimos cambios no llegaron a las llamadas, verás además el aviso **No se pudo publicar** con el motivo (ver los problemas frecuentes al final).

### Las dos tarjetas de arriba

Estas tarjetas solo aparecen a quien puede **Crear y ajustar agentes**.

**Lo esencial.** Si al agente le falta algo sin lo que no puede trabajar, verás **Completa lo esencial**, con cuántos pasos están listos y el siguiente, por ejemplo "1 de 2 listos · Siguiente: define el saludo", y el botón **Continuar**. Cuando todo está, la tarjeta dice **La configuración esencial está lista** y ofrece **Probar llamada** o **Probar chat**.

**Por dónde atiende.** Si no tiene canal, verás **Todavía no tiene por dónde atender** y el botón **Conectar**, que te lleva a **Configuración › Canales**. Cuando tiene uno, la tarjeta dice dónde atiende, por ejemplo "Contesta en +57 555 0101" o "Responde en el chat de tu sitio", con el enlace **Gestionar**.

### Los bloques de configuración

Debajo, la configuración está ordenada en tres bloques. Cada agente solo ve lo de su tipo:

| Bloque | Agente de voz | Agente de mensajería |
| --- | --- | --- |
| **Base del agente** | **Identidad e instrucciones**, **Idioma y zona horaria** | Lo mismo |
| **Experiencia de llamada** / **Experiencia de chat** | **Voz**, **Saludo**, **Ritmo de conversación**, **Inteligencia** | **Saludo**, **Comportamiento del chat**, **Inteligencia** |
| **Trabajo y calidad** | **Herramientas y conocimiento**, **Datos que recopila**, **Reportes de conversaciones** | **Skills** y lo mismo que el de voz |

Cada fila muestra un resumen de lo que tiene, por ejemplo **Voz personalizada** o **Voz predeterminada**, el modelo o "3 documentos · 2 herramientas", y una etiqueta:

| Etiqueta | Qué significa |
| --- | --- |
| **Listo** | Ya está configurado. |
| **Pendiente** | Falta y el agente lo necesita para atender. Solo puede pasar en **Identidad e instrucciones** (si no tiene instrucciones) y, en un agente de voz, en **Saludo** (si no tiene **Mensaje de bienvenida**). |
| **Opcional** | Funciona con los valores predeterminados. Ajústalo si lo necesitas: por ejemplo, un agente de voz sin voz elegida usa la voz predeterminada. |

Haz clic en una fila para abrir su sección. Al guardar, la fila muestra por un momento una marca verde y su nuevo resumen.

## Termina de prepararlo

1. Revisa y ajusta las instrucciones: [Escribir las instrucciones](/raiz/write-instructions/). Para entender cómo las usa el agente, lee [Qué es promptear](/raiz/prompting/).
2. Dale los documentos que necesita: [Darle conocimiento](/raiz/knowledge/).
3. Ajusta su comportamiento, sus herramientas y lo que recopila: [Ajustes de un agente](/raiz/agent-settings/). Si es de voz, lee también [Voz y audio](/raiz/voice/).
4. Pruébalo: [Probar un agente](/raiz/test-an-agent/).
5. Asígnale un canal: [Canales](/raiz/channels/) o [Chat en tu sitio web](/raiz/web-chat/).

## Antes de atender pacientes

Revisa esta lista antes de asignarle un canal:

- **Identidad e instrucciones** está **Listo** y las instrucciones hablan de tu clínica: servicios, sedes, horarios, límites y cuándo pasar el caso a tu equipo.
- **Idioma y zona horaria** son los de tu operación, para que diga bien la fecha y la hora.
- El saludo es el que quieres. En voz, escuchaste el **Mensaje de bienvenida** en una llamada de prueba.
- En voz, elegiste y escuchaste la voz, y decidiste si se graban las llamadas.
- Tiene asignados los documentos que necesita, y todos dicen **Indexado**.
- Solo tiene las herramientas que necesita. Las que **Hacen cambios**, como agendar o cancelar, las revisaste una por una.
- Lo probaste con preguntas reales y difíciles, con datos ficticios, y revisaste esas conversaciones en **Conversaciones**.
- Tu equipo sabe quién atiende lo que el agente le pasa y recibe los avisos (ver [Avisos y reporte diario](/raiz/notifications/)).
- En WhatsApp, el número tiene su horario de atención y su perfil del negocio al día (ver [Canales](/raiz/channels/)).
- El agente está **Activo**.

## Pausar, activar o eliminar un agente

En la página del agente, arriba a la derecha:

| Acción | Qué hace | Qué pasa con las conversaciones |
| --- | --- | --- |
| **Desactivar** | Pausa al agente en todos sus canales: deja de responder y de llamar. Verás el aviso "Agente pausado" y el estado **Inactivo**. | Las conversaciones anteriores se conservan. En WhatsApp, los mensajes que lleguen se guardan, pero la IA no los responde: tu equipo puede atenderlos (ver [Atender una conversación de WhatsApp](/raiz/take-over-a-conversation/)). Las llamadas a sus números ya no las contesta este agente, y el chat de tu sitio deja de recibir visitantes. |
| **Activar** | Lo vuelve a poner en línea. Verás el aviso "Agente activado". | El agente vuelve a atender en sus canales. |
| **Eliminar agente** (menú de tres puntos) | Lo borra para siempre. Escribe su nombre para confirmar y haz clic en **Eliminar**. | Sus conversaciones se conservan en **Conversaciones**. |

**Activar** solo funciona cuando el agente puede atender en algún sitio: un canal conectado o, en un agente de voz, la línea compartida de salida de tu organización (ver [Voz y audio](/raiz/voice/)). Si no, el botón aparece desactivado y, al pasar el cursor, dice "Conecta y activa al menos un canal antes de poner el agente en línea".

Para eliminar un agente, antes quítale sus canales en [Canales](/raiz/channels/) (**Liberar el agente**) y espera a que terminen sus campañas activas. Si quieres que deje de atender solo por un tiempo, desactívalo en lugar de eliminarlo. Todas las opciones, paso a paso: [Pausar, apagar o eliminar un agente](/raiz/pause-or-delete-an-agent/).

## Problemas frecuentes

Tu rol no permite crear agentes.

**Qué hacer:** pide a quien administra tu equipo un rol que pueda **Crear y ajustar agentes** (ver [Equipo y permisos](/raiz/team/)).

Raíz no pudo guardar el agente. El asistente vuelve al paso anterior con tus datos.

**Qué hacer:** lee el mensaje que aparece debajo del aviso, corrige lo que indique y vuelve a hacer clic en **Crear trabajador**.

El tipo no se puede cambiar.

**Qué hacer:** crea un agente nuevo del tipo correcto y elimina el otro.

El agente no tiene dónde atender.

**Qué hacer:** pasa el cursor sobre el botón para ver el motivo y asígnale un canal en [Canales](/raiz/channels/).

No se puede eliminar un agente mientras un canal o una campaña activa lo usa.

**Qué hacer:** en [Canales](/raiz/channels/), usa **Liberar el agente** en cada canal suyo, espera a que terminen sus campañas y vuelve a intentarlo.

Sus últimos cambios no llegaron a las llamadas. El mensaje dice por qué:

- "Agrega instrucciones al agente": escribe sus instrucciones.
- "La voz elegida ya no está disponible": elige otra voz y guarda.
- "El servicio de voz no respondió": Raíz lo intenta de nuevo solo; espera unos minutos.
- "El servicio de voz rechazó la configuración del agente" o "Los ajustes de voz del agente no son válidos": revisa la voz, el saludo, las instrucciones y el **Ritmo de conversación**, y guarda de nuevo.

**Qué hacer:** corrige lo que indica y guarda. Si el mensaje pide contactar a soporte, usa **Soporte** en el menú.

Cada tipo de agente ve solo sus secciones: un agente de voz no tiene **Comportamiento del chat** y uno de mensajería no tiene **Voz** ni **Ritmo de conversación**.

**Qué hacer:** revisa el tipo del agente en la columna **Tipo** de **Trabajadores**.

Source: https://docs.getarbol.com/raiz/create-an-agent/index.mdx