Build your first workflow

An agentic workflow is a YAML file. This page creates the smallest workflow that runs: one AI step, started by hand, with no connections.

Before you begin

• You can sign in to your organization’s Anthara web app.
• Your deployment can run workflow workers. If a run fails before its first step starts, ask the person who administers your deployment to check the worker cluster.

Write the YAML

Save the following as hello-anthara.yml:

name: Hello Anthara
slug: hello-anthara
trigger:
  type: manual
llm_config:
  max_turns: 5
  max_budget_usd: 1

steps:
  - name: say-hello
    type: ai_task
    config:
      prompt: |
        Write one sentence that confirms this workflow ran.

Four fields are required at the top level:

Field	Rule
name	The name shown in the workflow list.
slug	Lowercase letters and digits, joined by single hyphens. It must be unique across your workflows.
trigger	Must have a type. manual means a person starts each run.
steps	A list with at least one step.

The llm_config block is optional. Here it caps the run at five agent turns and a budget of 1 US dollar. The example doesn’t set model, so the worker uses its default model.

Unverified

The create-workflow API of a local Anthara stack accepted this YAML. The run itself was not tested, because the local stack had no workers. If your organization routes workflows through the LLM Proxy, you may need to add a model line under llm_config that names a model registered on the Models page.

Create the workflow

1. Open Agentic Workflows and select Create Agentic Workflow.
2. Drop hello-anthara.yml onto the dialog, or paste the YAML into the editor.
3. Select Create.

If the YAML is rejected, the dialog lists what to fix. For example, a missing slug is reported as Missing required field: slug.

Run it

1. In the workflow list, select Run on the Hello Anthara row. This workflow has no inputs, so the run starts straight away. A workflow that declares inputs opens a Run Workflow dialog first.
2. Open the run. The Steps tab shows each step, its logs, and its output.

The run’s status is Running while the worker is active, and Completed when the step finishes. A run that could not finish shows Failed.

Next steps

• Let Claude Code draft a workflow for you. In a repository where the plugin is installed, type /anthara:workflow-builder and answer its questions. It writes a YAML file that you can drop into the same dialog.
• Read tickets or post to Microsoft Teams from a workflow. Both need a connection, which an admin sets up under Connections.