2
Small in number, high in leverage. These agents decide routing and coordination, not business truth.
Agent Registry
Plan a small command layer and a stable set of specialist agents.
The platform should avoid the trap of spawning a new agent for every feature. Keep the command layer thin, push deterministic work into workflows and policies, and let specialists operate inside sharply bounded missions.
4
Domain experts that do real cognitive work such as semantic enrichment, research, or drafting.
1
Execution surfaces that act on approved decisions inside external systems.
1
Quality, consistency, and policy backstops that challenge outputs before release or writeback.
1
Monitoring and optimization helpers that keep the control plane healthy.
Registered agents
Every agent card carries mission, permission, tooling, and an automation boundary.
liveread onlycommand
Triage Director
Convert messy requests into the right execution lane and required inputs.
Inputs
Free-form task requestUser contextWorkspace metadata
Outputs
Workflow selectionMissing parameter checklist
Tools
Intent Router
internalMaps user requests onto registered workflows and agent families.
Automation boundary
Never writes to external systems.
Success signal
Requests land in the correct workflow on first pass.
pilotapproval requiredcommand
Supervisor Ops
Own cross-agent coordination, budget ceilings, and final answer assembly.
Inputs
Structured task briefSpecialist outputsApproval decisions
Outputs
Coordinated run planFinal delivery package
Tools
LangGraph Run Controller
approval-gatedStarts, pauses, resumes, and branches graph runs.
Cost Governor
internalPrevents runaway fan-out and unsafe retries.
Automation boundary
Cannot publish or write back without an approval artifact.
Success signal
Complex runs stay bounded while preserving answer quality.
livedraft onlyspecialist
Catalog Semantic Enricher
Transform Shopline product records into multimodal semantic profiles.
Inputs
Raw Shopline productImage observation setTaxonomy map
Outputs
Semantic profileEvidence chainQuality flags
Tools
Shopline Product Reader
readPulls product, variant, collection, and metafield records.
Vision Attribute Extractor
internalSeparates visual facts from higher-level inferences.
Automation boundary
Can stage semantic metadata but not write it back.
Success signal
Semantic profiles reach launch confidence without drifting from source truth.
pilotread onlyspecialist
Research Scout
Perform web-grounded market, trend, and competitor research.
Inputs
Research briefMarket constraintsExisting hypotheses
Outputs
Cited insightsTrend summariesRisk notes
Tools
Web Search
readFinds current information from trusted sources.
Source Notebook
internalStores sourced evidence for downstream agents.
Automation boundary
No write access to business systems.
Success signal
Recommendations remain current and traceable.
plannedread onlyspecialist
Knowledge Librarian
Retrieve SOPs, policy, and historical learnings from the internal corpus.
Inputs
Internal questionDepartment scopeFreshness hint
Outputs
Ranked passagesPolicy-backed answerConfidence note
Tools
Hybrid Retrieval
readBlends structured filters, full-text search, vector recall, and reranking.
Automation boundary
Retrieval only; no side effects.
Success signal
Answers cite the right internal source on the first attempt.
pilotdraft onlyspecialist
Document Crafter
Generate briefings, launch copy, SOP drafts, and delivery docs from structured context.
Inputs
Semantic profileCampaign briefApproval policy
Outputs
Draft documentReusable content blocks
Tools
Template Library
internalApplies approved narrative and formatting skeletons.
Automation boundary
Drafts only until a reviewer signs off.
Success signal
Output matches template, tone, and evidence requirements.
plannedapproval requiredoperations
Ops Executor
Push approved changes into Shopline, notification systems, and future business tools.
Inputs
Approved patch setDestination environmentRollback token
Outputs
Execution receiptAudit trail
Tools
Shopline Writeback
approval-gatedWrites approved metafields, content, or status changes.
Notification Bus
internalBroadcasts task outcomes and failures.
Automation boundary
Every external write requires an approval record or policy permit.
Success signal
Approved actions complete once and remain auditable.
liveread onlyreview
Review Guardian
Check quality, factual consistency, and launch risk before any user-facing or system writeback step.
Inputs
Draft outputEvidence setPolicy rules
Outputs
Pass/fail scorecardFix recommendations
Tools
Trace Inspector
readReads prior run steps, tool logs, and evidence chains.
Schema Validator
internalEnsures structured outputs stay contract-safe.
Automation boundary
Advisory only; cannot approve itself.
Success signal
Regression issues are caught before release or writeback.
pilotread onlyplatform
Platform Observer
Monitor cost, latency, approval backlog, and semantic drift across the control plane.
Inputs
Run telemetryCost streamSemantic quality samples
Outputs
Alert cardsTrend digestsOptimization suggestions
Tools
Trace Metrics
readReads run telemetry, tool counts, and failure trends.
Alert Rules
internalFlags runs that cross quality or cost thresholds.
Automation boundary
Observes and alerts only.
Success signal
Operators spot risk before users do.