# Convex Agent > Añade un backend de agente de IA / RAG (@convex-dev/agent) a la app Convex. Fuente: https://skillsagentes.com/skills/get-convex/agent-skills/convex-agent Markdown: https://skillsagentes.com/skills/get-convex/agent-skills/convex-agent.md Repositorio: https://github.com/get-convex/agent-skills Autor: get-convex Licencia: Apache-2.0 Actualizado: el mes pasado Coste de contexto: 17 tok instalada, 430 tok al activarse, 430 tok con todos los archivos del bundle Bundle: 1 archivo, 2 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add get-convex/agent-skills --skill convex-agent --agent claude-code # Cursor npx -y skills add get-convex/agent-skills --skill convex-agent --agent cursor # Codex npx -y skills add get-convex/agent-skills --skill convex-agent --agent codex # Gemini CLI npx -y skills add get-convex/agent-skills --skill convex-agent --agent gemini # Windsurf npx -y skills add get-convex/agent-skills --skill convex-agent --agent windsurf # Cline npx -y skills add get-convex/agent-skills --skill convex-agent --agent cline ``` ## Qué hace - Instala y configura @convex-dev/agent para threads durables, historial de mensajes, tool-calls y búsqueda vectorial/RAG - Añade el componente agent a convex.config.ts - Configura llamadas a modelos vía Convex AI Gateway (convexGateway) sin necesitar una API key de LLM - Para RAG, embebe documentos en un índice vectorial y los recupera desde una tool - Guarda claves de proveedor en el entorno de Convex vía la micro power `env` cuando el gateway no esté disponible o para embeddings ## Cuándo usarla - Quieres añadir un backend de agente de IA / RAG a una app Convex - Necesitas threads persistentes, historial de mensajes y tool-calls en Convex - Necesitas RAG con búsqueda vectorial sobre documentos embebidos ## Qué la activa - "Añade un agente de IA con Convex a mi app" - "Configura RAG con Convex y búsqueda vectorial" - "Quiero threads persistentes de chat con tool-calls en Convex" ## Antes de instalar - Requiere Convex 1.45+ en un deployment de Convex Cloud con plan de pago para usar el AI Gateway; en plan gratuito, self-hosted o backend local hace falta una key de proveedor guardada vía la micro power `env`. ## Archivos - SKILL.md — 2 KB ## SKILL.md Reproducido tal cual desde get-convex/agent-skills bajo Apache-2.0. Esta sección es el documento original y está en inglés. # 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. ## Dónde encaja - Categoría: [Desarrollo de APIs](https://skillsagentes.com/categorias/desarrollo-apis.md) — Diseña, prueba y documenta APIs HTTP y GraphQL. - Creador: [get-convex](https://skillsagentes.com/creators/get-convex.md) — 33 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Convex Quickstart](https://skillsagentes.com/skills/get-convex/agent-skills/convex-quickstart.md): Levanta un template Next.js + Convex barebones a partir de una idea en una frase. - [Convex Design](https://skillsagentes.com/skills/get-convex/agent-skills/convex-design.md): Diseña y construye backends reactivos y type-safe de nivel producción en Convex: schema, queries/mutations/actions, índices, auth, storage, scheduling, multiplayer en tiempo real y workflows LLM/agentes. - [Convex Authz](https://skillsagentes.com/skills/get-convex/agent-skills/convex-authz.md): Audita y refuerza la autorización de una app Convex: impersonación por identity-from-arg, checks de ownership por documento faltantes, queries públicas que filtran datos por un id del cliente y escrituras en un contenedor ajeno. - [Convex Expert](https://skillsagentes.com/skills/get-convex/agent-skills/convex-expert.md): Especialista en el backend de Convex: código dentro de convex/ (funciones, schemas, índices, queries, mutations, actions, endpoints HTTP, cron jobs, storage, auth y componentes). - [Convex Create Component](https://skillsagentes.com/skills/get-convex/agent-skills/convex-create-component.md): Construye componentes Convex reutilizables con tablas aisladas y APIs de cara a la app. Útil para nuevos componentes, módulos de backend reutilizables, integraciones o límites de componentes. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)