Actions14
Overview
The node provides integration with the Ragdoll AI API, specifically enabling interaction with knowledge bases. The Knowledge Base - Query operation allows users to send a search query to a specified knowledge base and retrieve relevant results.
This operation is useful in scenarios where you want to perform semantic or keyword-based searches over a curated set of documents or data indexed within a knowledge base. For example, it can be used to:
- Retrieve relevant information from a company's internal knowledge repository.
- Search FAQs or documentation to provide automated support answers.
- Extract contextually relevant data snippets for further processing or display.
A practical example: You have a knowledge base containing product manuals and want to find the top 3 most relevant sections related to "installation instructions" by querying this node.
Properties
| Name | Meaning |
|---|---|
| Knowledge Base ID | The unique identifier of the knowledge base to query. |
| Query | The search query string to look up in the knowledge base. |
| Number of Results (topK) | The number of top matching results to return from the query (default is 3). |
Output
The node outputs JSON data representing the response from the Ragdoll AI API's knowledge base query endpoint. This typically includes an array of results relevant to the query, such as matched documents or text snippets along with their relevance scores or metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Ragdoll AI API.
- The node expects the base URL of the Ragdoll AI service to be configured in the credentials.
- Network access to the Ragdoll AI API endpoints is necessary.
Troubleshooting
- Invalid Knowledge Base ID: If the provided knowledge base ID does not exist or is incorrect, the API will likely return an error indicating the resource was not found. Verify the ID is correct.
- Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key credential is properly configured.
- Empty or Malformed Query: Providing an empty query string may result in no results or an error. Always supply a meaningful query.
- API Rate Limits: Excessive requests might trigger rate limiting errors. Implement retry logic or reduce request frequency if needed.
- Network Issues: Connectivity problems to the API endpoint will cause request failures. Check network settings and firewall rules.
Links and References
- Ragdoll AI API Documentation (general reference for API endpoints and usage)
- n8n Documentation on Creating Custom Nodes (for understanding node development concepts)