Advanced Sources

​

How It Works

1. Your documents, uploaded with the corpus file upload endpoint.
2. Example queries for each document: up to 10 per document, each up to 400 characters.

​

When to Use an Advanced Source

• Your content is FAQ-style: each document is one answer, and the example queries are the questions.
• You’ve already optimized your chunking, for example with LlamaIndex or LangChain.
• You need precise control over what gets returned for specific queries, such as returning one product’s record when the caller asks about that product.
• Your documents are focused and self-contained, not large multi-topic files.

​

Creating an Advanced Source

POST /api/corpora/{corpus_id}/uploads
Content-Type: application/json

{
  "fileName": "faq.txt",
  "mimeType": "text/plain"
}

{
  "documentId": "doc_abc123",
  "presignedUrl": "https://..."
}

PUT <presignedUrl>
Content-Type: text/plain

[Your file content here]

{
  "name": "FAQ Knowledge Base",
  "advanced": {
    "documents": [
      {
        "documentId": "doc_abc123",
        "exampleQueries": [
          "How do I reset my password?",
          "What are the password requirements?",
          "I forgot my login credentials"
        ]
      },
      {
        "documentId": "doc_def456",
        "exampleQueries": [
          "What payment methods do you accept?",
          "Can I pay with PayPal?",
          "How do I update my billing information?"
        ]
      }
    ]
  }
}

​

Example Query Requirements

• be 1–400 characters long;
• contain actual content (no empty or whitespace-only queries);
• contain no null bytes;
• be distinct from the other queries for the same document.

​

Limits

• 10 example queries per document
• 400 characters per query
• 200 documents per source (the same as other source types)
• 10 MB per document (the same as file uploads)
• No null bytes in uploaded documents