Actions14
Overview
This node allows you to create a new data source within a specified knowledge base using the Ragdoll AI API. Data sources represent external content repositories or services that can be indexed and queried as part of a knowledge base. Supported data source types include web pages, Notion pages/databases, and Google Drive folders/documents.
Common scenarios where this node is useful:
- Adding a website URL to be crawled and indexed for knowledge retrieval.
- Integrating Notion workspace content into your knowledge base.
- Connecting Google Drive documents or folders to enrich your knowledge base with files stored in Google Drive.
Practical example:
- You have a company wiki hosted on a website and want to add it as a data source so employees can query it via the knowledge base.
- You want to index project documentation stored in a Notion database.
- You want to include shared Google Drive folders containing manuals and guides.
Properties
| Name | Meaning |
|---|---|
| Knowledge Base ID | ID of the knowledge base to which the new data source will be added |
| Name | Name of the data source |
| Type | Type of the data source; options: Web, Notion, Google Drive |
| URL | (For Web type) URL of the web page to index |
| Max Depth | (For Web type) Maximum depth to crawl when indexing the web page (0 to 3) |
| Notion ID | (For Notion type) ID of the Notion page or database to index |
| Notion Token | (For Notion type) Integration token for authenticating with Notion |
| Google Drive ID | (For Google Drive type) ID of the Google Drive folder or document to index |
| Google Drive Credentials JSON | (For Google Drive type) JSON credentials required to authenticate with Google Drive |
Output
The node outputs the response from the Ragdoll AI API after creating the data source. The output is structured as JSON and typically includes details about the newly created data source such as its ID, name, type, parameters, and status.
If the API supports binary data output for this operation, it would be summarized as metadata or content related to the data source, but based on the static code analysis, this node primarily deals with JSON responses.
Dependencies
- Requires an active connection to the Ragdoll AI API endpoint.
- Requires an API authentication token credential configured in n8n to authorize requests.
- For Notion data sources, requires a valid Notion integration token.
- For Google Drive data sources, requires valid Google Drive credentials in JSON format.
Troubleshooting
- Invalid or missing Knowledge Base ID: Ensure the knowledge base ID is correct and exists in your Ragdoll AI account.
- Authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
- Incorrect parameters for data source type: For example, if
typeisweb, ensureURLandMax Depthare provided; fornotion, provideNotion IDandNotion Token; forgoogleDrive, provideGoogle Drive IDand credentials JSON. - API request failures: Check network connectivity and API service status.
- Permission issues with Notion or Google Drive tokens: Make sure the tokens have access rights to the specified resources.
Links and References
- Ragdoll AI API Documentation (general reference for API endpoints)
- Notion API Documentation
- Google Drive API Documentation