Primer Flujo de Trabajo

En esta guía construirás tu primer Canvas desde cero: un flujo RAG sencillo que recupera documentos y genera una respuesta. Al finalizar sabrás navegar el editor, configurar los nodos fundamentales y publicar el flujo como asistente.

Acceder al Canvas

Desde la barra lateral izquierda haz clic en Canvas (ícono de nodos). Se abre la lista de tus Canvas. Tienes dos opciones:

1. Desde una plantilla: haz clic en Nueva desde Plantilla, elige una de las 6 plantillas sectoriales y haz clic en Usar esta plantilla.
2. Desde cero: haz clic en Nuevo Canvas, asigna un nombre (por ejemplo "RAG Base") y haz clic en Crear.

Esta guía comienza desde cero.

La Interfaz del Editor

El editor se divide en tres zonas:

┌────────────┬─────────────────────────────┬──────────────────┐
│  Paleta    │        Workspace            │  Panel Config    │
│ (izquierda)│        (centro)             │   (derecha)      │
│            │                             │                  │
│ ○ Begin    │    [Begin] ──→ [Retrieval]  │  Componente:     │
│ ○ LLM      │       ↓                     │  Retrieval       │
│ ○ Retrieval│    [LLM] ──→ [Message]      │  topK: 10        │
│ ○ Message  │                             │  ...             │
│ ○ Switch   │                             │                  │
│ ...        │                             │                  │
└────────────┴─────────────────────────────┴──────────────────┘

Zona	Función
Paleta (izquierda)	Lista de los 15 componentes. Arrastra un componente al workspace para añadirlo al flujo.
Workspace (centro)	Área de trabajo principal. Puedes mover los nodos, trazar arcos entre puertos de output e input, y hacer zoom con la rueda del ratón.
Panel Config (derecha)	Al hacer clic en un nodo se abre su ficha de configuración. Todos los parámetros del componente son editables aquí.

Navegación en el workspace:

• Arrastrar: mantén presionado y arrastra para desplazar la vista.
• Zoom: rueda del ratón o botones +/- en la esquina inferior derecha.
• Seleccionar nodo: clic simple para seleccionarlo y abrir la configuración.
• Mover nodo: arrastra el nodo a la posición deseada.
• Crear arco: haz clic en el puerto de output de un nodo (punto en el borde derecho), mantén presionado y arrastra hasta el puerto de input del nodo siguiente.
• Eliminar arco: haz clic en el arco y pulsa la tecla Supr.

Construir el Flujo RAG Básico

El flujo que vas a construir es:

Begin → Retrieval → LLM → Message

Es el flujo mínimo para un asistente RAG: recoge la pregunta, recupera los documentos pertinentes, genera una respuesta y la muestra al usuario.

Paso 1 — Nodo Begin

El nodo Begin ya está presente en el workspace cuando creas un Canvas. Haz clic en él para abrir la configuración.

Parámetro	Valor
Mode	conversational
Input Fields	(deja vacío por ahora — la pregunta llega desde el campo de chat)

Con mode conversational, el nodo begin recibe automáticamente el texto del chat del usuario en la variable {{sys.query}}.

Mode task vs conversational

El mode task inicia el flujo una sola vez con un formulario estructurado (campos definidos en Input Fields). El mode conversational integra el Canvas como asistente de chat: el usuario escribe mensajes y el flujo responde. Para este primer ejemplo, conversational es la opción correcta.

Paso 2 — Nodo Retrieval

Desde la paleta, arrastra un Retrieval al workspace. Colócalo a la derecha de Begin. Arrastra un arco desde el puerto de output de Begin hasta el puerto de input de Retrieval.

Haz clic en Retrieval y configura:

Parámetro	Valor
Query	{{sys.query}}
topK	10
Documentos empresariales	Habilitado
Knowledge Base	Habilitado
Fuentes externas	Deshabilitado (por ahora)

El nodo Retrieval buscará en los documentos empresariales y en la Knowledge Base los 10 fragmentos más relevantes para la pregunta del usuario.

Paso 3 — Nodo LLM

Arrastra un LLM al workspace, colócalo a la derecha de Retrieval y conecta Retrieval → LLM.

Haz clic en LLM y configura:

