Skip to main content

Agents

An agent is the core unit of Setod. Each agent has:

  • A goal — plain-English instructions describing what the agent should do
  • A schedule — cron-based or interval-based trigger
  • A set of connectors — the tools it can read from or act on
  • A set of skills — reusable behavioural rules
  • A token budget — daily limit to control cost

Creating an agent​

  1. Go to Agents in the sidebar
  2. Click New agent
  3. Fill in the name and goal
  4. Set a schedule (or leave off for manual-only runs)
  5. Attach connectors and skills
  6. Click Save

Running an agent​

  • Manual run — click the Run button on the agent card
  • Scheduled run — the platform triggers the agent automatically
  • Dry run — runs the agent but skips any write actions (safe for testing)

Agent health​

Each agent card shows a health indicator based on the last 20 runs:

  • ✅ Green — 80%+ success rate
  • ⚠️ Yellow — 50-80% success rate
  • ❌ Red — under 50% success rate

Lifecycle​

Agents can be in one of these states: Draft → Active → Paused → Archived. Only owners can publish, pause, or delete agents.