# Run a workflow from an agent

> Let an agent invoke a published, permitted on-demand workflow instead of improvising its steps.

Canonical: https://valuechat.app/docs/skill-run-workflow
Category: AI skills

## Before you start

Use a test channel or sample conversation first. Confirm the result before applying the setup to production traffic.

## How it works

1. Prepare. Create an On demand workflow, choose its permitted inboxes, configure its steps and publish it. Event-only or draft workflows are not arbitrary callable tools.

2. Agent setup. Add Run workflow, select the actual workflow and describe the request conditions that justify using it. References identify the saved workflow rather than relying on an unlinked name.

3. Execution. The application validates workspace/channel permissions, runs the graph and returns its real execution result. Connected app steps wait for their provider response before later confirmations.

4. Ownership. An explicit assignment inside the flow uses the ordinary handoff path. After handoff or closing, the previous agent must not continue acting as owner. Calling a workflow does not automatically authorize another account or channel.

5. Failure and preview. A failed or uncertain action is not a successful flow; earlier external writes may already exist. Preview simulates actions without real provider calls. Cyclic parent/child calls are rejected.

## What to verify

- The expected channel, conversation, contact or execution is visible.
- The assignment matches the configured routing.
- No customer-facing message claims an action that failed.
- Activity or execution history explains the result.

## Need help?

support@valuechat.app. Never send API keys or passwords.