Skip to main content

Documentation Index

Fetch the complete documentation index at: https://sitegpt.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Create a source connection

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

Authorize or select files

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

List selected source documents

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

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:
OptionDescription
--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:
OptionDescription
--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.

​
Full reference