Skip to content
TulipFarmDocs

Last updated

Add files and apps to Knowledge

Connect Drive, Gmail, Slack, GitHub, Jira, or Confluence to add its content to Knowledge. Add files, then check, narrow, pause, retry, or remove a source.

This guide shows you how to build your Knowledge, the knowledge base that your chats and agents search and cite. You connect apps, add files and notes, and then manage each source. To learn what happens to the content, read How Knowledge works.

Everything you add is private to you. Your chats and agents can search it. Other people can’t.

When you connect Google Drive, Gmail, Slack, GitHub, Jira, or Confluence, TulipFarm adds that app’s content to your Knowledge automatically.

  1. In the sidebar, under Data & integrations, select Knowledge.

  2. Find the app and select Connect. Or select Manage integrations to choose from every app.

  3. Sign in to the app and allow access.

  4. Open the app on the Integrations page and select the Knowledge tab.

  5. Read What gets imported. It lists what is included, who can search it, the time range, and what is left out.

  6. Wait until the status shows Sync complete. Before that, it can show Queued for indexing, Finding sources, or Partly searchable. You can ask questions about the content that is already searchable.

To stop adding new content from an account, select Stop automatic Knowledge, then Confirm stop. Content that TulipFarm already added stays until you pause or remove its sources. To start again, select Turn automatic Knowledge back on.

Automatic Knowledge adds every Drive file that you can open, including files added later. For details, see Google.

To add a single folder or a shared drive yourself:

  1. Open Google Drive on the Integrations page, then the Knowledge tab.

  2. Select Index Google Drive.

  3. Under Source type, select My Drive or a folder, or Shared drive, and choose the folder or drive.

  4. Select Save Google source.

A folder in Google Drive can be a Knowledge source. A folder in Files can’t. See Add a file from Files.

Automatic Knowledge adds mail from the last 90 days, including new mail. Older mail leaves Knowledge as the 90 days move on. Spam, Trash, and attachments are not added. For details, see Google.

To add a label or an older date range yourself:

  1. Open Gmail on the Integrations page, then the Knowledge tab.

  2. Select Index Gmail.

  3. Choose a label, or the whole mailbox.

  4. Set After date and Before date. The range can be up to 366 days.

  5. Select Save Google source.

Automatic Knowledge adds messages from the last 90 days in the public and private channels you joined, including channels you join later. TulipFarm never joins a channel for you. Direct and group messages are not added unless you add them yourself. For details, see Slack.

To add direct messages, group messages, or older channel history:

  1. Open Slack on the Integrations page, then the Knowledge tab.

  2. Select Select Slack conversations.

  3. Under Conversation type, select Public and private channels, or Direct and group messages.

  4. Choose up to 50 conversations.

  5. Set Import messages after to the earliest date you want.

  6. Select Save Slack source.

Automatic Knowledge adds every repository that your GitHub account can read, including new ones. It adds docs and code from the default branch, the default branch’s commit history, and issues, pull requests, and discussions that were active in the last 90 days. For details, see GitHub.

To leave out repositories or kinds of content:

  1. Open GitHub on the Integrations page, then the Knowledge tab.

  2. Find the source under Repositories in Knowledge and select Edit settings.

  3. Under Repositories, clear each repository that you want to leave out. It stays out until you select it again.

  4. Under Content, clear the kinds of content that you want to leave out, such as commits or discussions.

  5. Select Save source settings.

To add a separate source with only the repositories you choose, select Add repositories, choose them, then select Add to Knowledge.

Automatic Knowledge adds the issues in every Jira project, and the pages in every Confluence space, that you can see on each connected site. New projects and spaces are added too. For details, see Jira, Confluence, and Trello.

Knowledge uses a separate Atlassian sign-in from the Jira and Confluence tools. The first time, open the Knowledge tab and select Allow Knowledge access.

To add specific projects, spaces, or pages yourself:

  1. Open Jira or Confluence on the Integrations page, then the Knowledge tab.

  2. Select Select Jira content or Select Confluence content.

  3. Choose the Atlassian site.

  4. Choose up to 50 projects, spaces, or pages. For Confluence, under Import, select Whole spaces or Specific pages. To add the pages under a page, select Include child pages.

  5. Select Save Jira source or Save Confluence source.

  1. Open Files and open the file.

  2. Select Add to Knowledge.

  3. Select Add to Knowledge in the dialog.

  4. Wait for the message “Ready. Chats can use it from your Knowledge.”

You can add up to 20 files at a time. You can’t add a folder from Files. Select the files in it instead.

TulipFarm saves the text of the file as it is now. It doesn’t follow later edits. If a file fails, the message says why, such as a password-protected file. After you fix the problem, select Retry extraction. For the file types and limits, see Knowledge sources and limits.

  1. In a chat, ask TulipFarm to save a note to your Knowledge. For example: “Save a note that our returns window is 30 days.”

  2. Read the New note card that appears in the chat.

  3. Select Add to Knowledge.

Nothing is saved until you select Add to Knowledge. To change or delete a note later, ask in a chat. The card shows Update or Remove for you to approve.

The Knowledge page shows each connected app and its status. To manage a whole app:

  1. In the sidebar, under Data & integrations, select Knowledge.

  2. Open the actions menu next to the app.

  3. Select Pause syncing or Resume syncing. If the status shows a failure, select Retry.

To manage one source, open the app’s Knowledge tab and find the source. Then select Pause source, Resume source, Retry source, or Remove source. To confirm a removal, select Confirm remove source. Removing a source takes its content out of Knowledge. The original stays in the app.

A paused or removed source stays that way. TulipFarm doesn’t add it back when it looks for new content.

Was this page helpful?