常见问题
Agent 服务常见问题解答和故障排查指南。
计费相关
Q: 需要额外付费吗?
A: 不需要。Agent 服务复用现有的 APPKEY 和套餐余额,按照接口原有计费规则扣费。免费接口保持免费。
Q: 如何查看消费记录?
A: 登录 会员中心,在"我的 API"中可以查看所有接口的调用记录和余额。
Q: search 接口收费吗?
A: search 接口按 Token 计费,根据查询内容和返回结果的 Token 数量计费,单次调用费用很低。具体价格请查看会员中心。
Q: execute 接口如何计费?
A: execute 接口按照调用的具体工具计费:
- 免费工具:不扣费
- 付费工具:按原接口价格扣费
- 计费顺序:免费额度 → 套餐包 → Credits
接口相关
Q: 支持哪些接口?
A: 目前支持绝大部分 jisuapi 接口。可在 Agent 可用接口 页面查看完整列表。
Q: 如何知道某个功能是否支持?
A: 使用 search 接口搜索相关功能,如果返回结果则表示支持。
Q: 为什么搜索不到我想要的功能?
A: 可能的原因:
- 该功能暂不支持 Agent 调用
- 搜索关键词不够准确,尝试更换关键词
- 使用专业术语而非口语化描述
MCP 配置相关
Q: MCP 配置后不生效?
A: 请检查:
- 配置文件路径是否正确
- JSON 格式是否正确(注意逗号、引号)
- APPKEY 是否正确且未过期
- 是否重启了 Cursor 或 Claude Desktop
Q: Cursor 在哪里查看 MCP 配置?
A: 配置文件位置:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%APPDATA%\.cursor\mcp.json
Q: Claude Desktop 配置文件在哪?
A: 配置文件位置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Q: 找不到配置文件怎么办?
A: 如果配置文件不存在,需要手动创建:
- 创建对应目录(如果不存在)
- 创建 JSON 文件
- 添加配置内容
- 重启客户端
Q: npx 命令找不到?
A: 请确保已安装 Node.js:
- 访问 nodejs.org 下载安装
- 建议安装 v16 或更高版本
- 安装后重启终端或 IDE
- 运行
node -v 和 npx -v 验证
HTTP API 相关
Q: HTTP 网关返回 401 错误?
A: 请检查 Authorization Header 格式是否正确:
Authorization: Bearer 你的APPKEY
注意:
- Bearer 后面有一个空格
- APPKEY 前后不要有额外空格
- 确保使用正确的 APPKEY
Q: 请求超时怎么办?
A: 建议设置合理的超时时间:
- search 接口:10-15 秒
- execute 接口:20-30 秒
- 如果经常超时,检查网络连接
Q: 如何处理频率限制?
A: 实现以下策略:
- 添加请求队列
- 实现指数退避重试
- 使用连接池复用连接
- 联系客服提高频率限制
使用相关
Q: AI 说找不到工具?
A: 可能的原因:
- 查询的功能暂不支持
- MCP 服务未正确启动,重启客户端
- 网络连接问题
- APPKEY 配置错误
Q: 工具执行失败怎么办?
A: 检查步骤:
- 查看错误信息中的 status 和 msg
- 参考 错误码文档
- 检查参数是否正确
- 记录 request_id 联系客服
Q: 如何查看调用记录?
A: 两种方式:
Q: 可以在前端直接调用吗?
A: 不建议。原因:
- 会暴露 APPKEY,存在安全风险
- 可能被恶意调用,消耗余额
- 建议通过后端代理请求
故障排查
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: 检查:
- 是否可以访问 api.jisuapi.com
- 防火墙是否阻止了连接
- 是否需要配置代理
- DNS 解析是否正常
Q: 如何提高请求速度?
A: 优化建议:
- 使用连接池复用 HTTP 连接
- 启用 HTTP/2
- 使用 CDN 加速(如有)
- 缓存搜索结果
Q: 可以并发请求吗?
A: 可以,但需要注意:
- 遵守频率限制
- 控制并发数量
- 实现请求队列
- 处理好错误重试
安全相关
Q: APPKEY 泄露了怎么办?
A: 立即处理:
- 登录 会员中心
- 停用或删除泄露的 APPKEY
- 创建新的 APPKEY
- 更新所有使用该 APPKEY 的配置
Q: 如何保护 APPKEY 安全?
A: 安全建议:
- 不要在前端代码中硬编码 APPKEY
- 使用环境变量存储 APPKEY
- 不要将 APPKEY 提交到代码仓库
- 定期轮换 APPKEY
- 在会员中心设置 IP 白名单
其他问题
Q: 支持哪些编程语言?
A: HTTP API 支持任意语言,包括:
- Python, Node.js, Java, Go
- PHP, Ruby, C#, Swift
- 以及任何支持 HTTP 请求的语言
Q: 有 SDK 吗?
A: 官方 SDK 正在开发中。目前可以:
- 参考 使用示例 中的代码
- 使用标准 HTTP 客户端库
- 等待官方 SDK 发布
Q: 支持 Webhook 吗?
A: 目前暂不支持 Webhook,所有调用都是同步的。
Q: 有使用限制吗?
A: 基本限制:
- 每秒 10 次请求
- 每分钟 100 次请求
- 单次请求超时 30 秒
- 可联系客服提高限制
如果以上答案未能解决你的问题,请通过以下方式联系我们:
- 客服微信:添加客服微信获取支持
- 邮件:kf@jisuapi.com
- 在线客服:访问 会员中心
提示:联系客服时,请提供 request_id 或详细的错误信息,以便我们更快定位问题。
更多资源