Importar y exportar workflows

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

Exportar un workflow

1. Abrí el workflow en el editor.
2. Hacé clic en el menú de acciones.
3. Elegí Exportar JSON.
4. Revisá el contenido en el modal.
5. Podés copiar el JSON o descargarlo como archivo.

El modal de exportación muestra también un checksum. Ese valor ayuda a comprobar que el contenido exportado no cambió.

Qué incluye el JSON

El JSON exportado 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 JSON 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 JSON.
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 JSON es inválido, el sistema muestra un error y no reemplaza el flujo actual.

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.

Duplicar un workflow

Para duplicar un flujo manualmente:

1. Exportá el workflow original.
2. Creá o abrí un workflow nuevo.
3. Importá el JSON.
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á:

• JSON exportado.
• Mensaje de prueba que produjo el problema.
• Respuesta esperada.
• Respuesta obtenida.
• Captura o descripción de los logs de ejecución.