Creating Knowledge Agents

Knowledge Agents enable teams to create targeted search agents that meet their specific requirements, offering greater relevance and value. This feature gives teams control over their search experience, allowing them to find more accurate and tailored results that align with their specific workflows and permissions.

Try our interactive tour showing how to set up a Knowledge Agent!.

📘

Best Practice

Check out a recording of our previous Knowledge Agents Workshop, and keep an eye out for future events!

👥

Access Required

Knowledge Agents are only available with All-in-One or Enterprise Guru plans.

You must be an Admin in Guru to set up or manage Knowledge Agents.

Before creating a Knowledge Agent, you will first need to set up your Sources. or create content in Guru.

Creating a Knowledge Agent

1. In Guru's web app, navigate to Manage, then click on Knowledge Agents.
2. Click Add Knowledge Agent.
3. Provide a unique name for your Agent, and choose an image to represent it.
4. Next, decide if you want this Agent to surface content from All Sources or Specific Sources:
   1. If you choose All Sources, you will then click Save.
   2. If you choose Specific Sources, you will then click Next: Select Sources before selecting which knowledge sources this agent can draw from when providing responses. When you've chosen your sources, click Save.

✍️

Note

If you select "All Sources," note that sources added in the future will also be included.

Managing Sources used by a Knowledge Agent

After the initial Knowledge Agent setup, Admins can manage the sources it has access to from the Sources tab of the Knowledge Agent. Note that in order to generate an answer, a User/Group needs to have access to both the Knowledge Agent and any Sources/Collections attached to that Knowledge Agent.

Setting up permissions

From the Permissions tab, Admins can add groups as viewers to the Knowledge Agent. Once a group has been added as viewers, they can be promoted to Experts. Click the ellipses to the right of the assigned Group to update permissions or remove access.

👥

Access Required

By default, an Admin or the person who set up a Knowledge Agent doesn’t automatically have access to it. These users will need to assign themselves permissions in the ‘Permissions’ tab before they can assign the Knowledge Agent to a Page.

Viewer Permissions: A viewer can see the Knowledge Agent and use it to produce search results. Viewers can do the following:

• See the all Knowledge Agents that they've been given access to.
• See the available Knowledge Agents on the search results page after generating and answer or getting search results back.
• Get an answer from a Slack channel where a Knowledge Agent is listening.
• See their questions in the AI Training Center.

Expert Permissions: An expert has the same permissions as a viewer, but they can also do the following:

• See all questions asked of that Knowledge Agent in the AI Training Center.
• See the top sources used of that Knowledge Agent in the AI Training Center.
• Be assigned a Question through the answer generation screen or through the AI Training center.

For any feature not listed above, the Admin role within Guru can perform any action on a Knowledge Agent, including (but not limited to) adding/deleting/managing Knowledge Agents. Managing of Knowledge Agents includes prompt management and assigning permissions. Team admins can see all knowledge agents for a given workspace.

✍️

Note

Admins don't automatically get access to all sources or Collections. So, although Admins can configure Knowledge Agents, they will not be able to get results from Knowledge Agents or see the respective sources in the AI Training Center unless they are added to a permissioned group.

Creating a Custom Prompt for the Knowledge Agent

Custom Prompts tell the Knowledge Agent the ideal way to answer a question based on your specific preferences and needs.

From the Prompt tab, Admins can customize and test the prompt for the Knowledge Agent. They can also revert to the default prompt at any time.

📘

Best Practice

For tips on creating a custom prompt for your Knowledge Agent, check out Improving Custom Prompts

Adding a Knowledge Agent to your flow

Adding the Knowledge Agent to Slack Channels

From the Slack tab of the Knowledge Agent, Admins can add the Knowledge Agent to specific Guru-enabled Slack channels. This way, if a question triggers an AI Answer via Guru in that Slack channel, the designated Knowledge Agent will provide the suggested answer.

Adding the Knowledge Agent to Pages

Knowledge Agents can be added to specific custom Pages that you've created in Guru. To assign a Knowledge Agent:

1. Navigate to the Page that you have previously created.
2. Click the edit icon.
3. Set the default Knowledge Agent.

Leveraging the API

This is not required, though may be helpful for Admins who wish to leverage Guru's existing API infrastructure by copying the "search" and "answer" endpoints for each Knowledge Agent. This allows Admins to use a specific Knowledge Agent via API. For comprehensive API documentation, visit Guru's developer site.

Adding the Knowledge Agent to the Guru Extension

If you do not see the Knowledge Agent in the Guru Extension, you will need to turn it on.

1. First, ensure the Knowledge Agent is activated in Manage > Knowledge Agents by toggling "Activate this Knowledge Agent."
2. Open the Guru Extension.
3. Navigate to the "Settings" by clicking your user avatar on the top right.
4. Click "Extension Preferences."
5. To enable Knowledge Agents, ensure "Display search results facets" is checked off.

✍️

Note

Once your Knowledge Agent is ready, ensure that you have activated the Activate this Knowledge Agent toggle.

Frequently Asked Questions about Knowledge Agents

Can I add a single user as a viewer or expert to a Knowledge Agent?

Yes, individual users can be added to Knowledge Agents in addition to groups.

I already have Slack Suggested Answers set up. What can I expect now that we have Knowledge Agents?

See Transitioning from Slack Suggested Answers to Knowledge Agents

Can I toggle between more than one Knowledge Agent in a Slack channel?

No, a Slack channel can only have one Knowledge Agent assigned to it at a time. Though, you can have a Knowledge Agent assigned across multiple channels.

If a Group is given access to a Knowledge Agent, but that Group is not given access to the Sources connected to that Knowledge Agent, will the Knowledge Agent pull responses from those Sources when asked?

No. The Collection or Source will be filtered out of the results if a user does not have access to that Collection/Source.