40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
# huni-probe-agent
|
||
|
||
信创模盒 ModelHub XC 适配智能体 · **只读探针骨架 (probe-only)**。
|
||
|
||
对照官方样例 `luopingyi/xc_agent_platform_demo`（最小合规骨架）扩了一个零副作用探针。
|
||
|
||
## 用途
|
||
|
||
1. 验证平台「建仓 → Kaniko 构建 → 部署 → `/health` → 运行/停止」整条链路是否通。
|
||
2. 零副作用观测平台注入的 `STRATEGY_ID` / `EXTERNAL_SERVICE_TOKEN` 是否为有效凭证：
|
||
启动时用注入 token 调一次**只读** `GET /api/adapt/task/page`，看返回 `code`：
|
||
`0` = 凭证有效；`40100` = 未登录/凭证无效。
|
||
|
||
## 满足的运行时契约
|
||
|
||
- 根目录 `Dockerfile`，`EXPOSE 8080`
|
||
- `GET /health` 返回 HTTP 200（K8s livenessProbe）
|
||
- 读取 `STRATEGY_ID` 与 `EXTERNAL_SERVICE_TOKEN` 环境变量
|
||
- 处理 `SIGTERM`，优雅停机（30s 窗口内退出）
|
||
- 资源占用极小，符合 requests 100m/256Mi、limits 1C/512Mi
|
||
|
||
## 明确不做
|
||
|
||
- **绝不提交任何验证任务**（不调 `task/add`，不调 `build-config`）。
|
||
- 不打印 token 值、不落盘任何凭证；探针仅调只读 GET，仅记录 `http/code/计数`。
|
||
|
||
## 本地运行
|
||
|
||
```bash
|
||
python main.py
|
||
curl http://localhost:8080/health # {"status":"ok"}
|
||
curl http://localhost:8080/ # 查看探针结果
|
||
```
|
||
|
||
## 上平台
|
||
|
||
推到 `https://dev.modelhub.org.cn/<user>/<repo>` 并保留一个**真 git 标签**（如 `v1.0.0`；
|
||
平台 Kaniko 按 `refs/tags/<tag>` 解析，用分支名会失败）。再在「我的适配智能体 → 新增智能体」
|
||
填 名称 / 仓库地址 / 标签 提交。
|