Agent Skills › ajanraj/OpenChat › convex-agent

convex-agent

GitHub

为 Convex 应用集成 AI Agent 和 RAG 后端,支持持久化对话、工具调用及向量搜索。利用 Convex AI Gateway 简化模型接入,自动处理凭证管理,并提供降级方案以适配不同部署环境。

.agents/skills/convex-agent/SKILL.md ajanraj/OpenChat

触发场景

需要添加 AI 助手功能 实现 RAG 检索增强生成 集成大语言模型到现有应用

安装

npx skills add ajanraj/OpenChat --skill convex-agent -g -y
更多选项

非标准路径

npx skills add https://github.com/ajanraj/OpenChat/tree/main/.agents/skills/convex-agent -g -y

不安装直接使用

npx skills use ajanraj/OpenChat@convex-agent

指定 Agent (Claude Code)

npx skills add ajanraj/OpenChat --skill convex-agent -a claude-code -g -y

安装 repo 全部 skill

npx skills add ajanraj/OpenChat --all -g -y

预览 repo 内 skill

npx skills add ajanraj/OpenChat --list

SKILL.md

Frontmatter
{
    "name": "convex-agent",
    "description": "Add an AI agent \/ RAG backend (@convex-dev\/agent) to the Convex app."
}

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. Call models through the Convex AI Gateway by default: Convex holds the provider credentials, so there is no LLM key to obtain, store, or rotate.

Workflow

  1. Install @convex-dev/agent + @convex-dev/ai-sdk-provider; add the agent component to convex.config.ts.
  2. Define the agent (tools, instructions) with languageModel: convexGateway("provider/model") — no API key needed (needs convex 1.45+ on a Convex Cloud deployment, paid plan).
  3. Create threads + stream messages; persist history in Convex.
  4. For RAG: embed docs into a vector index and retrieve in the tool. The gateway does not serve embeddings yet, so store the embedding provider's key via the env micro power.
  5. Only if the gateway is unavailable (free plan, self-hosted, local backend): call the provider SDK with a key stored via the env micro power.

Rules

  • Default to the Convex AI Gateway (convexGateway from @convex-dev/ai-sdk-provider) for model calls; fall back to a provider key in Convex env only where the gateway is unavailable (free plan, self-hosted, local backend).
  • Never expose a provider API key client-side; when one is needed (embeddings, gateway fallback), keep it in Convex env via the env micro power.
  • Run model calls in actions ('use node' if the SDK needs it).
  • Persist threads/messages in Convex for durability + reactivity.

版本历史

  • 55de5cd 当前 2026-10-19 22:52

同 Skill 集合

.agents/skills/convex-add/SKILL.md
.agents/skills/convex-advisor/SKILL.md
.agents/skills/convex-auth/SKILL.md
.agents/skills/convex-authz/SKILL.md
.agents/skills/convex-backup/SKILL.md
.agents/skills/convex-billing/SKILL.md
.agents/skills/convex-cost/SKILL.md
.agents/skills/convex-create-component/SKILL.md
.agents/skills/convex-crons/SKILL.md
.agents/skills/convex-deploy-guard/SKILL.md
.agents/skills/convex-design/SKILL.md
.agents/skills/convex-docs/SKILL.md
.agents/skills/convex-domains/SKILL.md
.agents/skills/convex-env/SKILL.md
.agents/skills/convex-expert/SKILL.md
.agents/skills/convex-explain-app/SKILL.md
.agents/skills/convex-insights/SKILL.md
.agents/skills/convex-launch-readiness/SKILL.md
.agents/skills/convex-migrate-rehearse/SKILL.md
.agents/skills/convex-migrate/SKILL.md
.agents/skills/convex-migration-helper/SKILL.md
.agents/skills/convex-monitor/SKILL.md
.agents/skills/convex-optimize/SKILL.md
.agents/skills/convex-performance-audit/SKILL.md
.agents/skills/convex-quickstart/SKILL.md
.agents/skills/convex-reviewer/SKILL.md
.agents/skills/convex-self-heal/SKILL.md
.agents/skills/convex-sentinel/SKILL.md
.agents/skills/convex-setup-auth/SKILL.md
.agents/skills/convex-suggest/SKILL.md
.agents/skills/convex-test/SKILL.md
.agents/skills/convex-verify/SKILL.md
.agents/skills/convex-seed/SKILL.md
.agents/skills/convex/SKILL.md

元信息

文件数
0
版本
55de5cd
Hash
d4ab9270
收录时间
2026-10-19 22:52

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 16:18
浙ICP备14020137号-1