Agent 开发文档

jisuapi Agent 服务基于 MCP (Model Context Protocol) 协议，为 AI Agent 提供统一的数据接口访问能力。

核心特性

• MCP 协议支持 - 原生支持 Cursor、Claude Desktop 等 MCP 客户端
• HTTP 网关 - 提供标准 HTTP API，支持任意编程语言
• 智能搜索 - 自然语言搜索，自动匹配最合适的工具
• 统一计费 - 复用现有 APPKEY，按原接口价格计费
• 完整生态 - 支持 500+ jisuapi 接口

工作原理

Agent 服务作为中间层，连接 AI 应用和 jisuapi 数据接口：

1. 搜索 - AI 用自然语言描述需求
2. 匹配 - Agent 自动匹配最合适的工具
3. 执行 - 调用对应的 jisuapi 接口
4. 返回 - 将结果返回给 AI 应用

快速开始

1. 获取 APPKEY

前往 会员中心 获取你的 APPKEY。如果还没有账号，请先 注册。

2. 选择接入方式

根据你的使用场景选择合适的接入方式：

接入方式	适用场景	难度	文档
MCP 客户端	Cursor、Claude Desktop	简单	查看文档
HTTP 网关	自研 Agent、任意编程语言	中等	查看文档

3. 开始使用

• 快速开始指南 - 详细的接入步骤
• 使用示例 - Python、Node.js 代码示例

API 参考

核心接口

接口	说明	计费	文档
search	搜索可用工具	按 Token	查看文档
execute	执行指定工具	按工具计费	查看文档
stats	查询执行统计	免费	查看文档
stats_detail	详细统计记录	免费	查看文档
stats_dashboard	数据面板	免费	查看文档

使用指南

入门教程

• 快速开始 - 5 分钟快速接入
• MCP 客户端接入 - Cursor、Claude Desktop 配置
• HTTP 网关 API - HTTP 接口完整文档

开发参考

• 使用示例 - Python、Node.js、Go 代码示例
• 错误码参考 - 完整错误码列表和解决方案
• 常见问题 - FAQ 和故障排查

其他资源

• 可用接口列表 - 查看所有支持的接口
• 会员中心 - 管理 APPKEY 和查看余额

使用场景

AI 编程助手

在 Cursor 中直接使用自然语言调用 jisuapi 接口：

// 在 Cursor 中输入
帮我查询手机号 13800138000 的归属地

AI 会自动调用 jisuapi 的手机号查询接口并返回结果。

智能对话

在 Claude Desktop 中实现增强对话：

// 在 Claude Desktop 中输入
查询北京的天气，然后告诉我明天适合出门吗？

Claude 会调用天气接口获取数据，然后基于数据给出建议。

自定义 Agent

通过 HTTP API 构建自己的 AI 应用：

// Python 代码
agent = JisuAPIAgent("your_appkey")
result = agent.search_and_execute(
    "查询手机号归属地",
    {"mobile": "13800138000"}
)

计费说明

计费原则

• 免费接口 - 保持免费，不消耗次数
• 付费接口 - 按原接口价格计费
• search 接口 - 按 Token 计费，根据查询和返回内容收费

计费顺序

系统按以下顺序扣费：

1. 免费额度（每日免费次数）
2. 套餐包（已购买的套餐次数）
3. Credits（按量付费余额）

查看消费

登录 会员中心，在"我的 API"中查看详细的调用记录和余额。

获取支持

文档资源

• 快速开始
• 常见问题
• 错误码参考

联系我们

• 客服微信 - 添加客服微信获取支持
• 邮件 - kf@jisuapi.com
• 在线客服 - 访问 会员中心