SQS Order Processor

Overview

Processes e-commerce orders from an SQS queue through a validation-then-fulfillment pipeline. The validator checks completeness, calculates totals independently, verifies inventory, and flags fraud signals. Concurrency control queues orders by customer_id to prevent duplicates. Middleware rejects malformed payloads with StopProcessing before the LLM runs. Approved orders get fulfillment records from a deterministic tool agent. Results are published to an SQS outbound queue.

Use cases

Architecture

Main template files

Install these files with connic init my-project --templates=sqs-order-processor. The CLI places agent definitions in a folder named after the template under agents/.

sqs-order-processor/
  agents/
    order-validator.yaml
    order-fulfiller.yaml
    order-pipeline.yaml
  tools/
    order_tools.py
  middleware/
    order-validator.py
  schemas/
    order-validation.json
  requirements.txt
  README.md

Get started

Install the template, create a Connic project, and deploy through a connected Git repository or the CLI.

1. 1

   Install and scaffold

   Install the SDK and create a project from this template.

   terminal

   Copy

   pip install connic-composer-sdk
   connic init my-project --templates=sqs-order-processor

   Then cd my-project

2. 2

   Deploy

   Choose a deployment method. A connected Git repository deploys on push; use the CLI for projects without a connected Git repository.

   Git integration

   1. 1

      In Connic: Project Settings → Git & Environments, connect the GitHub repository

   2. 2

      On the same page, map a branch (e.g. main) to the Production environment

   3. 3

      Push the scaffolded project to that repository

   terminal

   Copy

   git add .
   git commit -m "Add SQS Order Processor template"
   git push origin main

   CLI deploy

   1. 1

      In Connic: Project Settings → API Keys & MCP Auth, create an API key and copy project ID

   2. 2

      Run connic login in the project folder

   3. 3

      Use connic dev to try with hot-reload, connic test to run suites, or connic deploy for production

   terminal

   Copy

   connic login
   connic dev     # Ephemeral dev env with hot-reload
   connic test    # Run declarative test suites
   connic deploy  # Deploy to production

3. 3

   Connect and configure

   Add an SQS inbound connector for the orders queue and an SQS outbound connector for the fulfillment queue. Provide AWS credentials for both. Use a connic/* model, or add BYOK credentials under Project Settings → LLM Provider.

   Full connector setup guideQuickstart guideConnector docs