Appearance
Point Overdesk at your docs
Overdesk grounds its drafts in your own documentation, so a draft answers from what you have published. That is why drafting stays paused until Overdesk knows where your docs live. Giving it the address takes a minute, and Overdesk reads and indexes the site in the background. Docs come first in setup because they take the longest to read.
Add your docs site
- Open Settings → Knowledge base. During setup, the same field is Docs site URL (required for drafting) in the Docs and AI key step, the first step of the setup wizard.
- Under Documentation sync, enter your documentation site's address in Docs site URL(s), for example
https://docs.yourcompany.com. For more than one site, separate the addresses with commas. - Choose Save.
Use the address of your docs home page. Overdesk follows links from there, 2 clicks deep unless you change Max crawl depth. The optional Link selector, Content selector and Title selector fields are for sites where whole sections are missed or navigation text creeps in; leave them blank otherwise. Documentation sites explains each one.
What happens next
Drafting does not wait for the crawl to finish. Once the address, your API key and your allowed inboxes are set, drafts start arriving, and their grounding gets sharper as indexing completes. By default a conversation your knowledge base has nothing on is still drafted, from the model's general knowledge; Only draft when sources are found holds those back instead.
Saving the address starts Sync documentation at once, so the site is being read while you finish the rest of setup. Saving it again while a sync is already queued or running adds nothing. After that it reads the site again every day at 04:00 in your workspace timezone, so drafts keep up with changes to your docs.
Home shows a banner while the first sync runs and says the first results appear within a few minutes. The Try one question step answers once the first pages of your docs are stored, and says "Your docs are still being read" until then.
Using Zendesk
Your knowledge base lives in Zendesk Guide. Activate Guide, make your Help Center public, and paste its address into Docs site URL(s).
Help-center articles and other sources
Help Scout Docs (once you add a Docs API key), Zendesk Help Center and Intercom Help Center articles also sync through your help desk connection, and Notion, Google Docs, GitHub, Linear, Jira and WordPress.org forums can join the knowledge base too. See Help-center articles and the knowledge base overview.
Those sources add to what drafts can cite, but the docs site address is the one drafting checks for. Set it even if your articles already arrive through your help desk.
Without an address
- No reply is drafted. The Agent drafts page says so in a banner, and its Run auto-draft button stays unavailable.
- Follow-up nudges still run, because they draw only on the conversation itself.
- Your knowledge base still builds from your past conversations.
Next: Add your Anthropic API key.