External data sources

External data-source commands connect a chatbot to third-party systems and ingest selected documents into SiteGPT knowledge.

sitegpt knowledge sources --help

knowledge connections is accepted as an alias for knowledge sources.

Supported connectors

NOTION, GOOGLE_DRIVE, DROPBOX, ONEDRIVE, BOX, SHAREPOINT, CONFLUENCE, GITHUB

Source lifecycle

Create a source connection

sitegpt knowledge sources create --chatbot <chatbot-id> --connector GOOGLE_DRIVE --name "Drive docs"

Authorize or select files

OAuth/picker connectors return an authorization URL. Open it, approve access, and select files when the provider shows a picker.

List selected source documents

sitegpt knowledge sources documents --chatbot <chatbot-id> <source-id>

Ingest selected documents

sitegpt knowledge sources ingest --chatbot <chatbot-id> <source-id>

List sources

sitegpt knowledge sources list --chatbot <chatbot-id>
sitegpt knowledge sources list --chatbot <chatbot-id> --connector GOOGLE_DRIVE
sitegpt knowledge sources list --chatbot <chatbot-id> --status ACTIVE
sitegpt knowledge sources list --chatbot <chatbot-id> --json

Status values:

PENDING, ACTIVE, FAILED, REVOKED

Create sources

OAuth/picker sources:

sitegpt knowledge sources create --chatbot <chatbot-id> --connector GOOGLE_DRIVE --name "Drive docs"
sitegpt knowledge sources create --chatbot <chatbot-id> --connector NOTION --name "Notion docs"
sitegpt knowledge sources create --chatbot <chatbot-id> --connector DROPBOX --name "Dropbox docs"
sitegpt knowledge sources create --chatbot <chatbot-id> --connector ONEDRIVE --name "OneDrive docs"
sitegpt knowledge sources create --chatbot <chatbot-id> --connector BOX --name "Box docs"
sitegpt knowledge sources create --chatbot <chatbot-id> --connector SHAREPOINT --name "SharePoint docs"

Confluence:

sitegpt knowledge sources create \
  --chatbot <chatbot-id> \
  --connector CONFLUENCE \
  --domain site.atlassian.net \
  --name "Confluence docs"

GitHub:

sitegpt knowledge sources create \
  --chatbot <chatbot-id> \
  --connector GITHUB \
  --name "Docs repo" \
  --owner <owner> \
  --api-key <github-token>

Create options:

Option	Description
`--connector <connector>`	Required connector type.
`--name <name>`	Friendly connection name.
`--owner <owner>`	GitHub owner. Required for GitHub create.
`--api-key <token>`	GitHub personal access token.
`--domain <domain>`	Confluence domain. Required for Confluence create.
`--label <label>`	Optional provider-visible label metadata.
`--client-redirect-url <url>`	Optional URL to redirect to after OAuth/picker.
`--metadata <json>`	Extra metadata object.

sources add is an alias for sources create.

Get and update a source

sitegpt knowledge sources get --chatbot <chatbot-id> <source-id>
sitegpt knowledge sources update --chatbot <chatbot-id> <source-id> --name "New name"
sitegpt knowledge sources update --chatbot <chatbot-id> <source-id> --api-key <new-github-token>
sitegpt knowledge sources update --chatbot <chatbot-id> <source-id> --client-redirect-url https://example.com/done
sitegpt knowledge sources update --chatbot <chatbot-id> <source-id> --clear-client-redirect-url

Authorize or select more files

Use authorize for first-time OAuth approval, reauthorization, or selecting more files for an existing picker connection:

sitegpt knowledge sources authorize --chatbot <chatbot-id> <source-id>
sitegpt knowledge sources authorize --chatbot <chatbot-id> <source-id> --client-redirect-url https://example.com/complete

Aliases:

reauthorize
select-files
picker

