convez.ai
SkillDesenvolvimento WebIntermediário
mixuechu

Assistente IA com NL2SQL para FastAPI

mixuechu/ai-assistant-setup

Integra NL2SQL em FastAPI com um comando

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude que integra automaticamente um assistente de IA com capacidade NL2SQL em sistemas FastAPI + SQLAlchemy. Analisa schemas de banco, gera adaptadores, cria rotas no backend e componentes no frontend React, permitindo usuários consultarem dados via linguagem natural.

Instalação

$npx convez-ai mixuechu/ai-assistant-setup

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Adicionar busca conversacional em bancos de dados existentes
  • Criar chatbots que consultam dados sem escrever SQL manualmente
  • Automatizar geração de rotas de IA em APIs FastAPI

Veredito

Ferramenta sólida para acelerar integração de IA conversacional em stacks FastAPI/SQLAlchemy. Requer Python 3.10+, dependências específicas (FastAPI, SQLAlchemy async, JWT) e pelo menos uma chave LLM; vale a pena para quem quer NL2SQL com proteções de segurança (validação SQL, whitelist de tabelas).

README

A tradução para o português deste README ainda está na fila.

ai-assistant-setup

Claude Code Skill — 一键为 FastAPI + SQLAlchemy 系统集成 NL2SQL AI 助手。

它做什么

运行 /ai-assistant-setup 后,Claude 会自动:

  1. 分析你的数据库 models,提取 schema
  2. Clone ai-assistant-engine
  3. 生成适配器代码(认证、SQL 执行、Schema 描述)
  4. 在你的后端创建 AI 路由
  5. 在你的前端添加 AI 聊天组件
  6. 配置依赖和环境变量

完成后,你的系统就拥有了一个带 NL2SQL 的 AI 助手 — 用户可以用自然语言查询数据库。

要求

  • Python 3.10+
  • FastAPI + SQLAlchemy (async) + JWT 认证
  • 前端 React + TypeScript(可选,没有则跳过前端集成)
  • 至少一个 LLM API key(DeepSeek / Claude / OpenAI)

安装

在 Claude Code 中:

/plugin marketplace add mixuechu/ai-assistant-setup
/plugin install ai-assistant-setup

或者手动:

git clone https://github.com/mixuechu/ai-assistant-setup.git ~/.claude/skills/ai-assistant-setup

使用

在你的 FastAPI 项目目录中,对 Claude 说:

/ai-assistant-setup

或者直接说"帮我集成 AI 助手"、"给系统加个 AI"。

支持的 LLM

Provider环境变量模型
DeepSeekDEEPSEEK_API_KEYdeepseek-chat
Claude (API)ANTHROPIC_API_KEYclaude-sonnet-4-6
Claude (Vertex AI)GOOGLE_CLOUD_PROJECTclaude-sonnet-4-6
OpenAIOPENAI_API_KEYgpt-4o

安全

NL2SQL 三层防护:

  • System Prompt — 指导 LLM 只写 SELECT
  • SqlValidator — SELECT-only + 表白名单 + 自动 LIMIT + 多语句拒绝
  • 数据库 — 建议生产环境用只读连接

敏感表(含 password/secret/token/permission 字段的表)自动排除。

License

MIT

Ver o original no GitHub

Bom para

Relacionados