运行时依赖
安装命令
点击复制技能文档
name: k1_kzcloud_skill description: 科众云CXO地图位置查询,按位置搜索cxo license: MIT version: 1.1.0 metadata: openclaw: requires: bins: ["node","python3"] env: K1_KZClOUD_TOKEN
K1科众云CXO地图位置查询技能,按位置搜索cxo
必须条件
- 首次使用须先登录获取token并写入环境变量K1_KZClOUD_TOKEN
- 接口返回401表示登录失效,应提示用户重新输入账号密码登录
- 用户登录成功后立即遗忘账密,仅将token写入环境变量,防止泄露
- 【重要】同一时间环境变量K1_KZClOUD_TOKEN仅保留一个账号的token。切换账号须先覆盖旧token,禁止并存多token
- 【强制】Agent必须100%按本SKILL.md内所有API命令的参数与格式执行,不得擅自修改、省略或推断。不确定时须查本文件或询问用户,命令原样照抄
TOKEN使用 请求头添加:Authorization: Bearer {环境变量K1_KZClOUD_TOKEN的值}
获取账套列表(登录前必须) 必须带userName参数,否则返回空。查询后向用户展示账套列表并询问选择 baseUrl见同目录config.json curl "{baseUrl}/api/v1/SysUser/GetUserTenants?userName={userName}" 返回json中result.data[]为账套列表,每项含id(tenantId)与name。用户选择后取其id作为登录参数tenant_id
登录 必要参数:账号、密码、tenant_id 登录前须先调用「获取账套列表」接口,让用户选择账套并取其id作为tenant_id;未指定则默认使用kzcloud账套对应tenantId python scripts/login.py --account {用户账号} --password {用户密码} --tenant_id {账套id} 登录成功后login.py自动将token写入环境变量K1_KZClOUD_TOKEN
查看职能、职级、职位阵营 用户询问时展示 curl {baseUrl}/api/v1/KzcCloudSearch/GetDropdownList \ -H "Content-Type: application/json" \ -H "Authorization: Bearer {环境变量K1_KZClOUD_TOKEN的值}" 返回: 职能=result.data.function[] 职级=result.data.grade[] 职位阵营=result.data.positionCamp[]
按位置查询cxo(距离范围) 规则
- 经纬度须通过高德skill: amap-lbs-skill的LBS综合服务获取;若未安装则提示:
- 向用户展示筛选条件:职能=[] 范围=[小于5km]
请求参数 data.functions[]=职能 data.grade[]=职级 data.positionCamp[]=职位阵营 data.lon=经度 data.lat=纬度 data.range[]=范围,默认1(1<5km、2=5-10km、3=10-30km、4=30-100km) data.keyword=关键字,cxo中文或英文名,默认空 data.topNum=显示数量,默认200
curl -X POST {baseUrl}/api/v1/BusinessCardMap/GetBusinessListByPage \ -H "Content-Type: application/json" \ -H "Authorization: Bearer {环境变量K1_KZClOUD_TOKEN的值}" \ -d '{ "functions": ["SSC"], "grade": ["C level"], "positionCamp": ["CEO"], "lon": "116.401636", "lat": "39.908294", "center": "", "range": [1], "keyword": "", "topNum": 200 }'
结果列表格式 序号 中文名 英文名 职能 职级 职位阵营 地址 邮箱 离中心点距离 id businessCardName businessCardEnName functions grade positionCamp address mailbox distance