Lesson 356·M28 AI System Design
AI Automation Platform
OpenLearning Objectives
By the end of this lesson you should be able to:
- Explain the clarify: the automation's requirements (L356)
- Explain the workflows: the steps and the AI (L356)
- Explain the integrations: the connectors (L227)
- Explain the gates: the approvals (L228)
- Explain the AI shape: the automation's product (L356)
One-Line Definition
The AI automation platform is the protocol run on an automation product (L356) — the clarify (the users L162, the workflows L217, the integrations L227, the scale L356, L356), the workflows (the steps L217: the triggers L220, the actions L356, the AI steps L356), the integrations (the connectors L227: the CRM L351, the email L224, the Slack L225, L356), and the gates (the approvals L228: the human L208 on the high-risk L324, L356) — the workflows (L217), the integrations (L227), and the gates (L228), productized (L356).
The one-sentence interview answer: "The automation platform is the protocol, run (L356). The clarify (L356): the users (L162) — the builders (L356); the workflows (L217) — the automation (L356); the integrations (L227) — the connectors (L356); and the scale (L356) — the executions (L356) per day (L356). The workflows (L356): the steps (L217) — the triggers (L220) — the webhook (L220) and the schedule (L221); the actions (L356) — the API calls (L227); and the AI steps (L356) — the classify (L353), the generate (L356), the extract (L143). The integrations (L227): the connectors (L356) — the CRM (L351), the email (L224), the Slack (L225) — the OAuth (L239) and the scoped (L262) credentials (L356). The gates (L228): the approvals (L228) — the human (L208) on the high-risk (L324) — the L228 approval workflow (L228), productized (L356). The AI shape (L173): the automation (L356) — the workflows (L217) with the AI steps (L356), the integrations (L227), and the gates (L228) — the L230 architecture (L230), productized (L356)."
Mental Model
Think of the automation platform as the office's assembly-line kit. The kit (the platform, L356) builds the lines (the workflows, L217): the line's (L356) start (the trigger, L220) — the letter's arrival (the webhook, L220) or the bell (the schedule, L221); the stations (the actions, L356) — the sorting (the classify, L353), the drafting (the generate, L356); and the checkpoints (the gates, L228) — the manager's (L208) sign-off (L228). The kit's tools (the integrations, L227): the connectors (L356) — the CRM (L351), the email (L224), the Slack (L225) — with the scoped (L262) passes (L356). The office works because the lines are buildable, the tools are connected, and the checkpoints are signed (L356).
the assembly-line kit (the platform, L356)
┌────────────────────────────────────────────────────────┐
│ the lines (the workflows, L217) — the triggers (L220), │
│ the actions (L356), the AI steps (L356) │
│ the tools (the integrations, L227) — the connectors │
│ (L356) │
│ the checkpoints (the gates, L228) — the sign-offs │
│ (L208) │
└────────────────────────────────────────────────────────┘
The mental model is the kit: the lines, the tools, and the checkpoints (L356).
Visual Flow — One Workflow's Life
the trigger (L220)
│ the webhook (L220) · the schedule (L221)
▼
┌────────────────────── THE WORKFLOW (L217) ─────────────────────────┐
│ the AI step (L356): the classify (L353) · the generate (L356) │
│ the actions (L356): the API calls (L227) │
│ the integrations (L227): the CRM (L351), the email (L224) │
└──────────────────────────┬───────────────────────────────────────┘
▼
┌────────────────────── THE GATE (L228) ─────────────────────────────┐
│ the high-risk (L324) → the human (L208) approval (L228) │
│ the approved (L228) → the action (L356) · the denied (L356) │
└──────────────────────────────────────────────────────────────────┘
The flow is the workflow: trigger → steps → gate (L356).
How It Works — The Product, Part by Part
- The clarify (L356). The users (L162), the workflows (L217), the integrations (L227), the scale (L356).
- The workflows (L356). The steps (L217): the triggers (L220), the actions (L356), and the AI steps (L356).
- The integrations (L227). The connectors (L356): the CRM (L351), the email (L224), the Slack (L225) — the OAuth (L239) and the scoped (L262) credentials (L356).
- The gates (L228). The approvals (L228): the human (L208) on the high-risk (L324).
Note
The AI step is the platform's difference (L356). The senior answer names the AI's role (L356): the traditional automation (L230) — the deterministic steps (L356); the AI automation (L356) — the AI steps (L356) in the workflows (L217): the classify (L353) — the incoming email's (L224) intent (L356); the generate (L356) — the draft (L356); the extract (L143) — the fields (L356). The AI step (L356) is a step (L217) like any other (L356) — with the eval (L341) and the gate (L228) (L356).
Real Project Usage
- An automation SaaS (L357). The workflows (L217), the integrations (L227), the gates (L228).
- A CRM automation (L351). The lead (L351) → the AI classify (L356) → the outreach (L351).
- A support automation (L350). The ticket (L350) → the AI triage (L350) → the resolution (L350).
- A multi-tenant automation (L357). The per-tenant (L320) workflows (L217) and the credentials (L262).
- Anything automation (L230). The product (L356) — the workflows, the integrations, the gates (L356).
The through-line: the product is the automation's — the workflows, the connectors, and the gates (L356).
Interview Explanation
Say it in four moves:
- The clarify. "The builders, the workflows, the scale (L356)."
- The workflows. "The triggers (L220), the actions (L356), the AI steps (L356)."
- The integrations. "The connectors (L227) — the OAuth (L239), the scoped (L262)."
- The gates. "The approvals (L228) — the human (L208) on the high-risk (L324)."
Senior-Level Insights
- The workflow is the unit (L217). The steps (L217) — the triggers (L220), the actions (L356), the AI (L356) — the product's (L356) unit (L356).
- The AI step is the classifier and the generator (L356). The classify (L353) and the generate (L356) — the steps (L217) with the eval (L341) (L356).
- The connector is the scoped credential (L262). The OAuth (L239) and the scoped (L262) — the integration's (L227) least privilege (L314) (L356).
- The gate is the risk's (L228). The high-risk (L324) — the L228 approval (L228) — the L324 control (L324), productized (L356).
- The observability is the workflow's (L346). The executions (L356) — the traces (L330) and the evals (L341) — the L346 standard (L346), workflow-shaped (L356).
Common Mistakes
- The trigger-only (L356). The zap (L356) described as the trigger (L220) — the steps (L217) and the AI (L356) are the workflow (L356).
- The AI step un-evaluated (L341). The classify (L353) without the eval (L341) — the quality (L341) unknown (L356).
- The wide credentials (L314). The connector (L227) with the app's (L314) access (L356) — the OAuth (L239) and the scope (L262).
- The un-gated high-risk (L324). The refund (L324) automatic (L228) — the L228 gate (L228) (L356).
- The un-observed executions (L346). The workflows (L217) without the traces (L330) — the failures (L356) opaque (L356).
Best Practices
- Unit the workflows (L217) — the triggers (L220), the actions (L356), the AI (L356).
- Eval the AI steps (L341) — the classify (L353) and the generate (L356).
- Scope the connectors (L262) — the OAuth (L239), the least privilege (L314).
- Gate the high-risk (L228) — the L228 approval (L228).
- Observe the executions (L346) — the traces (L330) and the evals (L341).
Interview Questions
Q: Walk me through the automation platform.
A: The protocol, run (L356). The clarify — the builders, the workflows, the scale (L356). The workflows — the triggers (L220), the actions (L356), the AI steps (L356). The integrations — the connectors (L227). And the gates — the approvals (L228).
Q: What are the AI steps?
A: The steps (L217) with the AI (L356): the classify (L353) — the incoming email's (L224) intent (L356); the generate (L356) — the drafts and the summaries (L356); the extract (L143) — the fields from the documents (L353). Each AI step (L356) is a step (L217) in the workflow (L356), with the eval (L341) and the gate (L228).
Q: How do the integrations work?
A: The connectors (L227): the CRM (L351), the email (L224), the Slack (L225) — connected with the OAuth (L239) and the scoped (L262) credentials (L356) — the least privilege (L314) per connector (L356). The connector (L227) is the workflow's (L217) tool (L356).
Q: How do the gates work?
A: The L228 approval workflow (L228): the high-risk step (L324) — the refund (L324), the external send (L356) — pauses (L208) for the human (L208) — the approved (L228) continues, the denied (L356) stops (L356). The gate (L228) is the L324 control (L324), productized (L356).
Follow-Up Questions
- What's the clarify (L356)?
- What are the AI steps (L356)?
- How do the integrations work (L227)?
- How do the gates work (L228)?
- What's the observability (L346)?
Comparison Table — The Traditional vs the AI Automation
| The traditional (L230) | The AI (L356) | |
|---|---|---|
| The steps (L356) | the deterministic (L230) | the AI steps (L356) |
| The decisions (L356) | the rules (L356) | the classify (L353) |
| The quality (L356) | the tests (L296) | the evals (L341) |
| The gates (L356) | the conditions (L356) | the approvals (L228) |
The senior read: the AI steps with the evals — the automation, productized (L356).
Code Example — The Product, Applied
// The automation platform (L356) — the workflow with the AI (L356).
// 1 · THE WORKFLOW (L217) — the steps (L356).
const workflow = {
trigger: { type: 'webhook', path: '/ticket-created' }, // L220
steps: [
// THE AI STEP (L356) — the classify (L353).
{ type: 'ai', action: 'classify', input: 'ticket.text', output: 'category' },
// THE ACTION (L356) — the API call (L227).
{ type: 'action', connector: 'crm', call: 'create_ticket', map: { category: 'category' } },
],
};
// 2 · THE INTEGRATIONS (L227) — the scoped connectors (L356).
const connectors = {
crm: { oauth: true, scopes: ['tickets:write'] }, // L239, L262
email: { oauth: true, scopes: ['mail:send'] }, // L224, L262
};
// 3 · THE GATE (L228) — the high-risk approval (L356).
const gates = {
'ticket.refund': { approval: 'human' }, // L324, L228
};
// 4 · THE OBSERVABILITY (L346) — the executions traced (L356).
// the trace (L330) per execution · the eval (L341) on the AI steps (L356)
What the reader must SEE — the product, applied:
trigger: webhook → the start (L220)
ai classify step → the AI (L353, L356)
action + connector + scopes → the integration (L227, L262)
refund → human approval → the gate (L228, L324)
the trace per execution → the observability (L330, L346)
The workflows, the connectors, and the gates (L356).
Tip
The pair that defines the product: the AI step (the difference, L356) and the scoped connector (the trust, L262). Unit the workflows, eval the AI steps, scope the connectors, gate the high-risk — the automation, productized (L356).
Performance Notes
- The workflow is the execution's scale (L356). The executions (L356) per day (L356) — the workers (L266) and the queue (L270) (L356).
- The AI step is the cost (L334). The classify (L353) and the generate (L356) — the tokens (L332) per execution (L356).
- The connector is the latency (L227). The API calls (L227) — the timeouts (L356) and the retries (L256).
- The gate is the human's latency (L208). The approval (L228) — the hours (L356) for the high-risk (L324).
Debugging Scenarios
| Symptom | First check (L356) | The lever |
|---|---|---|
| The workflow fails | The trace (L330) | The failing step (L356) |
| The AI misclassifies | The eval (L341) | The golden cases (L342) |
| The connector overreaches | The scope (L262) | The least privilege (L314) |
| The high-risk slips | The gate (L228) | The L228 approval (L228) |
| The executions are opaque | The observability (L346) | The traces (L330) |
Quick Revision Notes
- The AI automation platform = the automation's product (L356): the clarify, the workflows, the integrations, the gates.
- The clarify: the builders (L162), the workflows (L217), the scale (L356).
- The workflows: the triggers (L220), the actions (L356), the AI steps (L356).
- The integrations: the connectors (L227) — the OAuth (L239), the scoped (L262).
- The gates: the approvals (L228) — the human (L208) on the high-risk (L324).
Cheat Sheet
AI AUTOMATION PLATFORM = the workflows, the integrations, the gates
THE CLARIFY (L356)
the users (L162) — the builders (L356)
the workflows (L217) · the integrations (L227)
the scale (L356) — the executions (L356) per day (L356)
THE WORKFLOWS (L356)
the triggers (L220) — the webhook (L220), the schedule (L221)
the actions (L356) — the API calls (L227)
the AI steps (L356) — the classify (L353), the generate (L356),
the extract (L143) — with the eval (L341)
THE INTEGRATIONS (L227)
the connectors (L356) — the CRM (L351), the email (L224),
the Slack (L225)
the OAuth (L239) · the scoped (L262) credentials (L356)
THE GATES (L228)
the approvals (L228) — the human (L208)
on the high-risk (L324) — the L228 approval (L228)
INTERVIEW, 4 MOVES
1 clarify "the builders, the workflows, the scale (L356)"
2 workflows "the triggers, the actions, the AI steps (L356)"
3 integrations "the connectors, the OAuth, the scopes (L227)"
4 gates "the approvals on the high-risk (L228)"Key Takeaways
Recap
- The AI automation platform is the protocol run on an automation product (L356): the clarify (L356), the workflows (L217), the integrations (L227), and the gates (L228)
- The clarify (L356): the users (L162), the workflows (L217), the integrations (L227), and the scale (L356)
- The workflows (L356): the steps (L217) — the triggers (L220), the actions (L356), and the AI steps (L356) — the classify (L353), the generate (L356), the extract (L143) — with the eval (L341)
- The integrations (L227): the connectors (L356) — the CRM (L351), the email (L224), the Slack (L225) — with the OAuth (L239) and the scoped (L262) credentials (L356)
- The gates (L228): the approvals (L228) — the human (L208) on the high-risk (L324) — the L228 approval workflow (L228), productized (L356)
- The AI shape (L356): the automation (L356) — the workflows (L217) with the AI steps (L356), the integrations (L227), and the gates (L228) — the L230 architecture (L230), productized (L356)
Check your understanding
Answer each one out loud. Then rate yourself honestly.
0/8What's the clarify (L356)?
What are the AI steps (L356)?
How do the integrations work (L227)?
How do the gates work (L228)?
What's the observability (L346)?
What's the connector (L227)?
What's the eval (L341)?
What is the automation's product (L356)?
A Closing Note — The Kit, Assembled
You now hold the product: the workflows, the integrations, and the gates — with the AI steps and the scoped connectors. The assembly-line kit is buildable — and the checkpoints need the sign-off (L356).
Next: the capstone shape — Multi-Tenant AI SaaS (L357).