convex-agents

Design stateful AI agents with thread management and tool integration in Convex.

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/benfwalla/things-to-be-happy-about --skill convex-agents-benfwalla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-agents
Source: https://github.com/benfwalla/things-to-be-happy-about/tree/main/.claude/skills/convex-agents
Command: npx skills add https://github.com/benfwalla/things-to-be-happy-about --skill convex-agents-benfwalla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable developers to build persistent, stateful AI agents using Convex that can manage conversations, run tools, and orchestrate long-running workflows.

Core Features & Use Cases

  • Persistent state and conversation history across restarts.
  • Real-time streaming responses and tool execution to clients.
  • Tool integration: run Convex functions as agent tools for tasks like data retrieval, task creation, and computations.
  • Durable workflows: long-running agent tasks with reliability and fault tolerance.
  • RAG capabilities: vector-based retrieval to inform agents with relevant knowledge.
  • Use Case: a customer support assistant that remembers context, calls tools to fetch order information, and generates summarized responses.

Quick Start

Set up a Convex Agent and connect your OpenAI API key to start a basic persistent agent workflow.

Frequently Asked Questions about convex-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build AI agents with persistent state in Convex?

Persistent AI agents in Convex maintain conversation history and state across restarts by using durable workflows and thread management, ensuring reliable context retention for chat and task automation.

What is the best way to run durable workflows for AI agents in Convex?

Durable workflows for AI agents in Convex are built using fault-tolerant task orchestration, allowing long-running agent tasks to execute reliably with real-time streaming responses and tool execution.

How does RAG retrieval work with AI agents in Convex?

RAG retrieval with AI agents in Convex uses vector-based retrieval to inform agents with relevant knowledge, enabling tasks like context-aware customer support by fetching specific data through integrated tools.

Can I use Convex functions as tools for LLM agent execution?

Yes, you can use Convex functions as tools for LLM agent execution, allowing the agent to run queries for data retrieval, task creation, and computations while streaming real-time responses to clients.

Do I need an OpenAI API key to set up a persistent agent workflow in Convex?

Yes, you need an OpenAI API key to set up a basic persistent agent workflow in Convex, connecting the key to your Convex Agent to initialize state management and streaming capabilities.