快速开始

三步接入 Rano API：

接入方式

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参数说明"}]}'

WorkBuddy

WorkBuddy 需要配置 OpenAI 兼容接口 和 MCP 服务 两部分：

第一步：配置 OpenAI 兼容接口（用于对话）

在 WorkBuddy 设置 → 模型配置中添加 OpenAI 兼容接口：

接口地址: https://rano.ictyc.com/v1
API Key:  sk_your_api_key
模型名称: rano-1.0

第二步：配置 MCP 服务（用于知识库检索工具）

在 WorkBuddy → MCP 服务管理中添加以下配置：

// MCP 配置文件路径: ~/.workbuddy/mcp.json
{
  "mcpServers": {
    "rano": {
      "url": "https://rano.ictyc.com/v1/mcp/sse",
      "disabled": false
    }
  }
}

配置完成后，WorkBuddy 即可通过 Rano 进行对话，并自动调用 search_knowledge、ask_rano 等工具检索 5G 网优知识库。

Claude Code (MCP)

// Claude Code MCP 配置
{
  "mcpServers": {
    "rano": {
      "url": "https://rano.ictyc.com/v1/mcp/sse"
    }
  }
}

认证方式

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

Authorization: Bearer sk_your_api_key

对话接口

Agent 对话接口，支持多轮会话和知识库检索。

{
  "query": "PCI MOD3干扰怎么排查",
  "session_id": "my-session"
}

流式输出

返回 SSE 格式的流式响应。

OpenAI 兼容接口

完全兼容 OpenAI Chat Completions API，支持流式输出（stream: true）。使用标准 messages 格式，支持多轮对话。

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 接入

支持通过 MCP SSE 协议接入 Claude Code、WorkBuddy 等 AI 工具。Rano 内置 3 个 MCP 工具：

• search_knowledge — 搜索 5G 网优知识库
• list_knowledge_sources — 列出知识库文档来源
• ask_rano — 向 Rano 专家 LLM 提问

错误码

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