Docs
Learn how Alloy works
Start with the core ideas behind Alloy: AI teammates, Ally, shared knowledge, approved tools, workflows, webchat, voice, and API access.
Where to start
These docs are a public orientation hub for buyers, users, search engines, and LLMs. They explain the product model first and link deeper for setup details. Pick a section below.
Getting started
- What Alloy isUnderstand the workspace model behind Alloy: people, AI teammates, shared knowledge, tools, and workflows.
- Meet AllyLearn how Alloy's built-in assistant helps users work with knowledge, tools, and AI teammates.
- Add your first AI teammateCreate a focused AI teammate and give it the right role, knowledge, tools, and access.
- Upload and share knowledgeUse Storage to organize files and give AI teammates access to the knowledge they need.
- Invite team membersInvite people to your Alloy workspace and track pending, accepted, cancelled, and expired invites.
Core concepts
- AI teammatesLearn how Alloy uses configurable AI teammates for specific jobs across the workspace.
- AllyLearn how Alloy's built-in assistant helps users work inside the workspace.
- Knowledge and storageLearn how Alloy stores company knowledge and controls what AI teammates can access.
- Tools and MCP serversLearn how Alloy connects AI teammates to approved actions and external systems.
- Skills and workflowsLearn how Alloy turns repeatable work into structured processes.
- Contacts and conversationsLearn how Alloy keeps chat, customer identity, and conversation history connected.
- Permissions and controlLearn how Alloy scopes access for people, AI teammates, storage, tools, and connected systems.
Build and connect
- Webchat widgetEmbed Alloy chat on your website so customers and visitors can talk to your human and AI teammates.
- API accessUse Alloy APIs to manage storage, trigger workflows, and connect external systems to AI teammates.
- MCP serversConnect external tools through MCP and assign them only to the AI teammates that need them.
- Workflow builderCreate repeatable processes that combine AI teammates, tools, logic, messages, and human input.
- VoiceEnable realtime voice conversations with Ally, AI teammates, and customer-facing webchat.
- Bring your own model keysUse your own LLM provider relationship or let Alloy pass model and compute usage through.
Technical docs
- Runtime Tooling For AI TeammatesPublic reference for Runtime Tooling For AI Teammates.
- Alloy AI Node (Agent Step)Public reference for Alloy AI Node (Agent Step).
- Ally, the Built-In Platform AssistantPublic reference for Ally, the Built-In Platform Assistant.
- Auth and SessionPublic reference for Auth and Session.
- Chat WidgetPublic reference for Chat Widget.
- Contacts and ChannelsPublic reference for Contacts and Channels.
- CoworkPublic reference for Cowork.
- DataTable SystemPublic reference for DataTable System.
- Deployment & Data ResidencyPublic reference for Deployment & Data Residency.
- Home DashboardPublic reference for Home Dashboard.
- Hosted MCPPublic reference for Hosted MCP.
- IntegrationsPublic reference for Integrations.
- Internal ChatPublic reference for Internal Chat.
- Invite Acceptance FlowPublic reference for Invite Acceptance Flow.
- LogsPublic reference for Logs.
- MCP ServersPublic reference for MCP Servers.
- Message ReactionsPublic reference for Message Reactions.
- Models and VoicesPublic reference for Models and Voices.
- OmniPublic reference for Omni.
- OnboardingPublic reference for Onboarding.
- Operations RuntimePublic reference for Operations Runtime.
- Private APIPublic reference for Private API.
- Realtime VoicePublic reference for Realtime Voice.
- SettingsPublic reference for Settings.
- Sidebar NavigationPublic reference for Sidebar Navigation.
- SkillsPublic reference for Skills.
- StaffPublic reference for Staff.
- StargatePublic reference for Stargate.
- StoragePublic reference for Storage.
- Template: Customer Support TeammatePublic reference for Template: Customer Support Teammate.
- Alloy Technical Documentation IndexPublic reference for Alloy Technical Documentation Index.
- Troubleshooting GuidePublic reference for Troubleshooting Guide.
- Variables & SecretsPublic reference for Variables & Secrets.
- Work-with-Alloy PluginPublic reference for Work-with-Alloy Plugin.
- Workflow Engine (Backend)Public reference for Workflow Engine (Backend).
- WorkflowsPublic reference for Workflows.
Frequently asked questions
Who are these docs for?+
The Getting started and Core concepts sections explain the product model in plain language. The Technical docs section is denser reference material — comprehensive and precise rather than tutorial-style. Start in the higher-level sections; reach for the technical docs when you need exact behavior.
Why is the Technical docs section so terse?+
It's structured as reference material, not a tutorial. Short sections, explicit terminology, one capability per page, minimal narrative. That makes it fast to skim once you know what you're looking for, and easier to keep accurate as the product changes.
What should a new user read first?+
Start with What Alloy is, then read Meet Ally, AI teammates, Knowledge and storage, Tools and MCP servers, and Skills and workflows. By that point you'll understand the workspace model. Drop into the Technical docs section when you need exact operating details for a specific capability.