This plugin is currently in beta. While it is considered safe for use, please be aware that its API could change in ways that are not compatible with earlier versions in future releases, or it might become unsupported.
Ingest documents into an embedding store.
Only text documents (TXT, HTML, Markdown) are supported for now.
type: "io.kestra.plugin.ai.rag.IngestDocument"
Examples
Ingest documents into a KV embedding store.\nWARNING: the KV embedding store is for quick prototyping only, as it stores the embedding vectors in a K/V Store and load them all in memory.
id: document-ingestion
namespace: company.team
tasks:
- id: ingest
type: io.kestra.plugin.ai.rag.IngestDocument
provider:
type: io.kestra.plugin.ai.provider.GoogleGemini
modelName: gemini-embedding-exp-03-07
apiKey: "{{ secret('GEMINI_API_KEY') }}"
embeddings:
type: io.kestra.plugin.ai.embeddings.KestraKVStore
drop: true
fromExternalURLs:
- https://raw.githubusercontent.com/kestra-io/docs/refs/heads/main/content/blogs/release-0-22.md
Properties
embeddings *RequiredNon-dynamicChromaElasticsearchKestraKVStoreMilvusMongoDBAtlasPGVectorPineconeQdrantWeaviate
Embedding Store Provider
provider *RequiredNon-dynamicAmazonBedrockAnthropicAzureOpenAIDeepSeekGoogleGeminiGoogleVertexAIMistralAIOllamaOpenAI
Language Model Provider
This provider must be configured with an embedding model.
documentSplitter Non-dynamicIngestDocument-DocumentSplitter
The document splitter
drop booleanstring
false
Whether to drop the store before ingestion. Useful for testing purpose.
fromExternalURLs array
A list of document URLs from external sources
fromInternalURIs array
A list of internal storage URIs representing documents
Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}
.
fromPath string
A path inside the task working directory that contains documents to ingest
Each document inside the directory will be ingested into the embedding store. This is recursive and protected from being path traversal (CWE-22).
metadata object
Additional metadata that will be added to all ingested documents
Outputs
embeddingStoreOutputs object
Additional outputs from the embedding store.
ingestedDocuments integer
The number of ingested documents
inputTokenCount integer
The input token count
outputTokenCount integer
The output token count
totalTokenCount integer
The total token count
Definitions
Azure OpenAI Model Provider
endpoint *Requiredstring
API endpoint
The Azure OpenAI endpoint in the format: https://{resource}.openai.azure.com/
modelName *Requiredstring
Model name
type *Requiredobject
apiKey string
API Key
clientId string
Client ID
clientSecret string
Client secret
serviceVersion string
API version
tenantId string
Tenant ID
PGVector Embedding Store
database *Requiredstring
The database name
host *Requiredstring
The database server host
password *Requiredstring
The database password
port *Requiredintegerstring
The database server port
table *Requiredstring
The table to store embeddings in
type *Requiredobject
user *Requiredstring
The database user
useIndex booleanstring
false
Whether to use use an IVFFlat index
An IVFFlat index divides vectors into lists, and then searches a subset of those lists closest to the query vector. It has faster build times and uses less memory than HNSW but has lower query performance (in terms of speed-recall tradeoff).
Qdrant Embedding Store
apiKey *Requiredstring
The API key
collectionName *Requiredstring
The collection name
host *Requiredstring
The database server host
port *Requiredintegerstring
The database server port
type *Requiredobject
Google VertexAI Model Provider
endpoint *Requiredstring
Endpoint URL
location *Requiredstring
Project location
modelName *Requiredstring
Model name
project *Requiredstring
Project ID
type *Requiredobject
Google Gemini Model Provider
apiKey *Requiredstring
API Key
modelName *Requiredstring
Model name
type *Requiredobject
MongoDB Atlas Embedding Store
collectionName *Requiredstring
The collection name
host *Requiredstring
The host
indexName *Requiredstring
The index name
scheme *Requiredstring
The scheme (e.g. mongodb+srv)
type *Requiredobject
createIndex booleanstring
Create the index
database string
The database
metadataFieldNames array
The metadata field names
options object
The connection string options
password string
The password
username string
The username
Mistral AI Model Provider
apiKey *Requiredstring
API Key
modelName *Requiredstring
Model name
type *Requiredobject
baseUrl string
API base URL
In-memory Embedding Store that then store its serialization form as a Kestra K/V pair
type *Requiredobject
kvName string
{{flow.id}}-embedding-store
The name of the K/V entry to use
Chroma Embedding Store
baseUrl *Requiredstring
The database base URL
collectionName *Requiredstring
The collection name
type *Requiredobject
io.kestra.plugin.ai.embeddings.Elasticsearch-ElasticsearchConnection-BasicAuth
password string
Basic auth password.
username string
Basic auth username.
Milvus Embedding Store
token *Requiredstring
The token
type *Requiredobject
autoFlushOnDelete booleanstring
Whether to auto flush on delete
autoFlushOnInsert booleanstring
Whether to auto flush on insert
collectionName string
The collection name
If there is no such collection yet, it will be created automatically. Default value: "default".
consistencyLevel string
The consistency level
databaseName string
The database name
If not provided, the default database will be used.
host string
The host
Default value: "localhost"
idFieldName string
The id field name
indexType string
The index type
metadataFieldName string
The metadata field name
metricType string
The metric type
password string
The password
If user authentication and TLS is enabled, this parameter is required. See: https://milvus.io/docs/authenticate.md
port integerstring
The port
Default value: "19530"
retrieveEmbeddingsOnSearch booleanstring
Whether to retrieve embeddings on search
textFieldName string
The text field name
uri string
The uri
username string
The username
If user authentication and TLS is enabled, this parameter is required. See: https://milvus.io/docs/authenticate.md
vectorFieldName string
The vector field name
Deepseek Model Provider
apiKey *Requiredstring
API Key
modelName *Requiredstring
Model name
type *Requiredobject
baseUrl string
https://api.deepseek.com/v1
API base URL
Pinecone Embedding Store
apiKey *Requiredstring
The API key
cloud *Requiredstring
The cloud provider
index *Requiredstring
The index
region *Requiredstring
The cloud provider region
type *Requiredobject
namespace string
The namespace (default will be used if not provided)
Anthropic AI Model Provider
apiKey *Requiredstring
API Key
modelName *Requiredstring
Model name
type *Requiredobject
io.kestra.plugin.ai.rag.IngestDocument-DocumentSplitter
maxOverlapSizeInChars *Requiredinteger
The maximum size of the overlap, defined in characters. Only full sentences are considered for the overlap.
maxSegmentSizeInChars *Requiredinteger
The maximum size of the segment, defined in characters.
splitter string
RECURSIVE
RECURSIVE
PARAGRAPH
LINE
SENTENCE
WORD
Title the type of the DocumentSplitter
We recommend using a RECURSIVE DocumentSplitter for generic text. It tries to split the document into paragraphs first and fits as many paragraphs into a single TextSegment as possible. If some paragraphs are too long, they are recursively split into lines, then sentences, then words, and then characters until they fit into a segment.
Weaviate Embedding Store
apiKey *Requiredstring
Weaviate API key
Your Weaviate API key. Not required for local deployment.
host *Requiredstring
Weaviate host
The host, e.g. "ai-4jw7ufd9.weaviate.network" of cluster URL. Find in under Details of your Weaviate cluster.
type *Requiredobject
avoidDups booleanstring
Weaviate avoid dups
If true (default), then WeaviateEmbeddingStore will generate a hashed ID based on provided text segment, which avoids duplicated entries in DB. If false, then random ID will be generated.
consistencyLevel string
ONE
QUORUM
ALL
Weaviate consistency level
Consistency level: ONE, QUORUM (default) or ALL.
grpcPort integerstring
gRPC port if used
metadataFieldName string
Weaviate metadata field name
The name of the metadata field to store. If not provided, will default to "_metadata".
metadataKeys array
Weaviate metadata keys
The list of metadata keys to store. If not provided, will default to an empty list.
objectClass string
Weaviate object class
The object class you want to store, e.g. "MyGreatClass". Must start from an uppercase letter. If not provided, will default to "Default".
port integerstring
Weaviate port
The port, e.g. 8080. This parameter is optional.
scheme string
Weaviate scheme
The scheme, e.g. "https" of cluster URL. Find in under Details of your Weaviate cluster.
securedGrpc booleanstring
The gRPC connection is secured
useGrpcForInserts booleanstring
Use gRPC for inserts
Use GRPC instead of HTTP for batch inserts only. You still need HTTP configured for search.
Ollama Model Provider
endpoint *Requiredstring
Model endpoint
modelName *Requiredstring
Model name
type *Requiredobject
OpenAI Model Provider
apiKey *Requiredstring
API Key
modelName *Requiredstring
Model name
type *Requiredobject
baseUrl string
API base URL
io.kestra.plugin.ai.rag.IngestDocument-InlineDocument
content *Requiredstring
The content of the document
metadata object
The metadata of the document
io.kestra.plugin.ai.embeddings.Elasticsearch-ElasticsearchConnection
hosts *Requiredarray
1
List of HTTP ElasticSearch servers.
Must be an URI like https://elasticsearch.com: 9200
with scheme and port.
basicAuth Elasticsearch-ElasticsearchConnection-BasicAuth
Basic auth configuration.
headers array
List of HTTP headers to be send on every request.
Must be a string with key value separated with :
, ex: Authorization: Token XYZ
.
pathPrefix string
Sets the path's prefix for every request used by the HTTP client.
For example, if this is set to /my/path
, then any client request will become /my/path/
+ endpoint.
In essence, every request's endpoint is prefixed by this pathPrefix
.
The path prefix is useful for when ElasticSearch is behind a proxy that provides a base path or a proxy that requires all paths to start with '/'; it is not intended for other purposes and it should not be supplied in other scenarios.
strictDeprecationMode booleanstring
Whether the REST client should return any response containing at least one warning header as a failure.
trustAllSsl booleanstring
Trust all SSL CA certificates.
Use this if the server is using a self signed SSL certificate.
Elasticsearch Embedding Store
connection *RequiredElasticsearch-ElasticsearchConnection
indexName *Requiredstring
The name of the index to store embeddings
type *Requiredobject
Amazon Bedrock Model Provider
accessKeyId *Requiredstring
AWS Access Key ID
modelName *Requiredstring
Model name
secretAccessKey *Requiredstring
AWS Secret Access Key
type *Requiredobject
modelType string
COHERE
COHERE
TITAN
Amazon Bedrock Embedding Model Type