RetellAI icon

RetellAI

Interact with RetellAI API

Actions21

Overview

The node integrates with the RetellAI API to manage knowledge bases. Specifically, the "Knowledge Base - Create" operation allows users to create a new knowledge base by uploading file data or providing textual content and URLs to be scraped. This is useful for building custom knowledge repositories that can be used in AI-driven applications such as chatbots, virtual assistants, or any system requiring structured knowledge ingestion.

Practical examples:

  • Uploading a PDF or document containing company policies to create a searchable knowledge base.
  • Adding multiple text snippets and URLs from trusted sources to build a comprehensive FAQ database.
  • Enabling auto-refresh on URLs so the knowledge base stays updated with the latest information every 12 hours.

Properties

Name Meaning
Name The name of the knowledge base to create (max 40 characters).
Binary Property The name of the binary property in the input data that contains the file data to upload.
Additional Fields A collection of optional fields:
  Knowledge Base Texts Multiple text entries each with a Title and Text content to add directly to the knowledge base.
  Knowledge Base URLs List of URLs to scrape and add their content to the knowledge base.
  Enable Auto Refresh Boolean flag to enable automatic refreshing of the knowledge base URLs every 12 hours.

Output

The node outputs JSON data representing the result of the knowledge base creation operation. This typically includes metadata about the newly created knowledge base such as its ID, status, and possibly summary information confirming successful ingestion.

If the node handles binary data uploads, the binary property specified is used as input but the output focuses on JSON metadata rather than returning binary content.

Dependencies

  • Requires an API key credential for authenticating with the RetellAI API.
  • The node communicates with the RetellAI service endpoint at https://api.retellai.com.
  • Proper configuration of the API key credential within n8n is necessary for successful requests.

Troubleshooting

  • Common issues:
    • Missing or invalid API key credential will cause authentication failures.
    • Providing an invalid or empty binary property name may result in failure to upload file data.
    • Exceeding the maximum length for the knowledge base name (over 40 characters) might cause validation errors.
    • Incorrectly formatted URLs or unreachable URLs in the Knowledge Base URLs field could lead to scraping errors.
  • Error messages:
    • Authentication errors usually indicate problems with the API key setup.
    • Validation errors related to input properties suggest checking required fields and their formats.
    • Network or timeout errors may occur if the RetellAI API is unreachable or slow to respond.

Links and References

Discussion