Skip to main content
Your agents are only as good as the knowledge they draw from. This tutorial walks you through building a high-quality knowledge base — from connecting your first source to setting up ongoing maintenance.

​
Prerequisites

  • Admin or staff access to AGO
  • Content to import (help center, wiki, docs, or files)
1

Understand How Agents Use Knowledge

When a user asks a question, the agent searches your knowledge base for relevant documents, then uses those documents to formulate a response. This means:
  • Coverage matters — if a topic is not in your knowledge base, the agent cannot answer it
  • Quality matters — poorly written or outdated content leads to poor answers
  • Structure matters — well-organized documents with clear titles and headings are easier for the agent to find and use
2

Choose the Right Connector

AGO supports many content platforms. Pick the one that matches where your content lives:See the full list of Knowledge Connectors.
You can connect multiple sources to a single agent. Start with one, validate quality, then add more.
3

Connect Your First Source

  1. Navigate to Knowledge > Sources
  2. Click Add Source
  3. Select your connector
  4. Follow the authentication steps (each connector has specific requirements)
  5. Select which content to sync — you can choose specific pages, spaces, or categories
  6. Click Save and Sync
The initial sync may take a few minutes depending on the volume of content. You can track progress on the Sources page.
4

Review Sync Results

Once the sync completes:
  1. Go to Knowledge > Sources and click on your source
  2. Check the document count — does it match what you expected?
  3. Browse a few documents to verify content was imported correctly
Common issues:
  • Missing documents — check connector permissions and scope settings
  • Partial content — some connectors have content size limits
  • Formatting issues — complex layouts may not import perfectly
5

Analyze Content Quality

AGO automatically scores your content for agent readability.
  1. Navigate to Knowledge > Quality
  2. Review the overall quality score
  3. Look at individual document scores and flags
Common quality issues:
  • Missing titles — documents without clear titles are hard for agents to find
  • Thin content — very short documents may not contain enough information
  • Outdated information — stale content leads to incorrect answers
  • Duplicate content — multiple documents covering the same topic confuse retrieval
See Knowledge Quality for a full reference of quality dimensions.
6

Fix Quality Issues

For each flagged document, decide whether to:
  1. Fix at the source — update the document in Notion, Confluence, etc., then re-sync
  2. Use change proposals — suggest edits directly in AGO for team review
  3. Exclude the document — remove low-quality content from the agent’s scope
Focus on fixing the documents that agents use most frequently. Check analytics to see which documents appear in the most conversations.
See Knowledge Change Proposals for the review workflow.
7

Add Translations (Optional)

If your users speak multiple languages:
  1. Navigate to Knowledge > Translations
  2. Select the languages you want to support
  3. AGO can auto-translate your content or you can provide manual translations
  4. Review translated content for accuracy
See Knowledge Translations.
8

Set Up Ongoing Maintenance

A knowledge base requires regular updates. Set up these practices:

​
Enable Versioning

Track changes to your knowledge base over time:
  1. Navigate to Knowledge > Versioning
  2. Enable version history
  3. Review changes before they go live
See Knowledge Versioning.

​
Checklist

  • Connector chosen and source connected
  • Initial sync completed successfully
  • Document count verified
  • Quality analysis reviewed
  • Critical quality issues fixed
  • Translations added (if needed)
  • Maintenance schedule established

​
What’s Next