Convex Agent skill

O que ela faz

A skill faz o Claude instalar no app o @convex-dev/agent e o @convex-dev/ai-sdk-provider e adicionar o componente de agente no convex.config.ts. Com isso o backend ganha conversas que não se perdem, histórico de mensagens, chamadas de ferramentas e busca vetorial, a base de um assistente de IA dentro do seu produto.

O agente é definido com instruções e ferramentas e chama o modelo pelo AI Gateway do Convex, que guarda as credenciais do provedor: no plano pago do Convex Cloud, você não precisa de chave do modelo. As respostas chegam aos poucos (streaming), as mensagens ficam salvas no Convex e nenhuma chave vai pro navegador.

Pra RAG, os documentos viram embeddings num índice vetorial e o agente busca neles por uma ferramenta. Como o gateway ainda não faz embeddings, essa parte pede a chave de um provedor, guardada nas variáveis de ambiente do Convex. No plano grátis, em servidor próprio ou local, o modelo também é chamado com chave própria.

Nas palavras de quem fez

Quando usar

• Colocar um assistente de atendimento dentro do seu app
• Criar um chat que responde com base nos seus documentos ou na sua base de conhecimento
• Guardar o histórico das conversas de cada cliente
• Dar ao agente ferramentas pra consultar os dados do próprio app

Depois de instalar, é só pedir assim

• Adiciona um agente de IA no meu app Convex que responde as dúvidas dos clientes
• Faz o agente buscar as respostas nos artigos da central de ajuda que estão no banco
• Salva as conversas de cada usuário pra ele ver o histórico depois

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykPassou

Perguntas