convex-agents

Develop stateful AI agents with streaming responses and tool execution on Convex.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/debsouryadatta/memo-hack --skill convex-agents-debsouryadatta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-agents
Source: https://github.com/debsouryadatta/memo-hack/tree/main/.agent/skills/convex-agents
Command: npx skills add https://github.com/debsouryadatta/memo-hack --skill convex-agents-debsouryadatta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @convex-dev/agent, ai, openai, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a robust framework for building persistent, stateful AI agents that can interact with users, execute tools, and manage complex workflows using the Convex platform.

Core Features & Use Cases

  • Thread Management: Maintain conversation history and context across user interactions.
  • Tool Integration: Allow agents to call external functions and Convex mutations/queries as tools.
  • RAG Patterns: Implement Retrieval Augmented Generation for knowledge retrieval and context-aware responses.
  • Workflow Orchestration: Design and execute multi-step agentic workflows.
  • Use Case: Develop a customer support agent that can access a knowledge base, create support tickets, and provide real-time assistance to users.

Quick Start

Use the convex-agents skill to create a new conversation thread for the current user.

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 and real-time streaming?

You can build stateful AI agents with real-time streaming by using the Convex Agent component to maintain conversation threads, execute tools, and orchestrate workflows alongside an LLM provider like OpenAI.

Can I implement RAG patterns for AI agents using Convex?

You can implement Retrieval Augmented Generation (RAG) patterns for AI agents using Convex to retrieve knowledge and deliver context-aware responses while maintaining persistent conversation history.

Do I need an OpenAI integration to use Convex for workflow orchestration?

Yes, integrating an LLM provider like OpenAI is required for workflow orchestration with Convex agents. Convex provides backend durability and state management, while the LLM provider handles conversational reasoning.

How do AI agents execute external tools and Convex mutations?

AI agents execute external tools and Convex mutations through the Convex Agent component, which allows agents to call external functions and Convex queries directly as tools during multi-step agentic workflows.

What is the best way to manage conversation history across user interactions in AI agents?

The best way to manage conversation history in AI agents is using thread management. The Convex Agent component maintains persistent context and conversation history across user interactions for stateful applications.

Are there limitations when building multi-step agentic workflows on Convex?

Limitations when building multi-step agentic workflows on Convex involve dependency constraints, as the framework explicitly requires the @convex-dev/agent, ai, and openai packages to handle state management and tool execution.