HTTP、凭证与身份
分别配置Agent、Host、Admin和Evaluator,避免把模型工具权限当作管理权限。
服务监听
rsia serve 默认监听 127.0.0.1:7788,namespace默认default,Agent actor默认http-agent。对外提供服务前必须完成部署侧的HTTPS与访问控制;不要为方便联调直接把带权限的服务公开。
启动环境
| 环境变量 | 服务端身份 |
|---|---|
RSIA_HTTP_TOKEN | Agent工具调用 |
RSIA_HOST_TOKEN | 受信宿主接线 |
RSIA_ADMIN_TOKEN | 管理员 |
RSIA_EVALUATOR_TOKEN | 独立评估者 |
凭证由部署者安全生成并注入环境,不写进示例、URL、版本库或日志。管理CLI的 RSIA_MANAGEMENT_TOKEN 是客户端用于访问服务的凭证,不会自动替你在服务端创建身份。
身份由可信启动配置绑定。请求中的x-role、x-namespace或x-actor不能用于自选权限;同一身份只能访问其允许范围。
接口分工
- 模型工具:
/v1/tools/prepare、feedback、propose、inspect。 - 宿主事实与回执:
/v1/host/trace、snapshot、application。 - 管理:
/v1/manage/{operation}、作业状态和取消。
HTTP载荷应按当前协议类型构造,不把自然语言或私有规范正文直接当JSON。远程MCP和HTTP接通后,也需要核对工具schema与角色范围。
常见状态
缺少服务鉴权配置可能返回503;错误或越权身份与请求格式问题分别处理。先检查启动凭证和实际监听,再检查请求的Bearer凭证及角色,不能通过关闭鉴权让演示通过。