快速入门

API 参考

其他资源

首页 / Agent / 文档 / 常见问题

常见问题

Agent 服务常见问题解答和故障排查指南。

计费相关

Q: 需要额外付费吗?

A: 不需要。Agent 服务复用现有的 APPKEY 和套餐余额,按照接口原有计费规则扣费。免费接口保持免费。

Q: 如何查看消费记录?

A: 登录 会员中心,在"我的 API"中可以查看所有接口的调用记录和余额。

Q: search 接口收费吗?

A: search 接口按 Token 计费,根据查询内容和返回结果的 Token 数量计费,单次调用费用很低。具体价格请查看会员中心。

Q: execute 接口如何计费?

A: execute 接口按照调用的具体工具计费:

接口相关

Q: 支持哪些接口?

A: 目前支持绝大部分 jisuapi 接口。可在 Agent 可用接口 页面查看完整列表。

Q: 如何知道某个功能是否支持?

A: 使用 search 接口搜索相关功能,如果返回结果则表示支持。

Q: 为什么搜索不到我想要的功能?

A: 可能的原因:

MCP 配置相关

Q: MCP 配置后不生效?

A: 请检查:

Q: Cursor 在哪里查看 MCP 配置?

A: 配置文件位置:

Q: Claude Desktop 配置文件在哪?

A: 配置文件位置:

Q: 找不到配置文件怎么办?

A: 如果配置文件不存在,需要手动创建:

  1. 创建对应目录(如果不存在)
  2. 创建 JSON 文件
  3. 添加配置内容
  4. 重启客户端

Q: npx 命令找不到?

A: 请确保已安装 Node.js:

  1. 访问 nodejs.org 下载安装
  2. 建议安装 v16 或更高版本
  3. 安装后重启终端或 IDE
  4. 运行 node -vnpx -v 验证

HTTP API 相关

Q: HTTP 网关返回 401 错误?

A: 请检查 Authorization Header 格式是否正确:

Authorization: Bearer 你的APPKEY

注意:

Q: 请求超时怎么办?

A: 建议设置合理的超时时间:

Q: 如何处理频率限制?

A: 实现以下策略:

使用相关

Q: AI 说找不到工具?

A: 可能的原因:

Q: 工具执行失败怎么办?

A: 检查步骤:

  1. 查看错误信息中的 status 和 msg
  2. 参考 错误码文档
  3. 检查参数是否正确
  4. 记录 request_id 联系客服

Q: 如何查看调用记录?

A: 两种方式:

Q: 可以在前端直接调用吗?

A: 不建议。原因:

故障排查

Q: 如何调试 MCP 连接问题?

A: 启用调试日志:

{
  "mcpServers": {
    "jisuapi": {
      "command": "npx",
      "args": ["-y", "@jisuapi/mcp"],
      "env": {
        "JISUAPI_KEY": "你的APPKEY",
        "DEBUG": "true"
      }
    }
  }
}

然后查看客户端的日志输出。

Q: 如何确认 APPKEY 是否有效?

A: 使用 curl 测试:

curl -X POST "https://api.jisuapi.com/agent/search" \
  -H "Authorization: Bearer 你的APPKEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"测试","limit":1}'

如果返回 status: 0,说明 APPKEY 有效。

Q: 网络连接失败怎么办?

A: 检查:

性能优化

Q: 如何提高请求速度?

A: 优化建议:

Q: 可以并发请求吗?

A: 可以,但需要注意:

安全相关

Q: APPKEY 泄露了怎么办?

A: 立即处理:

  1. 登录 会员中心
  2. 停用或删除泄露的 APPKEY
  3. 创建新的 APPKEY
  4. 更新所有使用该 APPKEY 的配置

Q: 如何保护 APPKEY 安全?

A: 安全建议:

其他问题

Q: 支持哪些编程语言?

A: HTTP API 支持任意语言,包括:

Q: 有 SDK 吗?

A: 官方 SDK 正在开发中。目前可以:

Q: 支持 Webhook 吗?

A: 目前暂不支持 Webhook,所有调用都是同步的。

Q: 有使用限制吗?

A: 基本限制:

联系我们

如果以上答案未能解决你的问题,请通过以下方式联系我们:

提示:联系客服时,请提供 request_id 或详细的错误信息,以便我们更快定位问题。

更多资源