文档
邀请好友,多拿一次周额度重置。好友注册并使用即得 1 次重置(30 天内有效)· 其消费再拿最高 10% 现金返现。
+1 次重置生成链接

HTTP、凭证与身份

分别配置Agent、Host、Admin和Evaluator,避免把模型工具权限当作管理权限。

服务监听

rsia serve 默认监听 127.0.0.1:7788,namespace默认default,Agent actor默认http-agent。对外提供服务前必须完成部署侧的HTTPS与访问控制;不要为方便联调直接把带权限的服务公开。

启动环境

环境变量服务端身份
RSIA_HTTP_TOKENAgent工具调用
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凭证及角色,不能通过关闭鉴权让演示通过。