Descargar e importar workflows

Los workflows se pueden descargar e importar como archivos. Esto sirve para hacer backups, mover un flujo entre entornos, compartirlo con el equipo o duplicar una estructura existente.

Descargar un workflow

1. Abrí el workflow en el editor.
2. Hacé clic en el menú de acciones.
3. Elegí Descargar workflow.
4. Atendium guardará directamente el archivo en tu dispositivo.

Antes de descargar, Atendium intenta guardar el workflow abierto. Si el guardado falla, la descarga no continúa: resolvé el error para no exportar una versión distinta de la que ves.

Qué incluye el archivo

El archivo descargado puede incluir:

• name: nombre del workflow.
• description: descripción.
• status: estado del workflow.
• nodes: nodos del canvas y su configuración.
• edges: conexiones entre nodos.
• finalOutputSchema: estructura esperada de la respuesta final.
• outputNodeId: nodo marcado como salida, si existe.

Ejemplo simplificado:

{
  "name": "Captura y calificación de leads",
  "description": "Recolecta datos y califica el lead.",
  "status": "draft",
  "nodes": [],
  "edges": [],
  "finalOutputSchema": {
    "content": { "caption": "" },
    "resources": []
  },
  "outputNodeId": "node-123"
}

Precaución

El archivo puede contener prompts, configuraciones de herramientas, IDs internos y estructura operativa del negocio. Compartilo solo con personas autorizadas.

Importar un workflow

1. Abrí la sección Workflows del agente.
2. Entrá al editor.
3. Hacé clic en el menú de acciones.
4. Elegí Importar desde archivo.
5. Seleccioná un archivo .json.
6. Revisá el canvas importado.
7. Guardá el workflow.

Al importar, el editor carga:

• Nombre y descripción, si existen en el archivo.
• Estado.
• Nodos.
• Conexiones.
• Schema final.
• Nodo de salida.

Si el archivo es inválido, el sistema muestra un error y no reemplaza el flujo actual.

La importación reemplaza en el editor el título, la descripción, el estado, los nodos, las conexiones y el schema final incluidos en el archivo. También reconstruye el Inicio visual y centra el canvas. No crea otro workflow: modifica el que está abierto.

Precaución

Revisá el canvas inmediatamente después de importar y confirmá el guardado. Si querés conservar intacto el workflow abierto, creá primero un borrador nuevo e importá allí.

Cuándo conviene exportar

• Antes de hacer cambios grandes.
• Antes de probar una refactorización del flujo.
• Para copiar un workflow entre agentes.
• Para enviar un caso al equipo de soporte.
• Para guardar una versión estable antes de activar una nueva.

Recomendaciones al importar

• Importá primero en un workflow en borrador.
• Revisá que todos los nodos estén conectados.
• Verificá que las salidas default estén conectadas.
• Probá el flujo completo antes de activarlo.
• Revisá herramientas, documentos y recursos, porque algunos IDs pueden depender del agente o entorno original.
• Confirmá que el nodo de salida sea el correcto.
• Usá Centrar vista si parte del grafo queda fuera del área visible.
• Reubicá notas, variables y mocks si el archivo proviene de una versión anterior del editor.

Duplicar un workflow

Para duplicar un flujo manualmente:

1. Descargá el workflow original.
2. Creá o abrí un workflow nuevo.
3. Importá el archivo.
4. Cambiá el nombre.
5. Ajustá prompts, herramientas o documentos si hace falta.
6. Guardá.

Enviar un workflow a soporte

Si necesitás que el equipo de Atendium revise un comportamiento, enviá:

• Archivo descargado del workflow.
• Mensaje de prueba que produjo el problema.
• Respuesta esperada.
• Respuesta obtenida.
• Captura o descripción de los logs de ejecución.