快速开始

客户端

网页对话

/chat.html 即开即用，登录后支持多轮对话、知识库检索、思考链展示。

Rano Work（官方桌面客户端，推荐）

Windows 安装包：官网下载。工具链预集成（报文/备份解析、PCI 核查、MML 脚本生成开箱即用），项目制工作区，会话云端漫游，应用内自动更新。

接入方式

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk_your_api_key",
    base_url="https://rano.ictyc.com/v1"
)

response = client.chat.completions.create(
    model="rano-1.0",
    messages=[{"role": "user", "content": "5G PCI干扰怎么排查"}]
)
print(response.choices[0].message.content)

cURL

curl https://rano.ictyc.com/v1/chat/completions \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"model":"rano-1.0",
       "messages":[{"role":"user","content":"LST NRDUCELL参数说明"}]}'

MCP 客户端（Claude Code / goose / opencode 等）

新一代客户端用 Streamable HTTP 传输：

{
  "mcpServers": {
    "rano": {
      "type": "http",
      "url": "https://rano.ictyc.com/v1/mcp/http",
      "headers": { "Authorization": "Bearer sk_your_api_key" }
    }
  }
}

WorkBuddy（legacy SSE）

// 配置文件: ~/.workbuddy/mcp.json
{
  "mcpServers": {
    "rano": {
      "url": "https://rano.ictyc.com/v1/mcp/sse",
      "headers": { "Authorization": "Bearer sk_your_api_key" }
    }
  }
}

认证方式

所有 API 请求需在 Header 中携带 API Key：

Authorization: Bearer sk_your_api_key

对话接口

主对话接口（OpenAI 兼容），支持多轮会话、流式输出、思考链（reasoning_content 字段）。详见下方 OpenAI 兼容。

旧版 Agent 接口

存量兼容接口，新接入请用上方的 OpenAI 兼容接口。

OpenAI 兼容接口

完全兼容 OpenAI Chat Completions API：标准 messages 多轮格式、stream: true 流式、思考链经 reasoning_content 结构化字段下发。

curl https://rano.ictyc.com/v1/chat/completions \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"rano-1.0",
       "messages":[{"role":"user","content":"5G干扰优化"}],
       "stream": true}'

MCP 接入

双传输并存，按客户端支持情况任选：

传输	端点	适用客户端
Streamable HTTP	/v1/mcp/http	Claude Code / goose / opencode / Codex 等
legacy SSE	/v1/mcp/sse	WorkBuddy 等存量客户端

工具清单（10 个）

工具	功能
search_knowledge	检索 5G/4G 网优知识库
list_knowledge_sources	列出知识库文档概况
deep_research	深度研究：自动拆解子课题并行检索，输出综述
get_diagnosis_plan	故障诊断 SOP（接入/掉话/干扰/覆盖/切换）
get_document_template	获取文档模板骨架（撰写报告/方案前先调）
render_document	服务端渲染 .pptx（报告/案例/方案/周报）
parse_ne_backup	解析网元备份 tar.gz → model.db
parse_mml_report	解析 MML 批量任务报文 → model.db
audit_pci_neighbor	PCI/邻区/外部一致性/ZC Root 共 26 项核查
build_mml_script	按命令+参数生成 MML 脚本（支持子开关级修改）

后 4 个工具（parse/audit/build）为「客户端执行」模式：调用后返回静态脚本下载地址与用法，脚本在本机运行（零外部依赖，规则实时从服务端获取），现网数据不出本机。Rano Work 已预集成，无需下载。

错误码

状态码	说明
401	API Key 无效或缺失
429	超过配额限制（RPM 或 Token）
400	请求参数错误
500	服务内部错误