开发功能
后端服务
开发后端服务,为网站、智能体、模块和定时任务提供稳定 API。
后端服务用于处理业务数据、外部系统调用和复杂规则。网站、智能体、技能、模块方法和定时任务都可以调用后端服务。
需要由平台构建、保存不可变制品并部署到多个环境的 Rust 后端,请使用 构建并部署 Hosted Service。该流程把 BuildJob、Artifact 和环境部署明确分开。
需要从项目源码开始完成构建、制品管理、环境配置、部署和鉴权时,请查看 后端应用开发。
创建服务
创建后端服务时确认:
- 哪些接口给前端调用。
- 哪些接口给智能体或技能调用。
- 哪些接口负责调用外部系统。
- 数据库、密钥和 token 保存在哪个工作区配置里。
接入运行时
后端作为 Application Runtime 的模块能力提供时,按以下顺序接入:
- 独立发布、部署后端项目,验证目标 Environment 的 Endpoint、鉴权与业务接口。
- 在 Bundle 中开发 Module,以标准方法封装后端接口。
- 创建 Module 和 Bundle 的不可变版本,将 Bundle 安装到目标 Application Runtime。
- 为 Module 配置后端 Endpoint 与受保护的调用授权,再从 Runtime 验证方法和日志。
安装 Bundle 提供的是访问后端的模块能力,不会自动创建后端项目、Environment、部署或数据库。 后端只向网站或外部系统提供 API 时,可以独立使用,无须创建 Bundle。 资源关系和生命周期边界见后端应用开发。
测试服务
用真实请求测试接口返回、权限校验失败、异常提示和日志记录。涉及外部系统时,同时确认对方系统是否收到请求。