Workflow

When activated, the skill guides your AI tool through a structured workflow that mirrors the Versori integration lifecycle. Each step builds on the previous one, ensuring integrations are researched, built, tested, and deployed consistently.

The 8-step workflow

Scope Validation

The skill confirms that your request is related to data integration — ETL pipelines, API integrations, webhooks, data synchronisation, or similar tasks. If the request falls outside this scope, it lets you know and suggests alternatives.

Research

The skill prepares a structured research document covering:

The source and target systems involved
API endpoints, authentication methods, and data models
Field mappings between systems
Trigger types (webhook, schedule, or manual)
Implementation considerations such as rate limits, pagination, and error handling

This mirrors what the Plan agent does in the Versori platform UI.

System Setup

Using the research document, the agent runs CLI commands to bootstrap systems on the Versori platform:

versori systems create --name "Shopify" --base-url "https://my-store.myshopify.com"

It creates each system identified in the research phase and links them to your project.

Connection Creation

The agent creates authenticated connections for each system using the appropriate authentication method (API key, OAuth 2.0, etc.):

versori connections create --system <system-id> --auth-type api-key

See the Connections guide for details on authentication methods and connection configuration.

Code Generation

The agent generates TypeScript workflows using the Versori Run SDK. It writes workflow files that:

Define triggers (webhook or schedule)
Map data between source and target systems
Handle authentication via connections
Include error handling and logging

import { webhook, fn, http } from '@versori/run';

export const syncOrders = webhook('sync-orders')
    .then(
        fn('transform', (ctx) => {
            return { /* mapped data */ };
        })
    )
    .then(
        http('create-record', { connection: 'target-system' }, async ({ fetch, data }) => {
            const response = await fetch('/api/records', {
                method: 'POST',
                body: JSON.stringify(data),
            });

            return response.json();
        })
    );

Testing

The agent writes Deno test files for pure functions — data transformations, field mappings, and validation logic. This ensures your business logic is correct before deployment.

Verification

The agent runs local verification to catch issues before deployment:

deno check src/workflows.ts
deno test

Type errors and test failures are resolved before proceeding.

Deployment

Once verification passes, the agent deploys the integration:

versori projects deploy --environment production

See the Project Workflow guide for details on deployment, versioning, and monitoring.

What the skill handles vs. what you handle

The skill	You
Researches APIs, auth methods, and data models	Provides the integration requirements and context
Generates CLI commands to set up systems and connections	Reviews and approves system/connection configuration
Writes TypeScript workflow code using the Run SDK	Reviews generated code for correctness
Writes and runs tests for business logic	Provides test cases or edge cases to cover
Runs type checking and tests locally	Supplies API credentials and access tokens
Deploys via the CLI	Confirms the target environment

Example interaction

Your prompt:

Build an integration that syncs new Shopify orders to QuickBooks Online as sales receipts.
Use OAuth 2.0 Authorization Code for QuickBooks and API key for Shopify.
Run on webhook — trigger whenever a new order is created in Shopify.

What the skill does:

Produces a research document covering both Shopify and QuickBooks APIs
Creates systems for Shopify and QuickBooks on the platform
Sets up connections with the specified authentication methods
Generates a webhook workflow that receives Shopify order events, transforms the data, and creates sales receipts in QuickBooks
Writes tests for the data transformation logic
Runs verification and deploys

Plan agent — how Versori researches integrations
Connections guide — managing authenticated connections
Run SDK — the SDK used to build workflows
Project Workflow — CLI-based project lifecycle

Platform

Local Development

The 8-step workflow

What the skill handles vs. what you handle

Example interaction

​The 8-step workflow

​What the skill handles vs. what you handle

​Example interaction

​Related docs

The 8-step workflow

What the skill handles vs. what you handle

Example interaction

Related docs