Guía de udev-ia

Todo lo que necesitas para usar udev-ia: desde tu primer mensaje hasta construir tus propios agentes con tools que llaman a tu CMS u otras APIs.

Tu cuenta y perfil

1
Te registras desde /register con nombre, correo, contraseña y aceptando la Política de privacidad.
2
Quedas autenticado de inmediato, pero udev-ia te pide verificar tu correo antes de dejarte usar el resto de la app: te envía un código de 6 dígitos que debes ingresar en esa misma pantalla.
3
Tu sesión se mantiene activa mediante una cookie de actualización (refresh token). Puedes revisar y cerrar sesiones abiertas desde Configuración → Seguridad.
4
Si más adelante cambias tu correo desde Configuración → General, se te pide confirmar el cambio con un código enviado al nuevo correo, igual que en el registro.

¿Ya tienes cuenta?

Inicia sesión desde /login. Si tienes la verificación en dos pasos activada, se te pedirá además un código que llega por correo. ¿Olvidaste tu contraseña? Desde /recuperar puedes restablecerla con un código enviado a tu correo — al hacerlo, se cierran todas tus sesiones activas por seguridad.

Tu perfil

Desde Configuración → General puedes cambiar tu nombre, tu foto de perfil y tu correo (con verificación por código).

Tu primer chat

1
Haz clic en Nuevo chat en la barra lateral.
2
Elige un modelo en el selector del cuadro de mensaje y escribe tu pregunta. Presiona Enter para enviar (Shift + Enter agrega un salto de línea).
3
La respuesta se transmite en tiempo real (streaming). El chat recibe un título automáticamente después del primer intercambio.
4
Usa Buscar chats en la barra lateral para encontrar rápido una conversación anterior por su título.
5
Debajo de cada respuesta puedes marcarla con o su opuesto para dejar feedback rápido sobre esa respuesta; haz clic de nuevo sobre el mismo botón para quitarlo.

El selector del cuadro de mensaje combina dos tipos de opciones: modelos (un proveedor + modelo de IA directo) y agentes (marcados con el ícono de robot) — ve la sección Chatear con un agente más abajo.

El clip para adjuntar archivos del composer es solo una vista previa por ahora: los archivos se muestran como chips pero todavía no se suben ni se envían al modelo.

Artefactos y archivos generados

Cualquier modelo o agente puede generar archivos durante la conversación — no es exclusivo de los agentes con tools propias. Cuando esto ocurre, udev-ia abre un panel lateral con una vista previa en lugar de mostrar el contenido en bruto dentro del mensaje.

1
Si la respuesta incluye un bloque de código html o un enlace a un archivo generado, verás aparecer un panel de artefacto junto al chat con una vista previa renderizada (para HTML, dentro de un iframe).
2
Desde ese panel puedes descargar el código fuente, o exportar el resultado como PDF o imagen con un clic — udev-ia renderiza el HTML en el servidor y te entrega el archivo final.
3
Si el archivo generado ya es un PDF, una imagen u otro tipo de archivo, el panel muestra un enlace de descarga directa en vez de una vista previa interactiva.

Esto funciona gracias a dos tools integradas que están disponibles siempre, sin configurar nada: create_file (para crear archivos de texto, CSV, JSON, SVG o imágenes) y create_pdf (para convertir HTML en PDF). Son distintas de las tools con endpoint propio que puedes crear para tus agentes — ve la sección Tools de un agente.

Proveedores y modelos

Antes de chatear necesitas al menos un modelo configurado. Esto se hace en dos pasos, desde Configuración → Modelos.

Paso 1 · Agregar un proveedor

Un proveedor representa una cuenta de IA: OpenAI, Anthropic, Google, Mistral, Azure, Cohere, un endpoint compatible con OpenAI (por ejemplo, un servidor propio o autoalojado), u otro tipo genérico. Dale un nombre y, si aplica, indica la URL del endpoint.

Paso 2 · Agregar un modelo

Dentro de un proveedor, agrega un modelo con un título, el identificador exacto del modelo (p. ej. gpt-4o-mini) y su token/API key. udev-ia intenta verificar el modelo automáticamente al guardarlo; verás un indicador de Verificado o Error.

Puedes desactivar un modelo con el interruptor de la lista sin eliminarlo — dejará de aparecer como opción en el composer, pero los chats existentes que lo usan siguen funcionando.

Seguridad de la cuenta

Contraseña: cámbiala desde Configuración → Seguridad. Por seguridad, udev-ia te envía un código de confirmación por correo que debes ingresar antes de que el cambio se aplique.
Verificación en dos pasos (2FA): actívala en la misma sección. Con 2FA activo, cada inicio de sesión pide un código adicional enviado a tu correo (puedes solicitar que te reenvíen el código si no llega). Para desactivarla también se te pide confirmar con un código por correo — así nadie puede apagarla solo con acceso a tu sesión.
Sesiones activas: revisa desde qué dispositivos hay sesión iniciada y ciérralas de forma remota si no las reconoces.
Exportar o eliminar tu cuenta: desde Configuración → Seguridad puedes descargar una copia de tus datos o eliminar tu cuenta de forma permanente (te pedimos tu contraseña para confirmar). Ver también Política de privacidad.

Agentes personalizados

Un agente es la función más avanzada de udev-ia: combina un modelo, unas instrucciones fijas (system prompt) y un conjunto de tools — acciones que el modelo puede invocar durante la conversación, como crear contenido en tu CMS.

