External data sources - SiteGPT Docs

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> <source-id> --sync WEEKLY

Ingest options:

Option	Description
`--sync <frequency>`	Auto-sync ingested source content. Values: `NEVER`, `DAILY`, `WEEKLY`, `MONTHLY`.
`--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.

​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