Zapier

将 Zapier 接入 Felo 模型 API 和 Data API：模型 API 用于生成内容，独立的 HTTP 工具用于查询外部数据。

开始前准备

先创建 API key 并确认账户有可用额度。本文以 Tavily 搜索接口为例；其他 Data API 的参数和价格以各自文档为准。

• API Keys
• Data APIs
• Tavily

在应用中配置

打开 Zap → Webhooks by Zapier → Custom Request → POST → Test，按下表填写并保存，再执行一次测试请求。不同版本的界面名称可能略有变化。

把查询变成 Agent 工具

Trigger → HTTP request → JSON results[] → next action / agent context

导入下方 OpenAPI 文件，或按表格创建 JSON 格式的 HTTP POST 请求。API key 保存在应用的凭据设置中；将 query 作为任务输入，把 results 传给后续步骤。

OpenAPI JSON

Data API 请求示例

{
  "query": "Felo API Platform documentation",
  "max_results": 3
}

export FELO_API_KEY='YOUR_FELO_API_KEY'
curl 'https://openapi.felo.ai/v1/beta/tavily/search' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "query": "Felo API Platform documentation",
  "max_results": 3
}'

接入模型 API

从模型目录复制 Model ID，填写下方兼容 OpenAI 的 Base URL。Data API 地址应单独配置在 HTTP 工具中。

打开 Zap → Webhooks by Zapier → Custom Request → POST → /api/v1/chat/completions，按下表填写并保存，再执行一次测试请求。不同版本的界面名称可能略有变化。

Model ID · Protocols

{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

curl 'https://openapi.felo.ai/api/v1/chat/completions' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'

验证是否接入成功

执行一次搜索，检查响应是否有 results 数组，以及 title、url、content 字段。让 Agent 基于这些结果总结并引用返回的网址。空数组也是合法结果，不代表调用失败；再到控制台查看本次 API 用量，确认请求经过 Felo。

遇到问题怎么办

401：检查 key 和 Authorization；402：检查余额；400：检查 JSON 和 query；429 或 5xx：退避重试。保留 request_id 方便客服核查。Workspace 方式还需检查脚本授权和文档权限；电脑工具需确认 key 配置在实际执行环境。

继续阅读 Felo 文档

• Data API
• API Reference
• Authentication
• Apps & Agents

应用官方资料

• Zapier