超级大脑 Open API

curl -X POST https://open.chaojidanao.com/openapi/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"app_key":"ak_xxx","app_secret":"sk_xxx"}'

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 7200,
  "refresh_token": "9f2c1d...",
  "refresh_expires_in": 604800
}

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 7200,
  "refresh_expires_in": 512000
}

curl -X POST https://open.chaojidanao.com/openapi/v1/retrieve \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"离职交接的要求","top_k":2}'

{
  "query": "离职交接的要求",
  "top_k": 2,
  "results": [
    {
      "title": "离职管理机制.docx",
      "content": "第三章 离职交接内容与标准……",
      "source": "eef43b86b56b11f181314791045de899",
      "doc_id": "8c1f0a52-...",
      "url": "https://open.chaojidanao.com/openapi/v1/documents/8c1f0a52-.../download",
      "score": 0.6212
    }
  ],
  "latency_ms": 412
}

// 请求
{"items": [{"query": "报销流程", "top_k": 3}, {"query": "出差标准"}]}

// 响应
{
  "results": [
    {"ok": true, "query": "报销流程", "top_k": 3, "results": [ ... ], "latency_ms": 260},
    {"ok": false, "query": "出差标准", "top_k": 5,
     "error": {"status": 504, "detail": "知识引擎响应超时"}}
  ]
}

curl -X POST https://open.chaojidanao.com/openapi/v1/ask \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"离职交接有哪些核心要求？","top_k":3}'

{
  "answer": "根据所给资料，离职交接的核心要求包括……",
  "sources": [
    {"title": "离职管理机制.docx", "content": "第三章 离职交接内容与标准……",
     "source": "eef43b86b56b11f181314791045de899", "score": 0.62}
  ],
  "model_used": "ragflow/direct",
  "engine_latency_ms": 3820,
  "usage": null
}

import json
import requests

resp = requests.post(
    "https://open.chaojidanao.com/openapi/v1/ask",
    headers={"Authorization": "Bearer " + token},
    json={"query": "如何部署私有化版本？", "stream": True},
    stream=True,
    timeout=90,
)
for line in resp.iter_lines(decode_unicode=True):
    if not line or not line.startswith("data:"): 
        continue
    frame = json.loads(line[5:].strip())
    if frame.get("token"):
        print(frame["token"], end="", flush=True)
    elif frame.get("done"):
        break

curl -X POST https://open.chaojidanao.com/openapi/v1/documents \
  -H "Authorization: Bearer $TOKEN" \
  -F "kb_id=8f3c1a90-..." \
  -F "file=@员工手册.pdf"

{"task_id": "3b7e...", "status": "pending", "doc_id": null}

{"status": "ok"}

pip install -e openplatform-sdk/

from openplatform_sdk import Client

# 读取 OPENAPI_BASE_URL / OPENAPI_APP_KEY / OPENAPI_APP_SECRET
client = Client.from_env()

# 知识检索
hits = client.retrieve("离职交接的要求", top_k=3)
for item in hits["results"]:
    print(item["title"], item["score"])

# 同步问答
answer = client.ask("离职交接有哪些核心要求？")
print(answer["answer"])

# 流式问答（逐 token）
for frame in client.ask_stream("那转正后呢？", conversation_id="chat-42"):
    print(frame)