Un Agente de IA es un asistente que configuras en el Centro de IA: eliges su modelo, escribes su system prompt y decides qué Conectores puede usar. Para crear uno, ve a AI Center (Centro de IA) → Agents (Agentes), haz clic en Create agent, ingresa un nombre y el system prompt, elige un modelo y haz clic en Create agent. Luego puedes probarlo en la vista previa del chat y compartirlo con tus usuarios.
Por ejemplo, un "Copiloto Solar" puede enfocarse en la producción de los inversores y las fallas de strings, mientras que un "Analista de Energía" reporta consumo y eficiencia entre sedes. Ambos responden con los mismos datos de Ubidots, cada uno siguiendo sus propias instrucciones.
Requisitos
Un plan que incluya el Centro de IA. La cantidad de agentes que puedes crear depende de tu plan; consulta Centro de IA: descripción general, planes y créditos de IA.
Rol de propietario de la cuenta o administrador.
Nota: Las pantallas del Centro de IA están en inglés, así que en este artículo los nombres de botones y campos aparecen tal como los verás en pantalla. |
1. Crear un agente
En el menú de navegación, haz clic en AI Center → Agents. Verás una tarjeta por cada agente, con su modelo, su etiqueta, su nombre y su descripción. Usa Search agents... para encontrar uno.
Haz clic en Create agent. Se abre la página New AI Agent, con las pestañas Settings, Connectors y Advanced a la izquierda y la vista previa del chat a la derecha.
En Settings, ingresa el Agent name (nombre del agente), una Description (descripción) opcional y el System prompt. El system prompt es obligatorio.
En Advanced, elige el Model (modelo). Ahí también puedes ajustar Temperature, Max tokens y la retención cero de datos.
Haz clic en Create agent. Luego puedes probar el agente en la vista previa del chat, asociarle Conectores y seguir ajustándolo.
2. Configuración del agente
El nombre, la descripción y el system prompt están en la pestaña Settings. El modelo, la temperatura, el máximo de tokens y la retención cero de datos están en la pestaña Advanced.
Campo | Para qué sirve | Límites y valor por defecto |
Agent name | El nombre que ven los usuarios, por ejemplo "Copiloto Solar". | Obligatorio. Hasta 256 caracteres. |
Agent label | Se genera a partir del nombre y se usa en las llamadas a la API. | Solo lectura. No cambia si renombras el agente. |
Description | Un resumen corto de lo que hace el agente, visible en su tarjeta. | Hasta 8.000 caracteres. |
Model | El modelo de IA que usa el agente. Los modelos se agrupan en Premium, Balanced, Fast y Others, y cada uno muestra su ventana de contexto y su multiplicador de créditos. | Obligatorio. |
System prompt | Las instrucciones del agente: su rol, lo que sabe de tu operación y cómo debe responder. Se envía con cada mensaje. | Obligatorio. Hasta 8.000 caracteres. |
Temperature | Qué tan enfocadas o variadas son las respuestas. Los valores bajos producen respuestas más enfocadas. | De 0 a 1. Por defecto: 0,2. |
Max tokens | Límite superior de la longitud de cada respuesta. Si una respuesta lo alcanza, se corta con el aviso "Response truncated — the agent hit its max tokens limit". | De 256 a 64.000. Por defecto: 4.096. |
Chat icon y Primary color | Cómo se ve el agente en el chat (ícono y color principal). Reset to default los restablece. | Opcional. |
Starter messages | Preguntas sugeridas que ven los usuarios finales antes de empezar a conversar. Haz clic en Add starter message para agregar una. Esta pestaña aparece cuando está disponible en tu cuenta. | Hasta 5, de 200 caracteres cada una. |
Zero data retention (ZDR) | Si el proveedor del modelo de IA puede guardar o no una copia de los datos. Consulta la sección 4. | Activado por defecto. Solo el propietario de la cuenta puede cambiarlo. |
Elegir un modelo
Cada modelo tiene un multiplicador de créditos, que aparece como Credits: N× per token. Un modelo del grupo Fast responde rápido las consultas de rutina y consume menos créditos de IA; los modelos Premium son mejores para análisis largos de varios pasos y consumen más. Los modelos Balanced están en el medio y son un buen punto de partida. Consulta cómo funcionan los créditos de IA.
Si cambias el modelo de un agente existente, guárdalo antes de probarlo en la vista previa del chat.
Cómo escribir un buen system prompt
En el system prompt el agente aprende sobre tu operación. Uno útil suele incluir:
Rol: "Eres el asistente de mantenimiento de las bodegas de frío de ACME Alimentos."
Contexto: las sedes, los tipos de dispositivo y las variables que importan, sus unidades y los rangos normales o umbrales.
Cómo responder: idioma, extensión, formato (por ejemplo, primero un resumen corto y luego el detalle) y qué hacer cuando faltan datos.
Límites: temas que debe evitar, o cuándo decirle al usuario que contacte a una persona.
El system prompt se envía con cada mensaje, así que mantenlo enfocado: un prompt largo hace que cada respuesta consuma más créditos de IA.
3. Probar el agente en la vista previa del chat
El panel Chat preview, a la derecha de la página del agente, te permite conversar con él antes que nadie. Un agente nuevo debe guardarse primero; después, la vista previa funciona en modo de prueba (Testing mode — this conversation won't be saved): la conversación no se guarda.
Los cambios se aplican cuando guardas el agente, también en la vista previa del chat.
Debajo de cada respuesta ves los tokens usados, su costo, cuánto tardó y qué herramientas llamó el agente, para que puedas comparar modelos y prompts.
Haz clic en Reset conversation para empezar de nuevo.
4. Privacidad: retención cero de datos
En la pestaña Advanced del agente, el interruptor Zero data retention (ZDR) define cómo trata tus datos el proveedor del modelo de IA:
Activado (por defecto, aparece como Active): las instrucciones, los datos de los dispositivos y las respuestas se procesan para responder cada solicitud y luego se descartan. El proveedor del modelo de IA no guarda ninguna copia.
Desactivado (aparece como Off for testing): las solicitudes también pueden llegar a proveedores que guardan datos por un tiempo limitado. Úsalo solo para comparar modelos y vuelve a activarlo antes de poner el agente en producción.
Con ZDR activado o no, los proveedores de IA nunca usan tus datos para entrenar sus modelos.
Nota: Solo el propietario de la cuenta puede cambiar la retención cero de datos. Si un administrador la cambia, el guardado falla y no se conserva ningún cambio de ese guardado. Si el modelo del agente no admite ZDR, el interruptor muestra Not available; elige otro modelo para activarlo. |
5. Conectar el agente con datos y herramientas
Todos los agentes vienen con el Conector de Ubidots incorporado, así que pueden consultar tus dispositivos, variables, valores, estadísticas, eventos e incidentes sin configurar nada.
Para darle al agente datos o herramientas de otros sistemas, abre su pestaña Connectors (Conectores). Ahí ves los Conectores ya asociados (Attached) y los disponibles (Available to attach); haz clic en Attach o Detach y luego guarda el agente. Un agente nuevo debe guardarse una vez antes de poder asociarle Conectores. Esta pestaña aparece cuando los Conectores están disponibles en tu cuenta. Consulta Conectores.
6. Compartir el agente
Compartes un agente a través de un Canal: la consola web dentro de tu aplicación de Ubidots o WhatsApp. Los Canales controlan el acceso a los agentes: las reglas de acceso de cada Canal definen qué usuarios reciben qué agentes. Consulta Consola web para usuarios finales y Habla con tus Agentes de IA industrial por WhatsApp.
7. Editar o eliminar un agente
Editar
Haz clic en la tarjeta del agente, o abre su menú ⋮ y haz clic en Edit. Se abre la página Edit AI Agent con la configuración actual, en las mismas pestañas. Haz tus cambios y haz clic en Save changes. Si sales con cambios sin guardar, se te pregunta si quieres descartarlos.
Eliminar
Abre el menú ⋮ del agente, haz clic en Delete y confirma. Eliminar un agente no se puede deshacer. Las conversaciones que ya estaban abiertas con él dejan de aceptar mensajes nuevos, pero se pueden seguir leyendo, y los chats nuevos usan el agente de Ubidots. Mientras se elimina, su tarjeta muestra Deleting….
8. Usar un agente en el Chat
Ve a AI Center → Chat, haz clic en el nombre del agente, debajo del cuadro de mensaje, y elige tu agente en My Agents. Luego haz clic en New chat y haz tu pregunta. Consulta Centro de IA: descripción general, planes y créditos de IA para ver consejos sobre cómo preguntar.
Preguntas frecuentes
¿Qué datos puede ver un agente?
Un agente trabaja con los permisos del usuario al que le responde. En tu propio Chat, ese usuario eres tú; en un Canal, es el usuario final que inició sesión, así que cada usuario final solo recibe respuestas sobre los dispositivos y datos a los que ya tiene acceso.
¿Cuántos agentes puedo crear?
Depende de tu plan. Consulta la tabla de planes en Centro de IA: descripción general, planes y créditos de IA.
¿Por qué una respuesta se cortó a la mitad?
Llegó al Max tokens del agente. Sube el límite, o pídele al agente en el system prompt que dé respuestas más cortas.