AI Dev Kit Apps技能：AppKit TypeScript与Python框架选型指南

AI Dev Kit Apps技能AppKit TypeScript与Python框架选型指南【免费下载链接】ai-dev-kitDatabricks Toolkit for Coding Agents provided by Field Engineering项目地址: https://gitcode.com/GitHub_Trending/ai/ai-dev-kitAI Dev Kit 的databricks-apps-python技能是构建 Databricks Apps 的核心入口它优先推荐AppKitTypeScript React SDK当必须使用 Python 时再回退到Dash、Streamlit、Gradio、Flask、FastAPI、Reflex六大框架。本文用一篇指南讲清选型逻辑、必查清单与部署路径帮你一次选对框架。1️⃣ 这个技能是什么databricks-apps-python是一份 Markdown 技能文件安装到 Claude Code、Cursor、Copilot 等 AI 编码环境后你的 AI 助手会自动遵循 Databricks Apps 的最佳实践——从框架选型、授权配置到资源接入和部署验证全程有经验可循。技能的入口文件是 SKILL.md它内置了一张任务路由表你要做什么技能会引导你阅读从零新建 AppAppKit 路径databricks apps init配置授权应用/用户身份1-authorization.md连接 SQL 仓库、Lakebase 等资源2-app-resources.md选择/深入某个 Python 框架3-frameworks.md部署到 Databricks4-deployment.md使用 LakebasePostgreSQL5-lakebase.md调用基础模型LLMAPIexamples/llm_config.py2️⃣ AppKit新项目的首选TypeScript React对于全新应用技能会毫不犹豫地推荐 AppKit——它是 Databricks 官方推荐的 App 开发 SDK核心优势✅TypeScript React插件化架构端到端类型安全✅内置缓存与遥测查询缓存、可观测性开箱即用✅AI 辅助开发支持通过 CLI 直接查询 AppKit 文档环境要求Node.js v22 和 Databricks CLI v0.295.0。两条命令完成创建与部署databricks apps init # 交互式脚手架生成项目、安装依赖、可选部署 databricks apps deploy # 一键部署AppKit 内置插件一览插件用途Analytics面向 SQL 仓库的类型安全查询文件式、带缓存Genie自然语言对话式 AI/BI 界面Files浏览/上传 Unity Catalog Volume 文件Lakebase连接 LakebaseOLTP PostgreSQL含 OAuth 令牌管理 还可以用npx databricks/appkit docs 你的问题在开发时内联查询 AppKit 文档配合databricks experimental aitools skills install安装 AI 脚手架技能。3️⃣ Python 框架快速选型表6大框架一表看懂当团队只有 Python 能力、或需要特定框架时技能提供了明确的选型表各框架均已预装在 Databricks Apps 运行时中框架最适合的场景app.yaml 启动命令Dash生产级仪表盘、BI 工具、复杂交互[python, app.py]Streamlit快速原型、数据科学应用、内部工具[streamlit, run, app.py]GradioML 模型演示、聊天 UI、多媒体处理[python, app.py]Flask自定义 REST API、轻量 Web、Webhook[gunicorn, app:app, -w, 4, -b, 0.0.0.0:8000]FastAPI异步 API、自动生成 OpenAPI 文档[uvicorn, app:app, --host, 0.0.0.0, --port, 8000]Reflex纯 Python 全栈应用免 JavaScript[reflex, run, --env, prod]官方默认推荐原型用Streamlit、生产仪表盘用Dash、API 服务用FastAPI、ML 演示用Gradio。各框架的 Databricks 专属写法授权头获取、端口覆盖、缓存装饰器等详见 3-frameworks.md。4️⃣ 开工前的 5 项必查清单技能强制要求开发者在动手前逐项确认这也是 AI 助手会主动核对的内容- [ ] 框架已选定 - [ ] 授权策略已定应用授权、用户授权或两者兼用 - [ ] 应用资源已识别SQL 仓库、Lakebase、模型服务端点等 - [ ] 后端数据策略已定SQL 仓库 / Lakebase / SDK - [ ] 部署方式已定CLI 或 DABs两种授权模型各管一段详见 1-authorization.md授权类型原理适用场景应用授权服务主体SDKConfig()自动读取注入的DATABRICKS_CLIENT_ID/SECRET无需手写令牌后台任务、共享数据访问、日志用户授权On-Behalf-Of平台通过x-forwarded-access-token请求头转发当前用户令牌按用户过滤数据、行列级权限、审计⚠️ 资源接入的铁律永远用app.yaml的valueFrom引用资源如valueFrom: sql-warehouse绝不硬编码资源 ID保证应用在不同环境间可移植。5️⃣ 部署CLI、DABs、MCP 三条路径路径最适合关键命令Databricks CLI快速部署、单一环境databricks apps create→workspace import-dir→apps deployDABsAsset Bundles多环境dev/staging/prod、基础设施版本化databricks bundle generate app→bundle deploy -t devMCP 工具程序化管理应用生命周期通过 AI 助手调用技能推荐的工作流是先用 CLI 验证跑通再生成 Bundle 配置纳入版本管理。部署后务必用databricks apps logs app-name检查日志看到App started successfully才算完成。完整步骤见 4-deployment.md。6️⃣ 避坑速查高频问题一次说清问题解决方案端口冲突应用必须绑定DATABRICKS_APP_PORT环境变量默认 8000切勿使用 8080Streamlit 连接数耗尽数据库连接必须用st.cache_resource缓存Streamlit 配置报错st.set_page_config()必须是第一条Streamlit 命令Dash 界面无样式必须使用dash-bootstrap-components做布局与样式Flask/FastAPI 起不来生产部署分别用 Gunicorn / uvicorn禁用开发服务器Lakebase 应用启动崩溃psycopg2/asyncpg未预装必须加入requirements.txt资源无法访问在 UI 中为应用添加资源确认服务主体权限并在 app.yaml 使用valueFrom7️⃣ 参考资料速查技能总入口databricks-apps-python/SKILL.md授权指南databricks-apps-python/1-authorization.md资源接入databricks-apps-python/2-app-resources.md框架详解databricks-apps-python/3-frameworks.md部署指南databricks-apps-python/4-deployment.mdLakebase 数据层databricks-apps-python/5-lakebase.mdLLM API 调用示例databricks-apps-python/examples/llm_config.py一句话总结新项目直接用 AppKitTypeScript React必须用 Python 时按场景查表——原型 Streamlit、生产仪表盘 Dash、API 用 FastAPI、ML 演示用 Gradio再对照 5 项清单与避坑表即可平滑上线。【免费下载链接】ai-dev-kitDatabricks Toolkit for Coding Agents provided by Field Engineering项目地址: https://gitcode.com/GitHub_Trending/ai/ai-dev-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考