InsForge Agent 技能

凭证检测（MCP模式）

1. 优先尝试调用MCP工具：尝试调用

   get-backend-metadata

   或

   get-anon-key

2. 如果MCP调用成功：说明凭证已配置完成，可继续后续操作
3. 如果MCP调用返回认证错误：再向用户索要项目URL和API密钥

示例：用户说“部署到InsForge”
✓ 尝试：通过MCP调用get-backend-metadata
✓ 如果成功：从元数据中提取项目URL，通过get-anon-key获取匿名密钥
✗ 如果失败：向用户索要凭证

注意：先检查凭证（手动模式）

https://{project-id}.{region}.insforge.app

ik_xxxx...

你是否拥有InsForge项目？我需要以下信息：
1. 项目URL（例如：https://abc123.us-east-1.insforge.app）
2. API密钥（以ik_开头）

你可以在InsForge控制台 → 项目设置中找到这些信息。

文档使用场景说明

当需要以下操作时，使用

sdk-integration.md

文件：

• 将InsForge服务集成到用户的前端应用中
• 实现运行在浏览器或客户端应用中的功能
• 编写使用

  @insforge/sdk

  方法的代码
• 示例：用户登录流程、数据获取、文件上传、实时订阅

当需要以下操作时，使用

backend-configuration.md

文件：

• 在应用使用功能前配置InsForge后端
• 创建数据库表、存储桶或部署无服务器函数
• 设置实时通道或数据库触发器
• 管理认证设置、AI配置或部署任务
• 示例：创建

  posts

  数据表、启用OAuth提供商、部署边缘函数

典型工作流程

1. 后端配置 → 通过HTTP API配置基础设施
2. SDK集成 → 在应用代码中使用SDK

1. 首先创建存储桶 → 查看storage/backend-configuration.md
2. 然后在应用中实现上传功能 → 查看storage/sdk-integration.md

1. 首先配置认证设置 → 查看auth/backend-configuration.md
2. 然后实现登录/注册功能 → 查看auth/sdk-integration.md

第一步：获取后端元数据

GET /api/metadata
Authorization: Bearer {admin-token-or-api-key}

• 数据库：数据表、列、关系、索引、RLS策略
• 认证：配置信息、OAuth提供商、用户统计
• 存储：存储桶及可见性设置
• 函数：已部署的函数及其状态
• AI：已配置的模型
• 实时服务：通道规则

快速设置

npm install @insforge/sdk@latest

import { createClient } from '@insforge/sdk'

const insforge = createClient({
  baseUrl: 'https://your-project.region.insforge.app',
  anonKey: 'your-anon-key'
})

模块参考

各模块覆盖内容

指南

SECURITY DEFINER

SDK快速参考

{ data, error }

insforge.database

.from().select()

.insert()

.update()

.delete()

.rpc()

insforge.auth

.signUp()

.signInWithPassword()

.signInWithOAuth()

.signOut()

.getCurrentSession()

insforge.storage

.from().upload()

.uploadAuto()

.download()

.remove()

insforge.functions

.invoke()

insforge.ai

.chat.completions.create()

.images.generate()

.embeddings.create()

insforge.realtime

.connect()

.subscribe()

.publish()

.on()

.disconnect()

后端API快速参考

https://your-project.region.insforge.app

Authorization: Bearer {admin-token-or-api-key}

POST /api/database/advance/rawsql

POST /api/storage/buckets

POST /api/functions

PUT /api/auth/config

GET /api/metadata

POST /api/schedules

POST /api/deployments

GET /api/logs/{source}

部署最佳实践

务必：先在本地构建

# 1. 安装依赖
npm install

# 2. 为你的框架设置环境变量
cp .env.example .env.local  # 或创建.env.production

# 3. 执行生产构建
npm run build

.env.production

npm install

框架特定说明

• 环境变量前缀：使用对应框架的正确前缀：
  • Vite:

    VITE_*

  • Next.js:

    NEXT_PUBLIC_*

  • Create React App:

    REACT_APP_*

  • Astro:

    PUBLIC_*

• 边缘函数：如果你的项目在单独目录（通常为

  functions/

  ）中包含Deno/边缘函数，请将其从前端构建中排除，以避免模块解析错误。

部署检查清单

• 本地

  npm run build

  执行成功
• 所有生产所需的环境变量已配置
• 边缘函数目录已从前端构建中排除（如适用）
• 构建输出目录与框架预期一致

重要提示

• 数据库插入需使用数组格式：

  insert([{...}])

  而非

  insert({...})

• 存储服务：需将

  url

  和

  key

  同时保存到数据库，以便后续下载/删除操作
• 函数调用URL：

  /functions/{slug}

  （无需

  /api

  前缀）
• 使用Tailwind CSS v3.4（请勿升级到v4）
• 部署前务必本地构建：避免浪费构建资源并加快调试速度