Crear un agente

1
Ve a Mis Agentes en la barra lateral (o a Configuración → Agentes) y haz clic en Nuevo agente.
2
Ponle un nombre y, opcionalmente, una descripción para identificarlo en la lista.
3
Elige el modelo que usará el agente (debe existir un modelo ya configurado, ver la sección de arriba).
4
Escribe el system prompt: instrucciones fijas que el modelo recibirá en cada mensaje. Aquí defines su rol, tono y cuándo debe usar sus tools. Por ejemplo:
Eres un asistente editorial. Cuando el usuario te pida publicar contenido, usa la tool create_post con un título y cuerpo en HTML. Confirma antes de publicar.
5
Guarda. Puedes duplicar un agente existente (con sus tools) desde su menú de opciones, o entrar al detalle para agregarle tools (siguiente sección).

El agente del sistema

Además de los agentes que creas, tu cuenta tiene un agente del sistema fijo (etiquetado Sistema en Mis Agentes) pensado para administrar tus otros agentes por ti a través de la conversación.

Puede listar tus agentes y modelos disponibles, y crear agentes nuevos por ti simplemente describiéndole lo que necesitas — sin pasar por el formulario manual.
A diferencia de tus agentes personalizados, no usa tools con endpoint propio: sus capacidades vienen integradas y no se pueden editar desde Tools.
Igual que cualquier agente, necesita tener un modelo asignado antes de poder chatear con él — elígelo desde su tarjeta en Mis Agentes.

Tools de un agente

Una tool describe un endpoint HTTP que el modelo puede llamar. No necesitas escribir código: udev-ia genera la llamada automáticamente a partir de lo que configures.

1
Dentro del agente, ve a Tools → Agregar.
2
Nombre: el identificador que el modelo usará para llamar la tool (solo letras, números y guion bajo, sin empezar con número). Ejemplo: create_post.
3
Descripción: explica en lenguaje natural qué hace la tool y cuándo usarla — el modelo decide si la invoca basándose en este texto.
4
URL del endpoint y método HTTP por defecto del servicio que se va a llamar (por ejemplo, la API de tu CMS). Este método es solo el valor sugerido: el modelo puede indicar cualquiera de los cinco (GET, POST, PUT, PATCH o DELETE) en cada llamada según lo que necesite hacer — no hace falta crear una tool distinta por cada método.
5
JSON Schema del cuerpo: describe la forma exacta que debe tener el cuerpo de la petición. El modelo genera un objeto que cumple ese esquema. Ejemplo mínimo:
{ "type": "object", "properties": { "title": { "type": "string" }, "body": { "type": "string" } }, "required": ["title", "body"] }
6
Token (opcional): si tu endpoint requiere autenticación, pégalo aquí. Se guarda cifrado y se envía como Authorization: Bearer … en cada llamada.
7
Guarda. Puedes activar o desactivar la tool en cualquier momento con el interruptor de la lista, sin borrarla.

Cuando la llamada usa GET o DELETE, los campos del esquema se envían como parámetros en la URL (query string) en vez de en el cuerpo — así que puedes usar el mismo esquema para consultar, crear, actualizar o eliminar sin necesidad de una tool por cada acción.

El endpoint que configures recibirá peticiones reales desde el servidor de udev-ia cuando el modelo decida usar la tool. Usa siempre endpoints de tu confianza y prueba primero con datos que puedas revertir.

Chatear con un agente

1
Al escribir un mensaje, abre el selector del composer (junto al botón de enviar).
2
En el grupo Agentes, elige el agente que quieres usar en lugar de un modelo directo.
3
Envía tu mensaje con normalidad. Si el pedido coincide con lo que describe alguna tool, el modelo la invocará automáticamente, verá el resultado de la llamada HTTP, y redactará su respuesta final incorporando ese resultado — todo dentro de la misma respuesta, sin pasos extra de tu parte.
4
Si la llamada a la tool falla (por ejemplo, el endpoint responde con error), el modelo recibe ese error como resultado y puede explicártelo o intentar corregirse, en vez de que la conversación se rompa.
5
También puedes iniciar un chat directamente desde Mis Agentes con el botón de nuevo chat en la tarjeta de cada agente, sin pasar por el selector.

Preguntas frecuentes

¿Un agente puede tener varias tools?

Sí, sin límite. El modelo elige cuál usar (o ninguna) según tu mensaje y la descripción de cada tool.

¿Puedo reutilizar el mismo modelo en varios agentes?

Sí. Un modelo puede estar asignado a varios agentes a la vez; lo que cambia entre agentes es el system prompt y las tools.

Si elimino un proveedor, ¿qué pasa con sus modelos y agentes?

Eliminar un proveedor elimina también sus modelos. Los agentes que usaban ese modelo se quedan sin modelo asignado (deberás asignarles otro antes de poder usarlos).

¿Necesito confirmar mi correo para usar udev-ia?

Sí, una sola vez: justo después de registrarte, con un código de 6 dígitos. También se pide un código cada vez que cambias tu correo o tu contraseña desde Configuración.

¿Necesito un agente con tools para generar archivos?

No. Crear archivos o exportar a PDF funciona en cualquier chat, incluso sin un agente seleccionado — es una capacidad integrada del modelo, no una tool que debas configurar.