Documentation
Learn how to run AgentZuno, build service workflows, and help your team get work done. Start with installation, then follow the guides for your role.
Start with your role
Admins install the app, connect services, and publish workflows and knowledge. Agents handle assigned requests and tasks. Users ask questions and submit requests. Read Only users review permitted records and reports without changing them.
Use AgentZuno
Install AgentZuno with Docker, complete database setup, create your workspace, and connect an AI provider before your first request.
Roles & FeaturesLearn what administrators, agents, employees, and read-only auditors can do in AgentZuno, with practical steps for everyday work.
Requests & TasksSubmit requests, manage fulfillment tasks and due dates, and collaborate with comments, private work notes, and mention notifications.
KnowledgeOrganize knowledge bases, topics, and articles, review proposed changes, publish guidance, and control who can read it.
WorkflowsBuild AgentZuno workflows through conversation or TypeScript, collect request details, route work, and review approvals before publishing.
Administration
Understand the Admin and support agents, structured tool calls, server authorization, separation of duties, and verified action results.
Connections & IdentityConfigure supported Slack, Microsoft Teams, and Gmail connections, identity settings, connector actions, and permission-aware responses.
Connect SlackInstall the Slack bot, configure OAuth and Events URLs, review bulk user matches, link accounts securely, and test permission-aware support conversations.
Database SetupChoose MongoDB or PostgreSQL for your installation, configure bundled or external connections, and understand database setup and recovery.
Deployment & HostingCompare AgentZuno hosting options, plan HTTPS and persistent services, and follow deployment guides for Render, AWS, or a Linux server.
Deploy on RenderDeploy AgentZuno with the included Render Blueprint, connect your database, configure domains and integrations, and verify backups and service health.
Deploy on AWSRun AgentZuno on AWS EC2 with Docker Compose, configure HTTPS and private ports, complete database setup, and plan backups or a managed ECS deployment.
Developer and operations
Use the optional AgentZuno workflow SDK for local TypeScript authoring, examples, offline tests, and runtime limits; no install is needed in the app.
Workflow Code ReferenceExplore the AgentZuno workflow TypeScript definitions for forms, routing, approvals, tasks, and permitted workflow actions.
Local DevelopmentSet up Node.js and local services to change AgentZuno itself, run the web app, API, and worker separately, and check your changes.
Security & SandboxReview AgentZuno security boundaries, workflow sandbox execution, access checks, credential handling, deployment requirements, and current limits.
TestingRun AgentZuno API, browser, authorization, and database tests with repeatable fixtures and safe development checks.
Backups & UpgradesPlan backups, protect encryption keys, restore workspace data, and review AgentZuno upgrade and recovery procedures.
Capacity TestingMeasure AgentZuno capacity with MongoDB and PostgreSQL, understand concurrency, and plan resources for your deployment.
