Outils de Workflow

DocFlow MCP fournit 8 outils pour gérer et tester les workflows avancés.

list_workflows

Lister tous les workflows de l'organisation actuelle.

Paramètres : Aucun

Exemple de réponse :

[
  {
    "id": "a1b2c3d4-...",
    "name": "Invoice Approval",
    "version": 3,
    "enabled": true,
    "doc_types": ["INVOICE"],
    "workflow_type": "advanced",
    "created_on": "2025-01-15 10:30:00",
    "last_modified_on": "2025-03-20 14:22:00"
  }
]

get_workflow

Obtenir les détails d'un workflow spécifique, y compris sa structure de nœuds et d'arêtes.

Paramètres :

Paramètre	Type	Obligatoire	Description
workflow_id	string	Oui	UUID du workflow

Exemple de réponse :

{
  "id": "a1b2c3d4-...",
  "name": "Invoice Approval",
  "version": 3,
  "enabled": true,
  "doc_types": ["INVOICE"],
  "workflow_type": "advanced",
  "description": "Routes invoices based on amount",
  "advanced_config": {
    "nodes": [
      {"node_id": "when-1", "node_type": "when", "label": "Amount > 1000"},
      {"node_id": "then-1", "node_type": "then", "label": "Send for Approval"}
    ],
    "edges": [
      {"source_node_id": "when-1", "target_node_id": "then-1"}
    ]
  }
}

create_advanced_workflow

Créer un nouveau workflow avancé avec des nœuds et des arêtes.

Paramètres :

Paramètre	Type	Obligatoire	Description
name	string	Oui	Nom du workflow (3-126 caractères)
description	string	Non	Description optionnelle
nodes	array	Oui	Tableau de nœuds de workflow
edges	array	Oui	Tableau d'arêtes reliant les nœuds

Structure des nœuds

Chaque nœud nécessite :

Champ	Type	Description
node_id	string	Identifiant unique du nœud
node_type	string	when, then, and, or ou delay
position	object	Position {x: number, y: number} sur le canevas
label	string	Libellé d'affichage
card	object	Configuration de la carte (voir ci-dessous)

Structure des arêtes

Chaque arête nécessite :

Champ	Type	Description
edge_id	string	Identifiant unique de l'arête
source_node_id	string	ID du nœud source
target_node_id	string	ID du nœud cible
source_handle	string	success ou error (optionnel)
target_handle	string	input (optionnel)

Configuration des cartes

Les cartes définissent ce qu'un nœud fait. Utilisez list_cards ou sdk_list_cards_picker pour obtenir les cartes disponibles.

{
  "id": "card-uuid-here",
  "card_type": "document_type_is",
  "version": 1,
  "variables": [
    {"id": "var-uuid", "data": "INVOICE", "data_type": "string"}
  ]
}

Vous devez uniquement fournir id, card_type, version et variables pour chaque carte. Le serveur enrichit automatiquement les cartes avec les métadonnées d'affichage (svg, texte, catégorie) depuis la base de données.

Exemple de requête :

{
  "name": "Simple Invoice Router",
  "description": "Routes invoices to approval",
  "nodes": [
    {
      "node_id": "when-1",
      "node_type": "when",
      "position": {"x": 100, "y": 100},
      "label": "Document is Invoice",
      "card": {
        "id": "card-uuid",
        "card_type": "document_type_is",
        "version": 1,
        "variables": [
          {"id": "var-uuid", "data": "INVOICE", "data_type": "string"}
        ]
      }
    },
    {
      "node_id": "then-1",
      "node_type": "then",
      "position": {"x": 100, "y": 300},
      "label": "Send Notification",
      "card": {
        "id": "card-uuid-2",
        "card_type": "send_email",
        "version": 1,
        "variables": []
      }
    }
  ],
  "edges": [
    {
      "edge_id": "e1",
      "source_node_id": "when-1",
      "target_node_id": "then-1",
      "source_handle": "success",
      "target_handle": "input"
    }
  ]
}

Exemple de réponse :

{
  "success": true,
  "workflow_id": "new-uuid-here",
  "name": "Simple Invoice Router"
}

update_advanced_workflow

Mettre à jour un workflow avancé existant. Vous pouvez mettre à jour toute combinaison de nom, description, nœuds et arêtes.

Paramètres :

Paramètre	Type	Obligatoire	Description
workflow_id	string	Oui	UUID du workflow à mettre à jour
name	string	Non	Nouveau nom
description	string	Non	Nouvelle description
nodes	array	Non	Nouveaux nœuds (remplace tous les nœuds existants)
edges	array	Non	Nouvelles arêtes (remplace toutes les arêtes existantes)

Exemple de réponse :

{
  "success": true,
  "workflow_id": "a1b2c3d4-..."
}

delete_workflow

Supprimer un workflow par ID (suppression logique).

Paramètres :

Paramètre	Type	Obligatoire	Description
workflow_id	string	Oui	UUID du workflow à supprimer

Exemple de réponse :

{
  "success": true,
  "workflow_id": "a1b2c3d4-..."
}

test_advanced_workflow

Tester l'exécution d'un workflow avancé. Vous pouvez optionnellement fournir un ID de document pour tester avec un document réel.

Paramètres :

Paramètre	Type	Obligatoire	Description
workflow_id	string	Oui	UUID du workflow avancé
doc_id	string	Non	UUID d'un document pour le test

Exemple de réponse :

{
  "success": true,
  "workflow_id": "a1b2c3d4-...",
  "execution_time": 0.234,
  "workflow_result": "completed",
  "node_results": {
    "when-1": {"status": "success", "output": true},
    "then-1": {"status": "success"}
  },
  "logs": [
    {
      "node_id": "when-1",
      "node_type": "when",
      "status": "success",
      "error": null,
      "duration_ms": 12
    }
  ]
}

list_test_scenarios

Lister tous les scénarios de test de workflow pour l'organisation.

Paramètres : Aucun

Exemple de réponse :

[
  {
    "id": "scenario-uuid",
    "name": "Invoice over 1000 EUR",
    "workflow_id": "a1b2c3d4-...",
    "enabled": true,
    "status": "passed",
    "last_run": "2025-03-20 14:00:00"
  }
]

list_cards

Lister toutes les cartes de workflow disponibles avec leurs conditions et configuration.

Paramètres : Aucun

Exemple de réponse :

[
  {
    "id": "card-uuid",
    "text": "Document Type Is",
    "card_type": "document_type_is",
    "card_version": 1,
    "category": "Document",
    "when_condition": true,
    "and_condition": false,
    "then_condition": false
  },
  {
    "id": "card-uuid-2",
    "text": "Send Email Notification",
    "card_type": "send_email",
    "card_version": 1,
    "category": "Communication",
    "when_condition": false,
    "and_condition": false,
    "then_condition": true
  }
]

Les cartes ont des indicateurs de rôle : when_condition (déclencheur), and_condition (condition supplémentaire) et then_condition (action). Utilisez-les pour déterminer dans quels types de nœuds une carte peut être utilisée.