Embeddings

Embeddings power recall and guide relevance. Without embeddings, Aionis can still accept structured writes, but guide quality depends on recall coverage.

First-run Provider


export EMBEDDING_PROVIDER="openai"
export OPENAI_API_KEY="your-openai-key"

MiniMax is also supported:


export EMBEDDING_PROVIDER="minimax"
export MINIMAX_API_KEY="your-minimax-key"

Operational Notes

Topic	Guidance
Provider choice	Better embeddings can improve candidate recall, but they do not replace lifecycle governance.
Query vs document shape	Some providers distinguish query and document embeddings. Use the supported Runtime configuration.
Failures	Check provider API key, network access, and rate limits.
Cost	Embedding cost is usually lower than Agent LLM cost, but high write volume should still be measured.

The Memory Firewall and Execution Memory layers still matter even with strong embeddings. Embeddings find related content; Aionis decides whether it is safe to use.