快速开始

目标:从注册到完成第一次对话调用,约 5 分钟。

1. 注册开通(免费版)

打开 console → 「注册企业」→ 填企业名称、管理员邮箱、密码(≥10 位)。 注册即开通免费版:3 设备 / 1 渠道 / 2 智能体 / 1 知识库 / 10 万 tokens·月。 注册响应即含登录令牌,直接进入控制台。

# 也可以直接调 API 注册(幂等:重复邮箱返回 409)
curl -s -X POST https://openagent-os.com/api/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"company":"我的公司","email":"me@corp.com","password":"••••••••••"}'
# → {"tenant_id":"…","token":"…","plan":"free","roles":["team_admin"]}

2. 创建智能体(提示词 + 知识库 + 模型渠道)

控制台 语料库:建库 → 上传文档并发布;LLM 渠道:选厂商预设 → 填 API Key → 创建 → 「模型列表」下拉选模型;智能体:写系统提示词、勾选语料库、绑定渠道。

不绑定渠道也完全可以——对话会走平台默认渠道;绑定自有渠道后走你自己的模型 Key。

3. 签发开放 API 密钥

控制台 API 密钥 → 创建密钥 → key_secret 仅显示一次,立即保存。 密钥可随时吊销(吊销后使用它的外部系统立即 401)。

4. 第一次对话调用

export OA_KEY=oas_xxx   # 控制台签发的 key_secret

# 模型清单(OpenAI 兼容)
curl -s https://openagent-os.com/open/v1/models -H "X-API-Key: $OA_KEY"

# 对话(自动应用:租户智能体提示词 + 知识库检索引用 + 安全脱敏)
curl -s https://openagent-os.com/open/v1/chat \
  -H "X-API-Key: $OA_KEY" -H "Content-Type: application/json" \
  -d '{"message": "织唛和印唛有什么区别?"}'
# → {"answer":"…","citations":[{"citation":"[1]","doc":"faq.md","page":1}],"tenant_id":"…"}

5. Python

import os, requests

BASE = "https://openagent-os.com"
key = os.environ["OA_KEY"]

r = requests.post(f"{BASE}/open/v1/chat",
                  headers={"X-API-Key": key},
                  json={"message": "你们的支持渠道有哪些?"}, timeout=60)
r.raise_for_status()
print(r.json()["answer"])

下一步