适合人群：想把探果能力集成到现有工作流（OA/ERP/自建系统）的开发者。本文记录一次实际接入过程，含踩坑细节。

---

背景

我司内部有一套旧版OA系统，日报和周报模块功能很残废——员工填完表单，要手动整理汇总发给上级，格式乱、漏填多。

目标：让探果AI自动接收日报数据，生成结构化汇总，通过Webhook推送到企业微信群，不改OA系统本身。

---

探果API接入思路

探果本地服务启动后，暴露了本地REST端点，默认：

http://localhost:11434/api/tengo

调用格式（POST）：

json

复制

{
  "skill": "report_summary",
  "input": "员工日报原文内容",
  "options": {
    "output_format": "structured",
    "language": "zh-CN"
  }
}

skill 字段指定调用哪个预置Skill，input 传入原始文本，options 控制输出格式。

---

实际集成代码（Python）

python

复制

---

踩坑：timeout设置太短直接超时

第一版我把timeout=10，跑长文本日报时频繁超时报错。探果本地模型推理时间取决于文本长度和机器性能，10秒不够。

改成timeout=60后稳定了。如果是批量处理，建议用异步队列（Celery / Redis Queue），不要同步等待。

---

自定义Skill配置

内置的report_summary不满足需求时，可以自己写.skill.json放进探果的skills/目录：

json

复制

{
  "name": "oa_report_summary",
  "description": "OA日报结构化汇总",
  "prompt_template": "你是一位专业的汇报助理。请将以下员工日报整理为：【今日完成】【明日计划】【风险提示】三个部分，每部分不超过3条，语言简洁。\n\n日报内容：{input}",
  "output_schema": {
    "completed": "string[]",
    "plan": "string[]",
    "risks": "string[]"
  }
}

重启探果服务后，skill字段传oa_report_summary即可调用。

---

效果

接入后，日报汇总从人工30分钟→自动5分钟，格式统一，上级满意度明显提升。

整个集成开发量：约200行Python代码，一天完成。探果本地运行、数据不出内网，合规没有问题。

有类似集成需求的，探果API文档在www.tengox.com，本地服务端口和调用格式文档都在。