Advanced Analytica Advanced Analytica: IBOM
← All connectors
Ragie logo

Destination connector

Ragie

Send governed data into Ragie with a clear, practical setup guide.

Version 0.1.1 community alpha

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 modeSupported?
Full Refresh - OverwriteYes
Full Refresh - AppendYes
Full Refresh - Overwrite + DedupedYes
Incremental Sync - AppendYes
Incremental Sync - Append + DedupedYes

Prerequisites


Set up the connector

1. Configure Airbyte

Go to Destinations → + New Destination → Ragie.

2. Complete the fields

FieldDescriptionRequired
API KeyYour secret Ragie API token.✅ Yes
Content FieldsList 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 FieldsField(s) to include as metadata. Use dot notation for nested fields.⛔ Optional
Partition NameName of the partition/index in Ragie to write into. When empty, the connector omits the partition so Ragie writes to its default partition.⛔ Optional
ModeIngestion mode: 'fast' (default) or 'hi_res'.✅ Yes
Document Name FieldField 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 FieldField to use as unique document ID (external_id) for deduplication. Required for append+dedup mode.⛔ Optional
API URLURL of Ragie API. Only change if using a private Ragie deployment. Defaults to https://api.ragie.ai.⛔ Optional

Sync modes

ModeBehavior
AppendAdds documents to Ragie.
OverwriteDeletes existing documents in the partition before writing.
Append + DedupUses 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_field for 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

VersionDatePull RequestChanges
0.1.12026-10-0788292Fix floating-point metadata writes, omit empty partitions, and stop logging authorization headers.
0.1.0Initial release with overwrite/append support and field mapping.

Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.