以诸葛军师账号本人的名义搜索和调用平台上的服务能力。
认证:在诸葛军师网站「AI 接入」页面创建接入密钥,调用时带上请求头 Authorization: Bearer zk_…。密钥的权限、单笔和每月预算、每日上限都由账号本人设定,所有调用都会记录在该页面,可随时停用。
流程:searchCapabilities 找到能力 → getCapability 看需要提供的资料(inputs)和处理方式(automation)→ createRequest 发起需求 → getRequest 查看进度和交付结果(delivery)。
需要确认费用的,用 approveQuote 在预算内确认;需要付款、高风险确认或最终验收时,nextStep 会给出网址,由账号本人在网站完成。
免费、低风险、程序自动交付(automation.instant 为 true)的能力,下单后立即执行。
写操作的幂等:每个写操作带 Idempotency-Key 请求头(或 idempotency_key 字段),同一笔操作重试时保持不变,不会重复创建。
状态通知:createRequest 带 callback_url(或用 setCallback 设置),需求状态每次变化会 POST 一条 JSON 通知:
{"id": "evt_…", "type": "capability_request.status_changed", "created_at": "…", "request": {…}}。
请求头 Zhuge-Signature: t=<秒级时间戳>,v1=<HMAC-SHA256(签名密钥, "<t>.<原始请求体>") 的十六进制>,签名密钥在创建接入密钥时显示一次;Zhuge-Event-Id 可用于去重。
返回 2xx 视为送达,否则 24 小时内按递增间隔重试;需求结束(已验收、未通过、已取消、失败、服务商未接单)后停止。
能力成长(权限「深挖您的能力」):discoverAbilities 深挖能力 → getAbilityProfile 看等级和下一级条件 → createGrowthPlan / createPractice 生成成长计划、领练习,
findHiddenAbilities 发现隐性能力。分析在后台进行,返回 status=working 时稍后用对应的 get 接口读取。提交练习、确认隐性能力只在用户本人做完或明确表态后调用。
组队(权限「查找搭档和团队」):findTeammates 为目标找匿名的互补搭档 → getTeamProposal 看组合 → listMyTeams / getTeam 看团队进展,
牵头人用 publishTeamService 发布团队服务。组建团队、接受邀请、签团队约定、确认分配,只能由用户本人在网站上完成。
交办经营目标(权限「交办经营目标」):delegateBusinessGoal 把目标交给诸葛军师整理成 1 至 8 项可验收的工作,并在后台自动推进(起草方案和文案、调用站内功能、
安排真人或程序能力、缺资料时提问)→ getBusinessPlan 看进展和在等用户回答的问题 → replyToBusinessPlan 带回用户的回答 → getBusinessPlanResult 读每项材料全文;
setBusinessPlanState 暂停或继续,listMyBusinessPlans 看所有计划和待用户处理的事项(owner_todo:实际订单上待付款、报价待确认、成果待核对、服务商超时)。
用户在网站上为项目开启「付费能力自动下单」并设好额度时,自动推进只在额度内下单并确认价格(getBusinessPlan 的 paid_orders),额度不能通过接口修改;
getBusinessPlan 的 platform_results 是平台按实际记录核实的结果(用户验收通过的交付、经支付渠道核对的付款),与用户自己登记的经营效果分开。
market_research.questions 是仍需用户核实的问题,用 answerBusinessQuestion 带回用户的回答,refreshMarketResearch 重新调研;setBusinessTargets 按用户的要求设置量化指标,setWorkDueDate 修改一项工作的计划完成日期(steps[].due_on,overdue_days 为逾期天数);
listBusinessPlanUpdates 按时间读取新动态(带 cursor),summarizeBusinessPlan 生成项目总结,setBusinessPlanCallback 设置计划动态的签名通知(type: business_plan.updated,附 changes 说明变化);用户告诉你实际经营数字(订单、销售额、咨询等)时,用 reportBusinessResults 登记(写明来源),用于经营指标进度和下一轮安排;getBusinessPlan 的 results_needed 是一周以上没有新数据的指标。
模型写出的材料是待核对的初稿;付款、确认高风险事项、验收和联系外部人员由用户本人在网站完成。