CaSee AI智能体开发指南

快速开始

三步完成第一次开放接口调用：创建 API Key、选择接口、按统一响应格式解析结果。

• 在「账户 → API Keys」创建 Key，请求头携带 X-API-Key: casee_xxx。
• 开放 API Base URL：https://origin.casee.me/api/v1/openapi；规范文件：/api/v1/openapi/spec（OpenAPI 3.1）。
• 所有响应统一为 {code, message, data, request_id}；失败时按 message 与错误码处理。
• 长耗时能力（企业检索、价值链创建）统一使用异步任务接口，避免客户端超时。

curl -H "X-API-Key: casee_xxx" \
  "https://origin.casee.me/api/v1/openapi/cvc-models"

免安装智能体

不部署服务、不写代码，把 Prompt 粘贴到支持联网检索的 AI 助手中即可生成竞争情报报告。

• 支持 WorkBuddy、千问办公、豆包、DeepSeek Harness、Ollama 等宿主。
• 按平台选择提示词模板，替换企业名称、竞争价值链与时间范围。
• 典型流程：选择分析目标 → 复制 Prompt → 粘贴执行 → 校对来源与结论。
• 需要可复用、可审计时，再升级到 API / MCP 接入。

MCP tools工具

通过 MCP 协议把 CaSee 的检索、建链与报告能力接入支持 MCP 的 AI 宿主。

• MCP 网关：https://causalai.me:8100/mcp，请求头 X-API-Key。
• 提供 28 个工具：关键词检索、语义检索、批量检索、价值链构建、报告生成与分享。
• 工具入参、出参与错误码与开放 API 保持一致。
• 写操作与长耗时任务需遵循宿主超时设置，必要时轮询任务状态。

Skills技能

把常用分析流程封装为技能配方，让 Agent 在多轮任务中稳定复用。

• 技能由「目标 + 输入 + 工具组合 + 输出格式」构成。
• 可按行业、角色或场景组合检索、建链、报告工具。
• 技能可版本化管理，便于团队共享与审计。
• 与 Prompt 规范配合使用，减少模型自由发挥导致的偏差。

场景智能体

面向具体业务问题的预置智能体，开箱即用。

• 招投标情报：标讯扫描、竞争对手中标记录与概率分析。
• 竞品监测：官网、招聘、高管言论、产品发布的多源追踪。
• 市场进入：新赛道评估、目标市场/客户匹配与风险提示。
• 客户洞察：客户需求、采购信号与流失风险。

智能体开发平台接入指南

在自建或第三方 Agent 平台中接入 CaSee 能力的通用步骤。

• 在平台中配置 OpenAPI Base URL、OpenAPI 规范文件与 API Key。
• 导入工具 schema，按平台要求填写工具描述与参数说明。
• 为长耗时接口配置异步任务与轮询策略（建议客户端超时 ≥240 秒）。
• 上线前用健康检查与只读接口验证鉴权、配额与错误处理。

Prompt 规范

让 Agent 输出可信、可溯源、可复核的竞争情报结论。

• 明确分析对象、竞争价值链、时间窗口与输出格式。
• 要求每条结论附来源链接、发布时间与 T-Score。
• T-Score 是信源可信度而非主题相关度，禁止按 T-Score 排序取结论。
• 区分事实、推断与建议；对缺失数据明确标注而不是补全。

实操示例

从建链到检索再到报告的完整调用示例。

• 创建竞争价值链：提交企业清单与目标市场，轮询 creation-jobs 获取进度。
• 检索情报：按关键词、公司、时间窗调用检索接口，保留 request_id 便于追踪。
• 生成报告：选择模板与图表，异步生成后下载 PDF/HTML 或分享链接。
• 失败处理：按 4xxxx 错误码定位鉴权、配额、参数与并发问题。

# 1) 创建价值链任务（异步）
curl -X POST -H "X-API-Key: casee_xxx" -H "Content-Type: application/json" \
  -d '{"name":"新能源汽车市场","companies":["比亚迪","特斯拉"]}' \
  "https://origin.casee.me/api/v1/openapi/cvc-models/creation-jobs"

# 2) 查询任务
curl -H "X-API-Key: casee_xxx" \
  "https://origin.casee.me/api/v1/openapi/cvc-models/creation-jobs/<job_id>"

鉴权方式

错误码