Parámetro	Valor
Modelo	writer
System Prompt	Eres un asistente empresarial preciso. Responde en español basándote exclusivamente en los documentos proporcionados. Si la información no está en los documentos, indícalo explícitamente. Cita siempre las fuentes con [N].
User Prompt	Documentos de contexto:\n{{retrieval_1.formalized_content}}\n\nPregunta del usuario:\n{{sys.query}}
Temperature	0.3
Max Tokens	2048

Referencia de variable

{{retrieval_1.formalized_content}} es el texto recuperado por el nodo Retrieval, ya formateado con los títulos de los documentos y los fragmentos relevantes. El nombre retrieval_1 es generado automáticamente por el Canvas (primer nodo Retrieval del flujo). Puedes verificarlo en el encabezado del nodo.

Paso 4 — Nodo Message

Arrastra un Message al workspace, colócalo a la derecha de LLM y conecta LLM → Message.

Haz clic en Message y configura:

Parámetro	Valor
Content	{{llm_1.content}}
Format	markdown
Show Citations	Habilitado

El nodo Message recoge el output del LLM y lo presenta al usuario con formato Markdown y citas interactivas.

Paso 5 — Verificar el Flujo

Antes de guardar, comprueba visualmente que:

• Los arcos sean: Begin → Retrieval → LLM → Message.
• Cada nodo tenga todos sus puertos de input y output conectados correctamente (los puertos sin conectar aparecen como círculos vacíos).
• No haya nodos aislados (sin arcos).

Guardar el Canvas

Haz clic en Guardar en la esquina superior derecha (o usa Ctrl+S). El Canvas se guarda con el estado actual del flujo.

Guardado automático

Queria guarda automáticamente los cambios cada 30 segundos durante la edición. El ícono de guardado en la parte superior indica el estado: disco lleno = guardado, disco con punto amarillo = cambios sin guardar.

Ejecutar y Probar

Ejecución de Prueba desde el Editor

Haz clic en Ejecutar Prueba (botón de reproducción en la parte superior). Se abre un panel inferior con un campo de texto. Escribe una pregunta de prueba — por ejemplo "¿Cuáles son las condiciones del contrato García?" — y pulsa Intro.

Observa el flujo en ejecución:

• Los nodos cambian de estado: gris (en espera) → amarillo (en ejecución) → verde (completado).
• El panel inferior muestra el output de cada nodo a medida que se produce.
• La respuesta final aparece en el Message con formato Markdown.

Si un nodo muestra estado rojo, haz clic sobre él para ver el mensaje de error en el panel de configuración.

Inspeccionar los Outputs de los Nodos

Durante o después de la ejecución, haz clic en cualquier nodo para ver:

• Las entradas recibidas (con los valores efectivos de las variables).
• Los outputs producidos (con los valores completos).

Esto es útil para verificar que las variables estén correctamente pobladas y que los datos fluyan como se esperaba.

Publicar como Asistente

Cuando el flujo funcione correctamente, puedes publicarlo:

1. Haz clic en Publicar en la esquina superior derecha.
2. Escribe una descripción opcional para los usuarios finales.
3. Elige Visibilidad:
   • Solo yo: visible solo para ti.
   • Equipo: visible para todos los usuarios de la organización.
   • Tema específico: disponible como asistente para un Topic definido.
4. Haz clic en Confirmar publicación.

Una vez publicado, el Canvas aparece en la lista de asistentes disponibles en el chat. Los usuarios lo encuentran en el menú Asistentes en la parte superior del chat y pueden seleccionarlo como interlocutor dedicado.

Proximos Pasos

Has construido tu primer Canvas funcional. Ahora puedes:

• Añadir lógica de enrutamiento: inserta un nodo Switch para gestionar distintos tipos de pregunta de forma diferente.
• Habilitar fuentes externas: en el nodo Retrieval, habilita Legal Sources, Pharma Sources u otras bases de datos externas.
• Añadir un formulario de entrada: cambia el mode de Begin a task y define los campos del formulario.
• Explorar los ejemplos: la página Ejemplos Prácticos muestra flujos progresivamente más complejos.
• Usar una plantilla: la página Plantillas Sectoriales ofrece puntos de partida listos para tu sector.

---

Queria v3.1.2 -- Canvas Agent Builder