Knowledge

Knowledge API

Overview

The Knowledge API allows you to manage and expand your AI Agent’s knowledge sources, extending beyond Ada’s out-of-the-box integrations. It provides methods to create, organize, and maintain multiple knowledge sources, enabling seamless integration of custom or external knowledge into your AI Agent.

The API exposes three main resources: Sources, Articles, and Tags. These resources are designed to help you organize and manage the knowledge available to your AI Agent effectively:

  • Sources: Represent external knowledge sources, such as knowledge bases or documents. They help you organize and name the sources of information your AI Agent accesses. In Ada, every article must be associated with a source.
  • Articles: Represent individual units of content within a knowledge source. These articles contain the information your AI Agent uses to resolve end-user inquiries.
  • Tags: Serve as labels assigned to articles within a knowledge source. Tags make it easier to organize and retrieve content efficiently.

Supported languages

Your AI Agent can have conversations in multiple different languages. However, knowledge content must be written in the following languages:

  • English
  • Arabic
  • Chinese
  • Dutch
  • French
  • German
  • Italian
  • Portuguese
  • Spanish

Rate limits

All article endpoints (/v2/knowledge/articles/) adhere to these rate limits:

  • Requests per day: 60,000
  • Requests per minute: 1,000
  • Requests per second: 200

All other Knowledge API endpoints adhere to our global rate limits.

Data limits

Along with rate limits, we’ve introduced restrictions on the number of articles that can be added, the size of individual articles, and the overall data size per request:

  • Maximum number of articles: 50,000
  • Maximum article size: 100KB
  • Maximum request size: 10MB

Request limits

Request URLs must be smaller than 2,048 bytes.

Indexing latency & freshness

When you create or update Ada Articles using the Knowledge API, updates are not available to generative answers immediately. After a successful API request, Ada begins indexing the new or updated content, which typically starts within ~30 seconds.

Updated content usually becomes available to generative answers within a few minutes, and generally under five minutes, depending on system load.

Direct edits to Ada Articles made through the dashboard appear immediately in the UI, but, like API updates, they may take a few minutes before they begin appearing consistently in the AI Agent’s responses.

If you maintain a set of small, frequently updated articles (such as outage or status updates), consider updating one article at a time rather than creating or modifying many articles in quick succession. This can help ensure updates become consistently available in generative answers more quickly.