| name | agent |
| description | Build an AI agent / RAG feature on Convex (@convex-dev/agent: threads, tools, vector search). TRIGGER on an AI-agent/chatbot/RAG request. |
| license | Apache-2.0 |
Add an AI agent / RAG backend
Install @convex-dev/agent for durable threads, message history, tool-calls, and vector search/RAG — the backend for an in-app AI agent.
Steps
- Install @convex-dev/agent + add to convex.config.ts.
- Define the agent (model, tools, instructions); store the LLM key via the
env micro power.
- Create threads + stream messages; persist history in Convex.
- For RAG: embed docs into a vector index and retrieve in the tool.
Rules
- Keep the LLM API key in Convex env (use the
env micro power), never client-side.
- Run model calls in actions ('use node' if the SDK needs it).
- Persist threads/messages in Convex for durability + reactivity.