Add Knowledge

Introduction

This documentation provides a complete guide to the Add Knowledge functionality, which allows you to connect various data sources to the platform. By adding knowledge from different sources, you enable the ACE Search and Chat features to access and utilize this information for providing relevant responses and insights.

Table of Contents

• Add Knowledge
  • Introduction
  • Table of Contents
  • Accessing Add Knowledge
  • Available Knowledge Connectors
    • 1. Web Connector
    • 2. SharePoint Connector
    • 3. API Connector
    • 4. Files Connector
    • 5. Outlook Connector
    • 6. MinIO Connector
    • 7. JIRA Connector
    • 8. Image Connector
    • 9. Google Drive Connector
    • 10. GitHub Connector
    • 11. Confluence Connector
    • 13. YouTube Connector
  • General Knowledge Management Process
  • Permission Management
  • Monitoring and Management
  • Best Practices
  • Troubleshooting
  • Conclusion

Accessing Add Knowledge

1. Navigate to Knowledge Management from the main navigation bar
2. Select Add Knowledge
3. You will see a list of available connectors

Available Knowledge Connectors

The platform supports multiple connectors, each designed to integrate with specific data sources. Below is an overview of each connector type with links to detailed documentation.

1. Web Connector

Connect to websites and extract content using various scraping methods.

Key Features:

• Three scraping methods: Single Page, Recursive, and Sitemap
• Schedule regular updates to keep content current
• Control access through permission settings

Best For: Company websites, documentation sites, blogs, and online knowledge bases.

View Detailed Web Connector Documentation

2. SharePoint Connector

Extract content from Microsoft SharePoint sites and document libraries.

Key Features:

• Connect to specific SharePoint sites and folders
• Authenticate using Azure AD credentials
• Extract content from various document types

Best For: Organizations using SharePoint for document management and collaboration.

View Detailed SharePoint Connector Documentation

3. API Connector

Connect to external APIs to retrieve structured data.

Key Features:

• Support for various authentication methods
• Flexible parameter configuration
• JSON response handling

Best For: External data services, SaaS platforms, and custom data sources with API access.

View Detailed API Connector Documentation

4. Files Connector

Upload local files to extract and index their content.

Key Features:

• Support for multiple file formats (PDF, DOCX, XLSX, etc.)
• Batch upload capability
• Configurable file size limits

Best For: Document repositories, technical documentation, and local knowledge bases.

View Detailed Files Connector Documentation

5. Outlook Connector

Extract data from Microsoft Outlook emails.

Key Features:

• Configure time range for email retrieval
• Schedule recurring updates
• Admin-level security configuration

Best For: Email-based knowledge, support communications, and project correspondence.

View Detailed Outlook Connector Documentation

6. MinIO Connector

Connect to MinIO object storage to retrieve and index file content.

Key Features:

• Connect using access and secret keys
• Target specific buckets and folders
• Support for various document formats

Best For: Organizations using MinIO for object storage and file management.

View Detailed MinIO Connector Documentation

7. JIRA Connector

Extract issue data from Atlassian JIRA projects.

Key Features:

• Connect to specific JIRA projects
• Extract comprehensive issue information
• Support for both cloud and self-hosted instances

Best For: Project management knowledge, issue tracking, and development workflows.

View Detailed JIRA Connector Documentation

8. Image Connector

Analyze and generate descriptions for images using multimodal models.

Key Features:

• Automated image description generation
• Support for common image formats
• Integration with multimodal AI models

Best For: Image catalogs, visual documentation, and accessibility enhancement.

View Detailed Image Connector Documentation

9. Google Drive Connector

Access and index content from Google Drive folders and files.

Key Features:

• Connect using service account credentials
• Target specific folders
• Support for Google document formats

Best For: Organizations using Google Workspace for document management.

View Detailed Google Drive Connector Documentation

10. GitHub Connector

Extract data from GitHub repositories including issues, pull requests, and documentation.

Key Features:

• Connect using Personal Access Tokens
• Target specific repositories or organizations
• Extract comprehensive repository information

Best For: Development teams, open-source projects, and technical documentation.

View Detailed GitHub Connector Documentation

11. Confluence Connector

Extract content from Atlassian Confluence spaces and pages.

Key Features:

• Connect to specific Confluence instances
• Extract from entire spaces or individual pages
• Maintain document structure and formatting

Best For: Team documentation, knowledge bases, and project wikis.

View Detailed Confluence Connector Documentation

13. YouTube Connector

Extract content from YouTube videos, channels, and playlists.

Key Features:

• Upload CSV files with multiple video links
• Add single video links directly
• Extract video transcripts and metadata

Best For: Video tutorials, educational content, and media libraries.

View Detailed YouTube Connector Documentation

General Knowledge Management Process

Regardless of the connector type, the knowledge management process follows these general steps:

1. Select Connector: Choose the appropriate connector for your data source
2. Configure Connection: Provide the necessary credentials and settings
3. Define Scope: Specify what content should be extracted
4. Set Permissions: Determine which user groups can access this knowledge
5. Process Content: The system extracts and indexes the content
6. Review Status: Monitor the indexing process and check for success
7. Utilize Knowledge: Use the indexed content in search and chat features

Permission Management

All connectors support permission management through user groups:

• During configuration, you can select one or more user groups
• Only users in the selected groups will have access to the knowledge
• Permissions can be modified later through the knowledge management interface

Monitoring and Management

After adding knowledge sources, you can monitor and manage them:

• View Status: Check if knowledge sources are properly indexed
• Review Logs: Access detailed logs of the indexing process
• Update Content: Configure recurring updates or manually refresh content
• Delete Sources: Remove knowledge sources that are no longer needed

Best Practices

For optimal knowledge management:

• Start Small: Begin with a few key knowledge sources before expanding
• Organize Logically: Use descriptive names and appropriate grouping
• Monitor Performance: Regularly check knowledge indexing status
• Manage Permissions: Ensure information is accessible to appropriate users
• Regular Maintenance: Update or remove outdated knowledge sources

Troubleshooting

Common issues when adding knowledge:

Issue	Potential Solution
Connection failed	Verify credentials and network connectivity
Content not extracted	Check format compatibility and file integrity
Indexing errors	Review logs for specific error messages
Permission issues	Verify user groups and access settings
Performance problems	Consider reducing scope or optimizing extraction settings

For specific connector issues, please refer to the detailed documentation for each connector type.

Conclusion

The Add Knowledge functionality is the foundation of the platform's intelligence. By properly configuring and maintaining knowledge sources, you ensure that the system has access to relevant information when responding to queries through search and chat interfaces.

For detailed instructions specific to each connector type, click the corresponding links above or contact your system administrator for assistance.