Ragie
Overview
The Ragie destination connector sends data from any Airbyte source to Ragie.ai, a platform for semantic search, vector storage and AI-powered document retrieval.
The connector turns your records into documents. It ingests them into Ragie’s vector index through its API. You can map metadata, name documents and remove duplicates using external IDs.
Features
- Extracts vector content from your specified fields.
- Attaches custom or static metadata to each document.
- Assigns document names and external IDs.
- Supports partitioning across multiple datasets (indexes).
Supported sync modes
| Sync mode | Supported? |
|---|---|
| Full Refresh - Overwrite | Yes |
| Full Refresh - Append | Yes |
| Full Refresh - Overwrite + Deduped | Yes |
| Incremental Sync - Append | Yes |
| Incremental Sync - Append + Deduped | Yes |
Prerequisites
- A Ragie.ai account.
- A valid API Key (from the Ragie Dashboard).
- Your desired data schema and field mappings.
Set up the connector
1. Configure Airbyte
Go to Destinations → + New Destination → Ragie.
2. Complete the fields
| Field | Description | Required |
|---|---|---|
| API Key | Your secret Ragie API token. | ✅ Yes |
| Content Fields | List of field(s) from the record to use as the main document content (text). If empty, the whole record is used. Supports dot notation. | ⛔ Optional |
| Metadata Fields | Field(s) to include as metadata. Use dot notation for nested fields. | ⛔ Optional |
| Partition Name | Name of the partition/index in Ragie to write into. When empty, the connector omits the partition so Ragie writes to its default partition. | ⛔ Optional |
| Mode | Ingestion mode: 'fast' (default) or 'hi_res'. | ✅ Yes |
| Document Name Field | Field to use as the document’s display name. Auto-generated if empty. | ⛔ Optional |
| Static Metadata (JSON) | JSON string of key-value pairs added to every document’s metadata. | ⛔ Optional |
| External ID Field | Field to use as unique document ID (external_id) for deduplication. Required for append+dedup mode. | ⛔ Optional |
| API URL | URL of Ragie API. Only change if using a private Ragie deployment. Defaults to https://api.ragie.ai. | ⛔ Optional |
Sync modes
| Mode | Behavior |
|---|---|
| Append | Adds documents to Ragie. |
| Overwrite | Deletes existing documents in the partition before writing. |
| Append + Dedup | Uses external_id_field to upsert (insert or update) documents. |
Example
Incoming record
{
"ticket_id": "1234",
"description": "The app crashes when I click save.",
"user": {
"id": "u_567",
"email": "[email protected]"
}
}
Configuration
{
"content_fields": ["description"],
"metadata_fields": ["user.id", "user.email"],
"document_name_field": "ticket_id",
"external_id_field": "ticket_id"
}
Resulting document in Ragie
{
"external_id": "1234",
"name": "1234",
"content": "The app crashes when I click save.",
"metadata": {
"user.id": "u_567",
"user.email": "[email protected]"
}
}
Static metadata
You can add metadata to every document by entering a valid JSON string:
Example:
{"source": "airbyte", "env": "prod"}
The connector merges this with each document’s metadata.
Error handling
- Validates all fields when connecting.
- Logs errors when you reference invalid content or metadata fields.
- Checks your API credentials and whether the endpoint is reachable.
Limitations
- You must provide an
external_id_fieldfor deduplication to work. - Content fields currently support only top-level arrays or objects.
- Ragie currently supports a limited set of ingestion modes (
fast,hi_res).
Namespace support
This destination supports namespaces.
Changelog
| Version | Date | Pull Request | Changes |
|---|---|---|---|
| 0.1.1 | 2026-10-07 | 88292 | Fix floating-point metadata writes, omit empty partitions, and stop logging authorization headers. |
| 0.1.0 | Initial release with overwrite/append support and field mapping. |