nodes / builtin / ai / aidependencies / embeddings
Voyage Embeddings
Leverage Voyage AI to create embeddings.
Turn text into vectors with Voyage AI’s embedding models, so a knowledge base can find passages by meaning.
What it does
Section titled “What it does”Voyage Embeddings plugs into the Embeddings slot of a Local Knowledge node. It does not run on its own and has no output. When the knowledge base is filled or searched, the text is sent to Voyage AI with your key and comes back as vectors (lists of numbers that capture meaning).
A knowledge base remembers the embedding model it was built with and always uses it. So this node decides the model when a new, empty knowledge base is first filled. After that, connect the same node to search it.
Your passages and questions are sent to Voyage AI. For text that must stay on your device, use Local Embeddings.
When to use it
Section titled “When to use it”- You want Voyage’s retrieval-focused models, for example for long technical or legal documents.
- You already have a Voyage AI account.
Inputs and settings
Section titled “Inputs and settings”| Setting | Type | What it does |
|---|---|---|
| Model (required) | Text | The embeddings model to use. |
| Authentication (required) | Credential | Use your Voyage API key. |
Type the Model id as Voyage AI names it, for example voyage-large-2. Don’t change it on a knowledge base that already has content.
Outputs
Section titled “Outputs”This node has no output port. It plugs into a slot on another node instead of passing items along.
- Embeddings slot of Local Knowledge
The vectors go to the knowledge base, not to the next node.
Dependencies and credentials
Section titled “Dependencies and credentials”- Authentication (connection): required. See Connect Voyage.
In Authentication, save your Voyage AI API key. Create it on the API keys page of the Voyage AI dashboard. See Create a credential.
Example workflow
Section titled “Example workflow”- A Context Menu trigger on the page.
- Get All Text with Output field name
pageText. - Indexer with Input
{{ $input.pageText }}, a Recursive Character Text Splitter in its Text Splitter slot, and a Local Knowledge pointing to a new knowledge base in its Knowledge slot. - Voyage Embeddings in the Local Knowledge’s Embeddings slot, Model
voyage-large-2.
Common issues
Section titled “Common issues”- “Model parameter is required and cannot be empty”. Fill in Model.
- “… was built with … embeddings. Connect that embeddings node to use it.” The knowledge base was built with this Voyage model. Connect Voyage Embeddings with the same Model to its Local Knowledge.
- A “Model mismatch” warning in the run log. The knowledge base was built with another model, so this node was ignored. Disconnect it, or re-embed the knowledge base from its settings.
- A 401 error. The key is wrong or revoked. Create a new key and update the credential.
Related nodes
Section titled “Related nodes”- Local Knowledge: the knowledge base it plugs into.
- Cohere Embeddings, OpenAI Embeddings: other cloud embedding models.
- Local Embeddings: free and on your device.