To add more files to an existing Google Drive, Dropbox, OneDrive, Box, or SharePoint connection, run authorize for the existing source. Do not create a duplicate connection unless you want a separate connection.

List source documents

sitegpt knowledge sources documents --chatbot <chatbot-id> <source-id>
sitegpt knowledge sources documents --chatbot <chatbot-id> <source-id> --limit 100
sitegpt knowledge sources documents --chatbot <chatbot-id> <source-id> --cursor <cursor>

Alias:

sitegpt knowledge sources docs --chatbot <chatbot-id> <source-id>

Ingest source documents

sitegpt knowledge sources ingest --chatbot <chatbot-id> <source-id>
sitegpt knowledge sources ingest --chatbot <chatbot-id> <github-source-id> --sync WEEKLY

Ingest options:

Option	Description
`--sync <frequency>`	Scheduled re-sync for GitHub sources only; other connectors ingest once and clamp to `NEVER` with a warning. Refresh them with `knowledge documents resync`.
`--external-id <id>`	Ingest a selected external document ID. Repeatable.
`--document <id>`	Alias-style document selector for external IDs. Repeatable.
`--page <id>`	Confluence/Notion page selector. Repeatable.
`--metadata <json>`	Extra metadata object.

GitHub helpers

List repositories:

sitegpt knowledge sources github repos --chatbot <chatbot-id> --source <source-id>
sitegpt knowledge sources github repositories --chatbot <chatbot-id> --source <source-id> --page 1 --per-page 100

List files:

sitegpt knowledge sources github files \
  --chatbot <chatbot-id> \
  --source <source-id> \
  --owner <owner> \
  --repo <repo> \
  --branch <branch>

Ingest repository content:

sitegpt knowledge sources ingest \
  --chatbot <chatbot-id> \
  <source-id> \
  --repo <repo> \
  --branch <branch> \
  --pattern "docs/**"

--pattern is repeatable.

Confluence helpers

List spaces:

sitegpt knowledge sources confluence spaces --chatbot <chatbot-id> --source <source-id>
sitegpt knowledge sources confluence spaces --chatbot <chatbot-id> --source <source-id> --limit 50

List pages in a space:

sitegpt knowledge sources confluence pages \
  --chatbot <chatbot-id> \
  --source <source-id> \
  --space <space-id>

Ingest pages:

sitegpt knowledge sources ingest --chatbot <chatbot-id> <source-id> --page <page-id>

Notion flow difference

Notion selection happens inside Notion OAuth. After authorization, selected pages/databases are discovered during ingest. That means this can be normal for Notion:

sitegpt knowledge sources documents --chatbot <chatbot-id> <notion-source-id>
# No documents shown yet
sitegpt knowledge sources ingest --chatbot <chatbot-id> <notion-source-id>

If no pages were selected during OAuth, rerun authorization:

sitegpt knowledge sources authorize --chatbot <chatbot-id> <notion-source-id>

Revoke a source

sitegpt knowledge sources revoke --chatbot <chatbot-id> <source-id> --yes

Alias:

sitegpt knowledge sources delete --chatbot <chatbot-id> <source-id> --yes

Revoking disconnects the source. It does not automatically delete already ingested knowledge documents.

Get started

Chatbot setup

Operations

Agent playbooks

Reference

Supported connectors

Source lifecycle

List sources

Create sources

Get and update a source

Authorize or select more files

List source documents

Ingest source documents

GitHub helpers

Confluence helpers

Notion flow difference

Revoke a source

Full reference

​Supported connectors

​Source lifecycle

​List sources

​Create sources

​Get and update a source

​Authorize or select more files

​List source documents

​Ingest source documents

​GitHub helpers

​Confluence helpers

​Notion flow difference

​Revoke a source

​Full reference

Supported connectors

Source lifecycle

List sources

Create sources

Get and update a source

Authorize or select more files

List source documents

Ingest source documents

GitHub helpers

Confluence helpers

Notion flow difference

Revoke a source

Full reference