Workflow Manage Tool
workflow_manageManage workflow template lifecycle: create, duplicate, validate, activate, and delete. Generate DAGs from natural language and estimate costs.
Instructions
Workflow templates — reusable DAGs that experiments and project runs execute. This tool covers metadata and lifecycle; for graph editing use workflow_graph. Lifecycle states: draft → active → archived. Activation is gated on validate passing.
Core actions:
list / get (read) — optional: status filter.
create (write) — name, description.
update (write) — workflow_id + any creatable field.
delete (DESTRUCTIVE) — workflow_id. Soft-deletes; running experiments continue on cached graph.
validate (read) — workflow_id. Returns errors[] (cycles, orphans, invalid types) and warnings[].
activate (write) — workflow_id. Requires validation to pass.
duplicate (write) — workflow_id. Creates a draft copy with the same graph.
AI / cost:
generate (write — costs LLM credits) — prompt. Decomposes natural language into a workflow graph and saves as draft.
estimate_cost (read) — workflow_id. Projected per-run credit cost.
suggestion (read — costs LLM credits) — context (object). Recommends improvements.
Advanced:
time_gate (write) — workflow_id, config (delay/window). Adds time-based gating around step execution.
execution_chain (write) — workflow_id, chain config. Configures sequential workflow chaining.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: list, get, create, update, validate, activate, duplicate, generate, estimate_cost, suggestion, time_gate, execution_chain | |
| deadline_ms | No | Optional: max wall-clock time (ms) the tool may spend. If exceeded during the call, returns a DEADLINE_EXCEEDED error. Minimum 100 ms. Leave unset for no deadline. | |
| status | No | Filter by status: draft, active, archived | |
| limit | No | Max results to return (default 10, max 100) | |
| workflow_id | Yes | The workflow UUID | |
| name | Yes | Workflow name | |
| description | No | Workflow description | |
| checkpoint_mode | No | Checkpoint durability mode: sync (safest, DB write per step), async (Redis buffer + background flush), exit (in-memory, flushed on completion). Default: sync | |
| budget_cap_credits | No | Maximum credits this workflow may consume per execution. Propagated to each experiment created from this workflow. Omit for no cap. | |
| observability_config | No | Observability provider config. Schema: {"provider":"langfuse|langsmith|none","enabled":true,"config":{"public_key":"...","secret_key":"...","host":"https://cloud.langfuse.com"}} | |
| title | No | Name for the new workflow (defaults to "<original name> (copy)") | |
| prompt | Yes | Natural language description of the workflow to create | |
| experiment_id | Yes | ID of the completed or evaluating workflow experiment to analyze. | |
| event_type | No | Filter by event type: started, completed, failed, waiting_time, waiting_human, skipped |