Guides

Practical, task-oriented walkthroughs for building with ChatBotKit - agent architecture, security, and production deployment patterns for real-world agentic systems.

Application Architectures: How Your Users Map onto the Platform
A guide to the application shapes you can build on ChatBotKit, organized by the one decision that shapes all the others - how an end user maps onto a platform identity primitive. Covers CLI agents, embedded widgets, messaging agents, single-account and multi-account apps, portals, and white-label platforms.
Centralized Agents, Distributed Runtimes: Deploying at Scale
A deployment pattern where the agent's core - model, knowledge, tools, and policy - is built and managed centrally on ChatBotKit while a thin external runtime, built with the Go SDK, executes against it. Change the central agent once and every deployment's behavior changes with it.
Cost Control and Optimization: Budgets, Limits, and Policies
A guide to controlling spend on ChatBotKit, covering model economics, context-management options, plan and platform limits, sub-account isolation, and usage policies that throttle or pause runaway agents.
Measuring ROI: From Token Cost to Business Value
A guide to measuring the return on investment of AI agents, pairing exact per-agent cost from usage statistics with AI-extracted measures of the value each agent produces.
Agent Completion APIs: Picking the Right Endpoint for the Job
A guide to the conversation and task completion APIs on ChatBotKit. Covers stateless vs stateful conversations, streaming vs request/response, dispatch and background execution, and the distinction between time-bound dispatches and long-running tasks.
Agent Deployments: Environments, Accounts, and Production Pipelines
A comprehensive guide to deploying ChatBotKit agents across environments. Covers master and sub-account architectures, team-based access control, and the trade-offs between the Blueprint Designer, CLI imperative commands and solutions, SDKs, and Terraform deployment paths.
Cross-Account Access and Resource Sharing
A guide to how resources flow between accounts on ChatBotKit. Covers the private / protected / public visibility model, cross-account reference patterns, shared platform accounts, white-label and marketplace shapes, and the trade-offs around blast radius, rollback, and usage attribution.
Multi-Agent Coordination: Understanding the Limits
A guide to the mathematical and practical limits of multi-agent AI systems, covering Amdahl's Law, coordination overhead, the CAP theorem, and architectural strategies that actually scale.
AI Agent Security: Authentication, Tool Access, and Defense in Depth
A comprehensive guide to securing AI agents, covering credential management, tool exposure, model selection, prompt hardening, and the trade-offs between different authentication and tooling architectures.