The built-in assistant lets you chat with AI inside the Birkly admin using the floating chat button (bottom-right). You connect once with a provider API key under Settings → AI → Built-in assistant.
Connecting Claude, ChatGPT, or Cursor to your site content is separate — see Connect your AI app.
Go to Settings → AI → Built-in assistant and click Quick connect. Choose a provider, enter your API key, test the connection, and save. Use the chat button in the admin to get help with content. Consumer subscriptions (ChatGPT Plus, Claude Pro) do not include API access — you need a developer API key.
Beginner
Example: connect OpenAI and ask one question
- Open Settings → AI. Under Built-in assistant, click Quick connect.
- Choose OpenAI, paste a developer API key (not a ChatGPT Plus login), click Test connection, then Connect.
- Open the floating chat button and ask “List my collections.” The answer uses that connection. Ollama skips the API key and uses your API URL instead.
Quick connect
- Settings → AI tab.
- Under Built-in assistant, click Quick connect.
- Select your provider (OpenAI, Anthropic, Google, OpenRouter, Ollama, or Custom).
- Enter your API key (skip for Ollama).
- Click Test connection, then Connect.
Advanced users
Form fields
- Provider — OpenAI, Anthropic, Google, OpenRouter, Ollama, or Custom.
- Connection name — A label you'll recognize.
- API key — From your provider's developer console. Empty for Ollama.
- API URL — For Ollama or Custom only.
- Model — Optional; defaults to the provider default (OpenAI:
gpt-4o-mini). Legacygpt-4connections are remapped automatically. - Role — Viewer, Author, Editor, or Admin.
- Require approval — Recommended for the built-in assistant. Pending write actions appear in the chat Approvals tab.
Collection and entry slugs
When the built-in assistant creates or updates collections and entries, slugs follow Birkly’s URL rules:
- Lowercase letters and digits only
- Hyphens as word separators (
blog-posts, notblog_posts) - Underscores are normalized to hyphens at write time (e.g.
my_entry→my-entry) - Invalid characters are stripped before save
You do not need to fix slugs manually — the assistant and approval pipeline normalize them. If a create previously failed on underscores, update to a current Birkly build with slug normalization enabled.
Approvals
Built-in assistant only. When the floating chat assistant wants to change content and Require approval is on, actions wait in the Approvals tab of the AI Assistant window.
External AI apps (Claude, ChatGPT, Cursor) connected via MCP handle write confirmation inside the client app — not in the Birkly Approvals tab. See Connect your AI app.