Skip to main content
A workflow is where you tell your Review Ops Agent how the work is done. Write what to check and which criteria to decide by as a policy, and a playbook the agent runs exactly as written is built from it. You will build, from scratch, a workflow that verifies the three documents a vendor submits — a certificate of good standing, a bank verification letter, and a beneficial ownership certification. The policy text and output schema used here can be copied as they are. Workflows are created and edited only in the dashboard; the API can read them. A project holds up to 10 workflows.

Decide these before you start

The last two rows become your output schema and the verdict criteria in your policy.

The four-step wizard

1

Step 1 — Basic information

Enter the name and description. The name is how this workflow is identified in the dashboard list and in API responses. The description is for your team and has no effect on how the analysis runs.
  • Name: Vendor Onboarding Document Verification Policy
  • Description: This is an example for KYB
Workflow creation step 1, basic information

Step 1 — entering the name and description

2

Step 2 — Policy definition

Write, in plain language, what you verify and against which criteria. The execution plan (the playbook) is built from this text, so most of a workflow’s quality is decided here.
If there is a source regulation or an internal standard the policy has to refer to, attach it as a policy document.
Workflow creation step 2, policy definition

Step 2 — entering the policy text. Attaching a document is optional.

A vague policy produces vague results. Do not write “check the documents” — write which entry you pull from which document, what you compare it against, and what verdict a mismatch produces. The techniques are in the policy writing guide.
3

Step 3 — AI model

Choose the AI model that will perform the analysis. Without a choice, the default model runs, and it is enough for most document verification.
Workflow creation step 3, AI model selection

Step 3 — AI model selection. Without a choice, the default model is used.

You do not choose the engines at this step. They are assigned automatically from the content of your policy. To see which ones were attached, check the playbook action list on the completion screen, or workflowActions[].engines from GET /workflows/:workflowId. What each engine does is in AI model and engines.
4

Step 4 — Output schema

Define the JSON structure you want back from an analysis. Add rows one at a time in the Field Builder, or paste a whole schema into the JSON Schema Input tab — the two convert to each other.
Workflow creation step 4, Field Builder

Step 4 — the Field Builder. Add Field builds the schema one row at a time.

Here is the full schema for this example. Paste it straight into the JSON Schema Input tab.
Workflow creation step 4, JSON Schema Input

The JSON Schema Input tab. A valid schema is confirmed at the top.

The types, constraints, and validation messages are collected in output schema.

After creation — checking the playbook

Saving generates the playbook from the policy text. It takes 2–3 minutes, and when it finishes the execution plan is laid out action by action.
Workflow creation complete screen

The completion screen — the playbook ID and the action list

This policy produced 8 actions. The policy clauses are decomposed into actions, and the engines they need are attached automatically.
Action names and the way the policy is decomposed differ every time. Feeding the same policy in again does not produce the same names. The table above is what this example actually produced; when your integration code refers to a step, use workId instead of the name.
Clauses that need no external lookup — steps 2 and 6 here — get no engine. Engines are assigned only to clauses that need one. Each action also gets reference notes generated with it: the sentences from the original policy the action is grounded in. When a verdict does not match your intent, check the reference notes before rewriting the policy — editing a workflow.

Keep your terms consistent

Using the same names in all three places makes a large difference to accuracy. If your policy says “certificate of good standing” but you upload the item as doc1.pdf, the agent may not connect that file to that document. Use the same name in the schema’s description too, so it is clear which document a field’s value came from.

Next steps

Quickstart

The full flow for running your first analysis through the API with the workflow you built.

Policy writing guide

How to write a policy that produces a stable verdict.

Editing a workflow

Changing action order, engines, and reference notes, and what regenerates.

Reading analysis results

The order to read a result in, and how to interpret it.