Documentation
Build with Platos
The open source agent runtime. 51 reference docs covering the platform, engine, governance, observability, and developer experience surfaces.
Quickstart
From clone to first chat turn in ten minutes. Run docker compose, link a provider key, ship an agent.
Read the quickstartGuides
Task-oriented walkthroughs. Connect a backend, BYOK a provider, ship an eval, federate MCP tools.
Browse guidesInstall Platos in your AI assistant
Platos ships an MCP gateway. Wire Claude Code, Cursor, or Claude Desktop to your runtime in one command, then call agents and tools directly from your editor.
claude mcp add platos https://mcp.platos.dev/mcpPlatform
20 docsAgents
Durable, versioned agents with their own prompt, tools, models, memory, and budgets.
Agent versions, canary, rollback
Version every change to an agent and roll back instantly without losing conversation history.
Agent clusters
Group agents that share memory, threads, and user identity so a chat agent and a background agent feel like one.
Skills
Reusable agent behaviors with manifests, required env vars, and Claude-skills compatibility.
Official skills catalog
First-party skills shipped with Platos including code execution, csv-ops, and platos-rag.
Tools and tool routing
How Platos routes a tool call from the agent to a connected entity, a skill, or a meta-tool.
Connected entities
External backends that connect to Platos over WebSocket and expose their tools to agents without exposing their data.
Memory
Long-term, scoped, ratable memory that powers personalization without leaking across tenants.
Memory graph
Knowledge-graph view over memory, with entity nodes and relations extracted from conversations.
Conversations and threads
How a conversation is stored, encrypted, branched, forked, and threaded.
Chat and Postman mode
The agent chat playground and the Postman-style request console for inspecting tool pipelines.
Agent context
The four-tier context resolver that injects user, session, agent, and project values into tool calls and prompts.
Prompts
How Platos assembles a prompt, when it caches, and how prompt blocks compose.
Models
Pick a model per agent, compare two models head to head, and see which providers must be linked.
Providers and BYOK
Bring your own provider keys (OpenAI, Anthropic, etc.) and link them per environment with a checklist.
Evals
Define eval criteria once, run them against golden sets, and see ratings roll up per agent.
A/B evals
Compare two agent versions head to head on the same set of inputs.
Artifacts
Platos-generated structured outputs (markdown, code, html-sandboxed, json, csv, svg, image) that render consistently in any client.
Attachments and files
Upload files, images, and PDFs into a conversation and let the agent reference them as multimodal inputs.
Platos tasks (BGOs)
Long-running background operations spawned from agents via the spawn_bgo meta-tool.
Engine
6 docsRuns
trigger.devExecution records of trigger.dev tasks. The engine-layer primitive behind every BGO and tool block.
Schedules
trigger.devCron-style and one-shot scheduled trigger.dev tasks. Used by Platos for cost reconcile, approvals expiry, and memory extraction.
Queues
trigger.devtrigger.dev queues that gate task concurrency. Each Platos environment has at least one queue per task type.
Deployments
trigger.devCode-level deployments of trigger.dev task bundles. The engine equivalent of an agent version, but for the task code itself.
Batches
trigger.devGroup of trigger.dev runs spawned together. Used by Platos for the agent_batch meta-tool.
Waitpoints
trigger.devDurable wait-for-token primitive that lets a run pause for hours or days awaiting human or external input.
Governance
5 docsApprovals and HITL
Pause a tool call until a human approves or rejects, with durable waitpoints that survive restarts.
Budget caps
Per-agent and per-environment spend caps that throttle or block turns when the budget is exceeded.
Safety, PII, governance
Per-agent PII filters, safety event logging, and the governance dashboard that rolls them up.
Rate limits
Per-IP, per-token, per-agent, and per-environment rate limits enforced at the agent runtime.
Encryption and secrets
Where keys live, how conversations are encrypted at rest, and the single secret-store invariant.
Observability
5 docsMonitoring
Per-agent and per-user monitoring dashboards with cost, request volume, and ratings.
Traces
OpenTelemetry-style trace view of a single turn, with prompt + tool spans + cost samples.
Costs and spend
How Platos counts every input + output token, plus shadow spend on embeddings, extraction, and judge calls.
Metrics
Prometheus-style metrics endpoint and the custom dashboards that consume them.
Audit log
Append-only audit trail of admin actions and tool calls, scoped per environment.
Developer experience
15 docsFAQ
Common questions about Platos — what it is, how it compares, where to deploy, how to use it.
play.platos.dev — public playground (NOT production)
What play.platos.dev is, what it isn't, and where to deploy your real agents.
Scope tuple and multi-tenancy
The (organizationId, projectId, environmentId) tuple that gates every scoped row in Platos.
Auth modes and session tokens
Three auth modes (direct headers, session-token JWT, service secret on WS) plus user-token passthrough.
SDKs (TypeScript and Python)
First-party client libraries for Platos, including the consumer @platosdev/client and the entity-side platools SDKs.
React widget
Drop-in React FAB chat widget — three identity flows (anonymous form, OTP-verified, backend-authenticated), every per-turn agent option exposed, fully themable.
MCP gateway
Universal MCP endpoint that federates entity tools, trigger meta-tools, Platos skills, and the control plane.
MCP tokens and PATs
Personal Access Tokens (pmt_*) and OAuth 2.1 DCR flows for MCP clients.
OpenAPI and REST
The HTTP REST surface auto-generated from controllers, with a downloadable OpenAPI spec.
Webhooks
Outbound HTTP webhooks for conversation lifecycle events, run state transitions, and safety hits.
Public agents and embed
Share an agent publicly via a guest-token route, or drop in a web-component embed.
Self-hosting
Run Platos on your own infra with a single docker compose up. Postgres, Redis, ClickHouse, MinIO, agent, webapp.
Environments
Per-project dev/staging/prod environments with their own scoped env vars, providers, and queues.
Streaming and WebSocket events
Real-time stream of token deltas, tool calls, artifacts, and run updates over WebSocket.
Terms, privacy, security policy
Where to find Platos's legal documents, security disclosure process, and what each covers.
