# AgentStack documentation

> Guides for building, deploying, and operating AgentStack agents.

- [AgentStack documentation](https://www.agentstack.build/docs): Train, deploy, and operate an AI support agent across web, email, Slack, voice, and your own applications.
- [Actions](https://www.agentstack.build/docs/actions): Give your agent controlled capabilities for gathering information, using connected services, and handing conversations to people.
- [Action logs](https://www.agentstack.build/docs/actions/action-logs): Inspect recent action executions, filter failures, and use the recorded detail to correct configuration safely.
- [Action approvals and risk](https://www.agentstack.build/docs/actions/approvals-and-risk): Learn which actions are high risk, when a visitor must confirm them, and how execution safeguards work.
- [Cal.com](https://www.agentstack.build/docs/actions/calcom): Connect Cal.com scheduling to an agent using an API key and scoped event types.
- [Calendly](https://www.agentstack.build/docs/actions/calendly): Offer Calendly availability and booking through an agent with explicit event-type and connection controls.
- [Custom API](https://www.agentstack.build/docs/actions/custom-api): Define a controlled REST API action with explicit endpoint, parameters, and request templates.
- [Custom Button](https://www.agentstack.build/docs/actions/custom-button): Render a contextual link button in widget chat without making an external request from the action itself.
- [Client-Side Action](https://www.agentstack.build/docs/actions/custom-client): Ask code on your embedding page to run a named client-side action and show the visitor the outcome.
- [Custom Form](https://www.agentstack.build/docs/actions/custom-form): Render a host-defined, client-validated form inline in the live chat widget.
- [Escalate via Email](https://www.agentstack.build/docs/actions/escalate-to-email): Send a summarized conversation escalation to configured support email addresses.
- [Escalate to Inbox](https://www.agentstack.build/docs/actions/escalate-to-inbox): Create a helpdesk ticket so a teammate can take over an AI conversation.
- [Human Handoff](https://www.agentstack.build/docs/actions/human-handoff): Configure one deliberate path from an AI conversation to a person through email or Inbox.
- [Lead Collection](https://www.agentstack.build/docs/actions/lead-collection): Collect contact details during conversations and route captured contacts into your AgentStack workflow.
- [Slack action](https://www.agentstack.build/docs/actions/slack): Understand the runtime Slack action and the current dashboard configuration limitation.
- [Stripe](https://www.agentstack.build/docs/actions/stripe): Connect Stripe-backed customer billing information to an agent after verifying the visitor's identity.
- [Web Search](https://www.agentstack.build/docs/actions/web-search): Let your agent look up current public web information with a controlled result limit.
- [Analytics](https://www.agentstack.build/docs/analytics): Measure conversations, feedback, confidence, escalations, sentiment, topics, and performance for an agent.
- [Activity](https://www.agentstack.build/docs/analytics/activity): View individual conversations with shareable filters, exports, and controlled follow-up actions.
- [Confidence and retrieval](https://www.agentstack.build/docs/analytics/confidence-and-retrieval): Interpret confidence bands and retrieval-mode comparisons without treating them as a quality guarantee.
- [Escalations and performance](https://www.agentstack.build/docs/analytics/escalations): Read successful handoff volume, escalation rate, and approximate response-time percentiles with the right limits.
- [Export conversations](https://www.agentstack.build/docs/analytics/exports): Download filtered conversation data from Activity as CSV or JSON when your role has the Analytics export permission.
- [Sentiment and feedback](https://www.agentstack.build/docs/analytics/sentiment-and-feedback): Distinguish session sentiment from explicit per-message feedback and investigate negative signals carefully.
- [Topics](https://www.agentstack.build/docs/analytics/topics): Review detected conversation topics, curate names, and drill into the sessions behind them.
- [Build your agent](https://www.agentstack.build/docs/build): Configure an AgentStack agent’s knowledge, retrieval, behavior, appearance, and secure integrations.
- [Customize widget appearance](https://www.agentstack.build/docs/build/appearance): Configure the widget theme, launcher, brand colour, greeting, automatic opening, and legal links with a live preview.
- [Schedule Auto-Retrain](https://www.agentstack.build/docs/build/auto-retrain): Schedule recurring refreshes of eligible website and Notion knowledge, and review the retrain history.
- [Configure chat settings](https://www.agentstack.build/docs/build/chat-settings): Control how new conversations open, which prompts customers can select, and how voice input behaves.
- [Crawl a single page](https://www.agentstack.build/docs/build/crawl-page): Add one public URL as knowledge when a full website crawl would be too broad.
- [Crawl a website](https://www.agentstack.build/docs/build/crawl-website): Add a public website to an agent and check that its pages are ready for retrieval.
- [Add a custom domain](https://www.agentstack.build/docs/build/custom-domains): Verify a subdomain, provision SSL, and route it to an eligible AgentStack customer surface.
- [Add files as knowledge](https://www.agentstack.build/docs/build/files): Upload supported documents and images, monitor processing, and verify that extracted content helps the agent.
- [Configure general settings](https://www.agentstack.build/docs/build/general-settings): Set an agent’s primary model, instructions, public widget availability, avatar, allowed domains, and deletion state.
- [Use Notion as a source](https://www.agentstack.build/docs/build/notion): Connect a Notion workspace, select shared pages and databases, and keep the enabled knowledge synchronized.
- [Test in Playground](https://www.agentstack.build/docs/build/playground): Test an agent’s saved configuration with temporary model and prompt changes, then save the change that works.
- [Add Q&A pairs](https://www.agentstack.build/docs/build/q-and-a): Create a concise, canonical question-and-answer source for a policy, correction, or repeated customer question.
- [Retrain knowledge](https://www.agentstack.build/docs/build/retrain): Refresh eligible website and Notion knowledge after its source material changes.
- [Configure retrieval](https://www.agentstack.build/docs/build/retrieval): Choose how an agent searches its knowledge, tune confidence guidance, and test the result against real questions.
- [Secure public access](https://www.agentstack.build/docs/build/security): Restrict public access by geography, require verified customer identity, and choose session-resume behavior.
- [Manage knowledge sources](https://www.agentstack.build/docs/build/sources): Choose, add, monitor, and remove the knowledge sources an AgentStack agent can retrieve.
- [Configure webhooks](https://www.agentstack.build/docs/build/webhooks): Use the agent’s managed webhook portal to deliver supported events to your own endpoint.
- [Channels](https://www.agentstack.build/docs/channels): Configure how customers can reach an agent, and see which channel cards are not yet available.
- [Deploy the chat widget](https://www.agentstack.build/docs/channels/deploy): Embed an agent as a chat bubble or iframe and protect the live widget with an allowed-domain list.
- [Email channel](https://www.agentstack.build/docs/channels/email): Configure automatic customer-email support, outgoing identity and appearance, safety limits, and blocked senders.
- [Email domains](https://www.agentstack.build/docs/channels/email-domains): Where email domains are added and verified now, and what the old per-agent add route does.
- [Help Page](https://www.agentstack.build/docs/channels/help-page): Publish a standalone support page with branded chat, suggested prompts, voice input, and optional quick links.
- [Serve the Help Page from a path on your site](https://www.agentstack.build/docs/channels/help-page-proxy): Forward three routes from your own site to AgentStack so the Help Page answers at your own address, without a custom domain.
- [Connect customer channels](https://www.agentstack.build/docs/channels/legacy-overview): A short channel setup overview, kept from the earlier flat documentation path.
- [Slack channel](https://www.agentstack.build/docs/channels/slack): Connect Slack, configure inbound mentions and DMs, control outbound messages, and run a two-way Slack Connect support channel.
- [Voice Calls](https://www.agentstack.build/docs/channels/voice-calls): Enable real-time browser voice calls, choose a provider and safety settings, and test with normal credit usage.
- [Voice sessions and recordings](https://www.agentstack.build/docs/channels/voice-sessions): Review recent voice-call history, filter recordings, and understand playback availability and privacy limits.
- [Developers](https://www.agentstack.build/docs/developers): Build reliable AgentStack integrations with the embed, REST API, webhooks, and MCP.
- [Browser integration boundaries](https://www.agentstack.build/docs/developers/client-actions-and-forms): Keep browser input, supported widget forms, and privileged server actions separate.
- [Client-side forms](https://www.agentstack.build/docs/developers/client-side-forms): Register supported widget forms and handle verified webhook delivery.
- [Embed the widget](https://www.agentstack.build/docs/developers/embed-widget): Add an AgentStack chat widget to a public site.
- [Identity verification](https://www.agentstack.build/docs/developers/identity-verification): Manage contact verification and conversation resume windows through REST.
- [llms.txt](https://www.agentstack.build/docs/developers/llms-txt): Understand the generated machine-readable documentation index.
- [MCP clients](https://www.agentstack.build/docs/developers/mcp-clients): Configure supported coding and assistant clients from the MCP Server screen.
- [MCP scopes](https://www.agentstack.build/docs/developers/mcp-scopes): Request the minimum OAuth scope needed for an AgentStack MCP client.
- [MCP server](https://www.agentstack.build/docs/developers/mcp-server): Connect an MCP-capable client to AgentStack over Streamable HTTP.
- [MCP tools](https://www.agentstack.build/docs/developers/mcp-tools): Use AgentStack MCP tools safely with asynchronous source indexing and organization context.
- [Pagination and errors](https://www.agentstack.build/docs/developers/pagination-and-errors): Consume lists predictably and recover from REST API failures.
- [Rate limits](https://www.agentstack.build/docs/developers/rate-limits): Respect organization-wide REST API limits and retry failed requests safely.
- [REST API: actions](https://www.agentstack.build/docs/developers/rest-actions): Configure actions, review logs, and validate scheduling integrations.
- [REST API: agent sign-up](https://www.agentstack.build/docs/developers/rest-agent-signup): Let an AI agent create its own sandbox workspace and API key, then have a human claim it.
- [REST API: agents](https://www.agentstack.build/docs/developers/rest-agents): Create, inspect, update, and delete agents from a trusted backend.
- [REST API: analytics and activity](https://www.agentstack.build/docs/developers/rest-analytics): Export metrics and inspect activity sessions without treating them as raw chat logs.
- [REST API authentication](https://www.agentstack.build/docs/developers/rest-api-auth): Authenticate server-side calls to the AgentStack REST API.
- [REST API: API keys](https://www.agentstack.build/docs/developers/rest-api-keys): Inventory and revoke organization API keys.
- [REST API: audit logs](https://www.agentstack.build/docs/developers/rest-audit-logs): Query the organization audit trail and its filter vocabularies.
- [REST API: billing](https://www.agentstack.build/docs/developers/rest-billing): Read subscription, usage, credit, and plan-limit data.
- [REST API: channels](https://www.agentstack.build/docs/developers/rest-channels): Automate email and Slack channel configuration safely.
- [REST API: chat](https://www.agentstack.build/docs/developers/rest-chat): Request synchronous or streaming chat responses from a backend service.
- [REST API: contacts](https://www.agentstack.build/docs/developers/rest-contacts): Create, inspect, export, and maintain contact records.
- [REST API: conversations and notes](https://www.agentstack.build/docs/developers/rest-conversations): Inspect conversations, send messages, and manage durable notes.
- [REST API: custom domains](https://www.agentstack.build/docs/developers/rest-custom-domains): Attach, verify, and route a custom domain for an agent's public surfaces.
- [REST API: domains](https://www.agentstack.build/docs/developers/rest-domains): List every hostname your organization uses, grouped by hostname, with what each one does.
- [REST API: Help Center](https://www.agentstack.build/docs/developers/rest-help-center): Manage a Help Center site, its collections, articles, and redirects.
- [REST API: Help Page](https://www.agentstack.build/docs/developers/rest-help-page): Read and update an agent's standalone Help Page configuration.
- [REST API: inbox and teams](https://www.agentstack.build/docs/developers/rest-inbox): Automate ticket routing and keep human ownership explicit.
- [REST API: Notion connection](https://www.agentstack.build/docs/developers/rest-notion): Check organization Notion connectivity and manage which pages an agent indexes.
- [REST API: organization](https://www.agentstack.build/docs/developers/rest-organization): List organization members and pending invitations.
- [REST API: roles and members](https://www.agentstack.build/docs/developers/rest-roles): Manage custom roles with ownership and Enterprise constraints.
- [REST API: sources and ingestion](https://www.agentstack.build/docs/developers/rest-sources): Manage knowledge sources and observe asynchronous retraining work.
- [REST API: topics](https://www.agentstack.build/docs/developers/rest-topics): Curate agent topics and use topic statistics for review workflows.
- [REST API: voice calls](https://www.agentstack.build/docs/developers/rest-voice): List voice call records and fetch call recording playback URLs.
- [Webhooks](https://www.agentstack.build/docs/developers/webhooks): List supported webhook events and manage the delivery portal.
- [Control the widget](https://www.agentstack.build/docs/developers/widget-control): Coordinate supported widget behavior with the surrounding page.
- [Listen for widget events](https://www.agentstack.build/docs/developers/widget-events): Measure and coordinate the embedded chat experience without scraping it.
- [Get started with AgentStack](https://www.agentstack.build/docs/get-started): Learn the shortest path from an empty workspace to a grounded, tested, and deployed AI agent.
- [Claim a workspace an agent made](https://www.agentstack.build/docs/get-started/agent-sandbox): What the sandbox plan is, why an AI agent emailed you a 6-digit code, and how to take ownership of the workspace it built.
- [Agent best practices](https://www.agentstack.build/docs/get-started/best-practices): Design a focused, grounded agent that is easier to test, operate, and improve.
- [Get-started FAQ](https://www.agentstack.build/docs/get-started/faq): Answers to common questions about creating, grounding, testing, and deploying a first AgentStack agent.
- [Create your first agent](https://www.agentstack.build/docs/get-started/first-agent): Create an agent, ground it with a source, test known answers, and prepare it for a first deployment.
- [Choose a model](https://www.agentstack.build/docs/get-started/models): Balance answer quality, speed, and credit cost when you choose a model for an AgentStack agent.
- [Improve response quality](https://www.agentstack.build/docs/get-started/response-quality): Diagnose weak answers by testing sources, instructions, and models separately in Playground.
- [Use the REST API v1](https://www.agentstack.build/docs/guides/api): Create an API key, authenticate requests, call agents, and use the generated OpenAPI reference.
- [Manage billing and credits](https://www.agentstack.build/docs/guides/billing): Choose a plan, understand per-message credit costs, top up, and avoid service interruptions.
- [Embed the Chat Widget](https://www.agentstack.build/docs/guides/embed): Add the AgentStack chat bubble to any website — plain HTML or a framework — and avoid the two mistakes that make it silently fail to appear.
- [Resolve conversations in Inbox](https://www.agentstack.build/docs/guides/inbox): Route escalations to teams, take over safely, reply, add notes, and return a ticket to AI.
- [Connect integrations and actions](https://www.agentstack.build/docs/guides/integrations): Give agents approved access to scheduling, billing, search, handoff, and your own APIs.
- [MCP Server](https://www.agentstack.build/docs/guides/mcp): Connect MCP-compatible clients to your AgentStack organization to read agents, sources, and conversations and run admin operations from your editor.
- [Train your agent on your content](https://www.agentstack.build/docs/guides/sources): Add websites, pages, files, Q&A pairs, and Notion content, then keep them current.
- [Configure voice calls](https://www.agentstack.build/docs/guides/voice): Enable browser voice, choose a realtime engine or a model combination, set privacy controls, and review calls.
- [Help Center](https://www.agentstack.build/docs/help-center): Create a branded knowledge base for an agent, configure public access, and manage its articles.
- [Edit an article](https://www.agentstack.build/docs/help-center/article-editor): Write, save, publish, and resolve edit conflicts in a Help Center article.
- [Articles and collections](https://www.agentstack.build/docs/help-center/articles-and-collections): Organize Help Center content into collections and create draft or published articles with stable slugs.
- [Help Center Insights](https://www.agentstack.build/docs/help-center/insights): Review aggregate search, feedback, and estimated AI cost signals to improve Help Center content.
- [Languages and translations](https://www.agentstack.build/docs/help-center/languages-and-translations): Set a Help Center’s default language, and choose target languages for automatic translation.
- [Publish and control access](https://www.agentstack.build/docs/help-center/publishing-and-access): Publish a Help Center, set public or private visibility, and restrict private access by email domain.
- [Help Desk](https://www.agentstack.build/docs/help-desk): Use Inbox, tickets, contacts, and leads to let teammates take over customer conversations safely.
- [Help Desk access and plan gates](https://www.agentstack.build/docs/help-desk/access-and-plan-gates): Learn about the plan gate and the read, write, assignment, and team-management permissions for Help Desk.
- [AI and human handoff](https://www.agentstack.build/docs/help-desk/ai-and-human-handoff): Take over an AI conversation, write a human reply or note, and return the customer safely to AI when work is done.
- [AI Compose](https://www.agentstack.build/docs/help-desk/ai-compose): Rewrite an existing Inbox reply or note draft with operator review before anything is sent.
- [Assignment and ticket statuses](https://www.agentstack.build/docs/help-desk/assignment-and-statuses): Assign tickets and use Inbox statuses to communicate ownership and the next customer action.
- [Contacts and leads](https://www.agentstack.build/docs/help-desk/contacts-and-leads): Search, filter, review, add, and export customer contacts collected from your agents.
- [Continuous conversations](https://www.agentstack.build/docs/help-desk/continuous-conversations): Reach a widget visitor by email after they leave, and receive their reply in the same ticket.
- [Conversation notes](https://www.agentstack.build/docs/help-desk/conversation-notes): Add internal context to an Activity conversation without sending it to the customer or changing ticket ownership.
- [Copilot drafts](https://www.agentstack.build/docs/help-desk/copilot-drafts): Generate an editable reply from ticket context without automatically sending it to the customer.
- [Teams and routing](https://www.agentstack.build/docs/help-desk/teams-and-routing): Understand Help Desk ticket routing while keeping team administration in the Workspace area.
- [Assignment, status, and routing](https://www.agentstack.build/docs/help-desk/ticket-workflow): Route tickets to a teammate or team, use status deliberately, and keep customers from receiving conflicting replies.
- [Tickets](https://www.agentstack.build/docs/help-desk/tickets): Open, filter, inspect, and resolve Inbox tickets while preserving the customer conversation context.
- [Workspace](https://www.agentstack.build/docs/workspace): Manage your organization, people, security, integrations, and billing.
- [API keys](https://www.agentstack.build/docs/workspace/api-keys): Create, scope, rotate, and revoke organization REST API keys.
- [Audit logs](https://www.agentstack.build/docs/workspace/audit-logs): Investigate workspace changes with Enterprise audit history and exports.
- [Billing, pricing, and credits](https://www.agentstack.build/docs/workspace/billing-and-pricing): Manage subscriptions, credits, payment settings, and usage interruptions.
- [Custom roles](https://www.agentstack.build/docs/workspace/custom-roles): Define Enterprise least-privilege roles and assign them safely.
- [Domains](https://www.agentstack.build/docs/workspace/domains): One list of every hostname your organization uses, and what each one does.
- [Integrations](https://www.agentstack.build/docs/workspace/integrations): Connect supported providers and understand connection impact across agents.
- [Members and invitations](https://www.agentstack.build/docs/workspace/members): Invite people, manage workspace membership, and preserve owner safeguards.
- [Choose an organization](https://www.agentstack.build/docs/workspace/organization-resolution): Understand how AgentStack resolves the active workspace after sign-in.
- [Organization settings](https://www.agentstack.build/docs/workspace/organization-settings): Update workspace identity, logo, translation settings, ownership, and deletion safely.
- [Personal settings](https://www.agentstack.build/docs/workspace/personal-settings): Review account identity and manage available Inbox notifications.
- [Teams and routing](https://www.agentstack.build/docs/workspace/teams): Configure Help Desk routing teams, membership, and default assignment.