Introduction
What Assivy is and how its pieces fit together.
Assivy is an agent platform: a place to build AI agents with tools, subagents, and knowledge — and to watch every turn they take. The loop is short:
- Configure an agent: models, instructions, tools.
- Extend it with code: function tools, subagents, turn hooks.
- Observe it run: every turn is a trace with spans, metrics, and logs.
When an answer is wrong, you don't guess. You open the trace and see the model, the tool calls, and what each step said.
The pieces
Agents
Identity, instructions, and a model list with a default.
Chat & threads
Turns, threads, feedback, and memories.
Channels & embed
Widget, public page, SSO, and theming.
Subagents
Linked agents, derived helpers, and on-the-fly helpers — all on one sub-agent model.
Skills
Instruction packs agents load progressively.
Tools
The registry: standard, HTTP, function, and built-ins.
Function tools
TypeScript or Python tools that run sandboxed and log with levels.
Widgets
Server-driven UI trees with sandboxed actions.
Turn hooks
Code that runs before the turn: ground the prompt, log what you did.
Integrations
Apps, accounts, MCP servers, and triggers.
Knowledge
Library, folders, sources, datasources, tags.
Entities
Structured schemas with records and search.
Dashboard
Activity, answer quality, and anything waiting on you.
Observability
Traces, metrics, and logs for every turn.
Evaluations
Score past traffic against rubrics and code.
Background work
The jobs queue behind ingestion, syncs, and scheduled runs.
People & sharing
Members, roles, and per-resource audiences.
Model providers
Bring your own credentials and endpoints.
Settings
Keys, egress, guardrails, billing, org profile.
API reference
REST endpoints, auth, and the chat headers.
Talk to it anywhere
Agents chat in the web UI, through the REST API, or inside your own product via the embeddable widget and public chat page. All of them run the same turns and land in the same traces.
New here? Start with the quickstart: fresh checkout to first trace.