> ## Documentation Index
> Fetch the complete documentation index at: https://danswer-mintlify-deep-research-1773355783.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Curator Guide

> Example guide for Curators to create and manage Connectors, Document Sets, and Agents

## Adding Connectors

To create a new Connector as a Curator,
navigate to the **Connectors** section in your Curator Panel and click **Add Connector**.

<Info>
  Curators can create Connectors for their assigned User Groups.
  These Connectors will be available to group members and can be used in Agents.
</Info>

<img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/connectors/add_connector.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=01733f5ca41a790694d41b7b2dd4dcfc" alt="Onyx Add Connector page" width="5104" height="2170" data-path="assets/admins/connectors/add_connector.png" />

For detailed information about all available Connectors, configuration options, and troubleshooting,
see the [Connectors Overview](/admins/connectors/overview).

### Connector Configuration

Each Connector requires:

* **Name**: A descriptive name for your data source
* **Credentials**: Authentication details for accessing your source
* **Configuration**: Specific settings for data indexing
* **Access Controls**: Permissions for who can use this Connector

<img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/cjJn4DdzjmKogCbn/assets/admins/connectors/generic_config.png?fit=max&auto=format&n=cjJn4DdzjmKogCbn&q=85&s=9c46c5b4d6e5c0baf9db4f7f5bf177c8" alt="Onyx Connector Configuration page" width="1810" height="1728" data-path="assets/admins/connectors/generic_config.png" />

### Managing Existing Connectors

View and manage your existing Connectors from the **Existing Connectors** page. Here you can:

* Monitor indexing status and progress
* Update configuration settings
* Manage access permissions
* View usage analytics

<img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/cjJn4DdzjmKogCbn/assets/admins/connectors/indexing_status.png?fit=max&auto=format&n=cjJn4DdzjmKogCbn&q=85&s=03d3d6d34ab043902fa257f5522f9357" alt="Onyx Existing Connectors page showing connector statuses" width="4046" height="1830" data-path="assets/admins/connectors/indexing_status.png" />

## Document Sets

Document Sets allow you to group related Connectors together,
making it easier to organize content and assign specific knowledge sources to your Agents.

### Creating Document Sets

<Steps>
  <Step title="Navigate to Document Sets">
    In your Curator Panel, go to the **Document Sets** section.
  </Step>

  <Step title="Create New Document Set">
    Click **Create Document Set** and provide a name and description for your document collection.
  </Step>

  <Step title="Add Connectors">
    Select which Connectors should be included in this Document Set.
    You can combine multiple data sources into a single knowledge base.
  </Step>
</Steps>

### Document Set Benefits

Document Sets provide several advantages:

* **Organized Knowledge**: Group related content from different sources
* **Simplified Agent Creation**: Assign entire document collections to Agents
* **Access Control**: Manage permissions at the document set level
* **Search Filtering**: Enable users to search within specific document collections

## Creating Custom Agents

Agents are the primary way Curators deliver specialized AI assistance to their teams.
These AI assistants can be configured with specific knowledge sources, instructions, and capabilities.

<img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/agents/agents_overview.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=5def0166380bc2bd89995bad18830cb7" alt="Onyx Agents Overview page showing available agents" width="4944" height="1618" data-path="assets/admins/agents/agents_overview.png" />

For comprehensive information about Agent configuration options, management features, and advanced settings,
see the [Agents Overview](/admins/agents/overview).

### Agent Creation Process

<Steps>
  <Step title="Start Agent Creation">
    Navigate to the **Agents** section in your Curator Panel and click **Create New Agent**.
  </Step>

  <Step title="Basic Agent Configuration">
    Configure your Agent's fundamental properties:

    * **Name**: A clear, descriptive name for your Agent
    * **Description**: Brief explanation of the Agent's purpose
    * **Instructions**: Detailed prompt defining how the Agent should behave
    * **Icon**: Optional visual identifier for your Agent

    <img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/agents/agent_instructions.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=e35ae9492cb24be632195b5385d475ec" alt="Onyx Agent Configuration page" width="1950" height="1266" data-path="assets/admins/agents/agent_instructions.png" />
  </Step>

  <Step title="Knowledge Sources">
    Assign knowledge sources to your Agent by selecting:

    * **Document Sets**: Pre-organized collections of related documents
    * **Individual Connectors**: Specific data sources
    * **User Knowledge**: Personal documents (for private Agents)

    <img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/agents/agent_actions.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=66cc866dddb2dfef5161d658da7e1e93" alt="Onyx Agent Configuration page" width="1950" height="1496" data-path="assets/admins/agents/agent_actions.png" />
  </Step>

  <Step title="Actions and Capabilities">
    Configure which Actions your Agent can perform:

    * **Web Search**: Enable internet search capabilities
    * **File Upload**: Allow users to upload documents
    * **Custom Actions**: MCP or OpenAPI-based custom tools

    For more information about available Actions and creating custom Actions,
    see the [Actions Overview](/admins/actions/overview).
  </Step>

  <Step title="Access and Sharing">
    Define who can access your Agent:

    * **Private**: Only you and selected users
    * **Group Access**: Available to specific User Groups
    * **Organization-wide**: Public to all users (requires approval)

    Configure starter messages and labels to help users understand your Agent's capabilities.

    <img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/agents/agent_configs_misc.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=af700b7f4ed1b748d4634636027ac3f5" alt="Onyx Agent Configuration page" width="1950" height="1176" data-path="assets/admins/agents/agent_configs_misc.png" />

    For more information about User Groups and access management,
    see [User Management](/admins/user_management/users_and_groups).
  </Step>

  <Step title="Advanced Options">
    Fine-tune your Agent's behavior:

    * **Knowledge Options**: Search depth and result limits
    * **Model Selection**: Choose the AI model for your Agent
    * **Date/Time Awareness**: Enable temporal context

    <img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/agents/agent_knowledge_options.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=f7795b740c3b3f159effbb845ff7e0c9" alt="Onyx Agent Configuration page" width="1950" height="1408" data-path="assets/admins/agents/agent_knowledge_options.png" />
  </Step>
</Steps>

Once published, your Agent will be available to your users in the Chat interface.

<img className="rounded-image" src="https://mintcdn.com/danswer-mintlify-deep-research-1773355783/mwF-EX7U3MAkhK8q/assets/admins/agents/explore_agents.png?fit=max&auto=format&n=mwF-EX7U3MAkhK8q&q=85&s=bf2c1f93922c04f98f91efb4069d9bf9" alt="Onyx Explore Agents page" width="1778" height="1628" data-path="assets/admins/agents/explore_agents.png" />
