Skip to content

Describe what you want and let AgentX build the automation ​

In the workflow editor, you can describe an automation in plain English. An agent drafts the workflow (the steps, what starts it, and where the result goes), and you check it before using it.

Before you start ​

The person who installed AgentX needs to do this once:

  1. Terminal: switch the workflow engine on:
    sh
    agentx config set workflows.enabled true
  2. Terminal: restart the daemon (the AgentX background service): agentx daemon restart.

You also need at least one agent with a working model connection. It drafts the workflow.

Describe the automation ​

  1. Browser: open the dashboard. On the Hub, select Workflows in the nav, under Automation.
  2. Open the editor: select New workflow next to the page's title, or select a workflow's name, then Open in the editor.
  3. Select Ask AI to build… at the bottom right.
  4. Describe what should happen: when, from where, and where the result goes. For example: "Every Monday, summarize last week's GitLab issues and send the summary to Telegram."
  5. Press Enter and wait for the reply.

The workflow editor with the Ask AI to build… button

Check the draft and use it ​

  1. Read the reply and the proposed steps.
  2. Select Apply to canvas only when you are ready. It replaces the whole current workflow on the canvas.
  3. Select each step on the canvas and check its destination and settings in the side menu on the left, under This step.
  4. Select Save.
  5. Test it for real before relying on it: on the Hub's Workflows page, select Run… under the workflow, then Start the run. The editor's Preview only walks through the steps on screen; it doesn't run them.

Scripted authoring reply with Apply to canvas

A fixed demo response, shown through the real editor and daemon.

The report workflow after applying the proposal

Saving a workflow doesn't guarantee that it starts by itself: its state decides that. See Check that it worked.

In the scripted demo, type Build the demo report workflow. It returns a fixed three-step example without calling a real model. Other requests need a real model.

For step names and fields, see the workflow schema.

Check it worked ​

  1. Browser: the Hub's Workflows page lists the saved workflow.
  2. Its row says what starts it, in words.
  3. After a test run, a square for the run appears on its row, and the destination received the result.

If something is wrong ​

  • The editor answers with a 503 error or "no authoring agent available": no agent can draft workflows. The first registered agent drafts them, unless the installer sets AGENTX_WORKFLOW_AUTHOR_AGENT in .env to another agent's ID. Check that agent and its model login.
  • Requests fail and agentx daemon logs says Workflows: disabled: the engine is off. Do the steps in Before you start.
  • Your earlier workflow disappeared from the canvas: Apply to canvas replaced it. If you haven't saved, reload the page to get the saved version back.
  • In the demo, the reply doesn't make a workflow: only Build the demo report workflow works there.

Released under the MIT License.