Flowise Skill

通过 REST API 与 Flowise AI 平台交互。

配置

将 Flowise 配置信息保存在 TOOLS.md 文件中：

### Flowise
- Server: http://localhost:3000
- API Key: your-api-key-here
- Default Flow ID: your-default-flow-id（可选）
- Default Timeout: 300

#### Flows
| Flow ID | 名称 | 用途 | 参数 |
|---------|------|------|------|
| abc123 | 客服助手 | 处理客户咨询、售后问题 | - |
| def456 | 代码助手 | 代码生成、调试、技术问答 |  form格式: `script`=要执行的脚本, `device`=设备(可选) |
| ghi789 | 文档助手 | 文档总结、RAG知识库查询 | - |

Flow 选择

调用 Flowise 时，需根据用户请求匹配最合适的 Flow：

1. 查阅 TOOLS.md 中的 Flows 表格
2. 选择“用途”最符合当前任务的 Flow
3. 若无明确匹配项，则使用 Default Flow ID
4. 若用户显式指定了 Flow 名称，则优先使用该 Flow

快速参考

发送消息（Prediction）

curl -X POST "${FLOWISE_URL}/api/v1/prediction/${FLOW_ID}" 
  -H "Authorization: Bearer ${API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{"question": "Hello, how are you?"}'

启用流式响应（Streaming）

curl -X POST "${FLOWISE_URL}/api/v1/prediction/${FLOW_ID}" 
  -H "Authorization: Bearer ${API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{"question": "Tell me a story", "streaming": true}'

携带会话/对话上下文（Session Memory）

curl -X POST "${FLOWISE_URL}/api/v1/prediction/${FLOW_ID}" 
  -H "Authorization: Bearer ${API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{"question": "What did I ask before?", "sessionId": "user-123"}'

列出所有 Chatflows

curl -X GET "${FLOWISE_URL}/api/v1/chatflows" 
  -H "Authorization: Bearer ${API_KEY}"

获取指定 Chatflow 的详细信息

curl -X GET "${FLOWISE_URL}/api/v1/chatflows/${FLOW_ID}" 
  -H "Authorization: Bearer ${API_KEY}"

Prediction 常用参数

Flow 特定变量

部分 Flow 支持自定义变量。请在请求体中传递这些变量：

{
  "question": "查询订单状态",
  "overrideConfig": {
    "vars": {
      "orderId": "12345",
      "userId": "user-abc"
    }
  }
}

从 TOOLS.md 中读取参数

请查阅 TOOLS.md 中 Flow 对应的“参数”列，其中包含以下信息：

• 必填参数（标有“必填”）
• 建议使用的默认值
• 该 Flow 所需的自定义变量

示例条目：

| abc123 | RAG知识库 | 文档查询 | sessionId=必填, variables={"namespace": "docs"} |

调用该 Flow 时，请确保传入所要求的全部参数。

覆盖配置示例

覆盖模型设置或其他 Flow 参数：

{
  "question": "Explain quantum computing",
  "overrideConfig": {
    "temperature": 0.7,
    "maxTokens": 500
  }
}

带文件上传的请求

curl -X POST "${FLOWISE_URL}/api/v1/prediction/${FLOW_ID}" 
  -H "Authorization: Bearer ${API_KEY}" 
  -F "question=Analyze this document" 
  -F "files=@/path/to/document.pdf"

Form 对象请求

部分 Flow 使用 form 对象接收结构化输入参数：

curl -X POST "${FLOWISE_URL}/api/v1/prediction/${FLOW_ID}" 
  -H "Authorization: Bearer ${API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "form": {
      "script": "d.send_keys("小红书")",
      "device": "192.168.1.100:5555"
    }
  }'

请查阅 TOOLS.md 中“参数”列的 form格式 说明以识别此类 Flow，并将参数置于 form 对象内传递。

错误处理

工作流程

1. 从 TOOLS.md 获取 Flowise 服务地址（URL）和 API Key
2. 若尚未配置，请向用户询问以下信息：
   • Flowise 服务地址（例如：http://localhost:3000）
   • API Key（若启用了身份验证）
   • 拟使用的 Flow ID
3. 使用 exec 调用 curl 命令访问 Flowise API
4. 解析返回的 JSON 响应，并将结果呈现给用户

提示

• 始终使用一致的 sessionId 来维持对话上下文
• 对于较长的响应内容，建议启用 streaming: true
• 首次调用前，建议先测试连通性：/api/v1/ping
• 若用户未指定 Flow ID，可主动调用接口列出可用的 Flow