Skip to main content
Knowledge connectors import and synchronize documentation from external platforms into AGO. Your AI agents can then use this content to provide accurate, up-to-date answers based on your existing documentation. AGO supports 19 connector types across different categories: help centers, wikis, developer docs, media, and file-based imports.

Connector Comparison

Help Center & Support Platforms

Wiki & Documentation Platforms

Data & File-Based Sources

Available Knowledge Connectors

AGO supports 19 connector types for importing documentation from various sources.

Help Center Connectors

Zendesk Integration

Import knowledge base articles from Zendesk Help Center with multi-language support and category filtering.

Intercom Integration

Synchronize help center articles from Intercom, including collections, sections, and multi-language content.

HelpScout Integration

Import knowledge base articles and categories from HelpScout Docs.

Crisp Integration

Import help center content from Crisp with hierarchical category and section filtering.

Smart Tribune Integration

Import FAQ and knowledge base content from Smart Tribune with thematic filtering.

HubSpot Knowledge Base Integration

Import articles from HubSpot Service Hub Knowledge Base with state filtering and category organization.

Wiki & Documentation Connectors

Notion Integration

Import Notion workspace pages and databases with OAuth authentication and property-based filtering.

Confluence Integration

Connect to Atlassian Confluence for enterprise wiki import with hierarchical structure and attachments.

Paligo Integration

Import topic-based technical documentation from Paligo CCMS with multi-language support.

README Integration

Import developer documentation, API references, and changelogs from README.io.

Mintlify Integration

Import documentation from Mintlify-powered sites via web scraping with automatic hierarchy detection.

Data & File-Based Connectors

Airtable Integration

Import structured data from Airtable bases with custom field mapping and linked field support.

JSON Integration

Import documents from JSON files with custom title, content, and ID field mapping.

Qualios Integration

Import quality management documentation from Qualios with status filtering.

OpenAPI Integration

Generate API reference documentation from OpenAPI specifications automatically.

MadCap Integration

Import technical documentation from MadCap Flare projects with table of contents support.

Media Connectors

YouTube Playlist Integration

Import content from YouTube playlists as knowledge documents, one per video.

XML Import Integration

Import and convert XML feeds into structured knowledge documents with configurable field mapping.

Special Source Types

Manual/AGO Source

Create and manage documents directly in AGO with PDF upload support — no external import needed.

Folder Source

Organize multiple sources into logical groups for navigation — container only, no direct content.

How Knowledge Connectors Work

  1. Configuration: Set up credentials and specify what content to import
  2. Fetch: Connector retrieves content from the external platform’s API
  3. Convert: HTML and rich text are converted to Markdown
  4. Store: Documents are saved with metadata and hierarchy
  5. Index: Content is vectorized for semantic search
  6. Sync: Scheduled updates keep content fresh

Choosing a Connector

Authentication Methods

Getting Started

  1. Choose connector: Select based on your documentation platform
  2. Gather credentials: Obtain API keys or set up OAuth
  3. Create source: Navigate to Knowledge → Sources → Create
  4. Configure settings: Set source ID, filters, and options
  5. Test sync: Run a manual sync to verify import
  6. Schedule: Configure auto-sync for regular updates

Best Practices

Content Organization

  • Start with a subset of content before full import
  • Use restricted keywords to filter sensitive content
  • Organize sources into folders for large knowledge bases

Sync Strategy

  • Set appropriate sync frequency based on content update rate
  • Use daily sync for stable documentation
  • Use more frequent sync for rapidly changing content

Quality Assurance

  • Review imported documents for formatting issues
  • Test search to verify documents are findable
  • Monitor sync history for errors

Troubleshooting

API Token Invalid
  • Verify the token hasn’t expired
  • Check token has required permissions/scopes
  • Regenerate token if needed
OAuth Connection Failed (Notion)
  • Re-authorize the connection
  • Ensure workspace permissions are granted
  • Check integration has access to target pages
Sync Stuck in Progress
  • Reset sync status in admin panel
  • Check for rate limiting from external service
  • Verify network connectivity
Documents Missing After Sync
  • Check restricted keywords aren’t filtering content
  • Verify source ID/page ID is correct
  • Ensure connector has access to the content
  • Check for empty or draft documents being skipped
Content Not Updated
  • Trigger manual sync to force refresh
  • Check last_sync_at timestamp
  • Verify auto-sync is enabled and scheduled
Formatting Issues
  • HTML conversion may lose some formatting
  • Complex tables may need manual adjustment
  • Code blocks should preserve syntax
Missing Images
  • Some connectors don’t import images
  • Check attachment settings for the connector
  • External images may need accessible URLs

Knowledge Source Management

Managing sources

Knowledge Overview

Feature overview

Set Up Your Knowledge Base

Setup tutorial