Skip to content

orionagent/agentos-sdk

Repository files navigation

AgentOS SDK 开发文档

版本兼容性与集成指南

本文档提供完整的AgentOS SDK集成方案,必须严格按照目标设备型号和系统版本选择对应的SDK版本。

📋 版本更新历史: 查看完整版本变更日志 →

版本对应关系

  • Mini机器人:最新版本 → AgentOS SDK v0.4.5 (推荐)
  • 豹小秘2机器人:最新版本 → AgentOS SDK v0.4.5 (推荐)

⚠️ 重要提示:推荐使用最新ROM版本以获得最佳性能和稳定性

平台兼容性矩阵

🤖 豹小秘2机器人

系统版本 ROM版本 AgentOS版本 SDK版本 维护状态
Release Latest V11.7 v1.7.0 v0.4.5 ✅ 最新版本 (推荐)
Release Latest V11.6.2025092601 v1.6.0.250925.C v0.4.4 ✅ 稳定版本
Release V11.4.2025082001 V1.4.0.250818.C v0.3.7 ⚠️ 旧版本

🔹 Mini机器人

系统版本 ROM版本 AgentOS版本 SDK版本 维护状态
Release Latest V11.7 v1.7.0 v0.4.5 ✅ 最新版本 (推荐)
Release Latest V11.6.2025100912 V1.6.0.250925C v0.4.4 ✅ 稳定版本
Release Enhanced V10.3.2025071101 V1.3.0.250630.C v0.3.5 ⚠️ 旧版本

💡 提示:推荐使用最新Release系统以获得完整功能支持和最佳性能体验

生产环境推荐配置

  • 豹小秘2机器人AgentOS SDK v0.4.5 + 最新Release系统 (v1.7.0)
  • Mini机器人AgentOS SDK v0.4.5 + 最新Release系统 (v1.7.0)

⚠️ 集成注意事项

版本不匹配可能导致API调用异常或运行时错误。请务必根据目标设备的系统版本选择匹配的SDK版本,确保应用程序的稳定性和兼容性。


SDK概述

AgentOS SDK 是猎户星空智能机器人的官方开发工具包,提供完整的应用开发解决方案。SDK集成了大语言模型能力、机器人硬件控制接口、语音交互系统等企业级功能模块,支持快速构建智能机器人应用。

快速开始

开发环境要求

  • 编程语言:Java / Kotlin
  • 构建工具:Gradle
  • 开发平台:Android Studio
  • 目标平台:Android

核心文档

AgentOS SDK 文档

  • SDK开发文档AgentOS_SDK_Doc_v0.4.5.md
    • 大模型相关能力接口:对话管理、语音合成、智能交互等
    • 新增唤醒词模式控制功能
    • 适用于豹小秘2和Mini机器人最新版本
  • API参考v0.4.5版本
    • 完整的API参考文档,包含所有核心类、接口、方法、属性、构造函数、参数说明、返回值、使用示例等详细说明
  • 类路径参考v0.4.5版本
    • 项目中所有关键类的完整包路径
  • 示例代码v0.4.5版本
    • 各功能模块的典型实现示例
  • SDK Development Documentation (English)AgentOS_SDK_Doc_v0.4.5_en.md
    • Comprehensive guide for LLM capabilities, conversation management, TTS, intelligent interaction, wake-free functionality, and more
    • Applicable to the latest versions of Leopard Secretary 2 and Mini robots

机器人原生接口

  • RobotOS APIRobotAPI.md
    • 机器人原生控制接口:运动控制、导航、传感器、相机、充电、定位等
    • v0.4.4+ 重要更新:SDK已自动集成RobotService依赖,无需手动添加jar包
  • RobotOS API (English)RobotAPI_en.md
    • Complete reference for robot native control interfaces: motion control, navigation, sensors, camera, charging, localization, and more
    • Important Update for v0.4.4+: SDK automatically integrates RobotService dependency, no need to manually add jar packages

云端服务接口

AI辅助开发

Cursor AI 集成

  • 完整指南AGENTOS_CURSOR_AI_GUIDE.md
    • Cursor AI 集成步骤详解
    • AgentOS SDK 专用开发规则配置
    • AI 辅助开发最佳实践
  • 配置包cursor-rules-dependencies.zip
    • 包含完整的 Cursor Rules 配置
    • 支持智能代码生成和错误检测
    • 提供专业的 AgentOS SDK 开发建议

开发规范

技术架构与协作关系

SDK职责划分

  • AgentOS SDK:负责大模型集成、智能对话、Action规划执行、语音交互(ASR/TTS)、免唤醒等AI能力
  • RobotAPI:负责机器人底层控制,包括运动控制、导航、传感器、视觉、地图、充电等硬件能力
  • 协作关系:AgentOS SDK与RobotAPI协作使用,AgentOS SDK处理智能交互层面,RobotAPI处理硬件控制层面

⚠️ 重要:语音和NLP功能迁移

在AgentOS系统上,RobotAPI原有的ASR、TTS、NLP等语音能力已停用,所有语音和NLP相关功能需要迁移到AgentOS SDK。

迁移指引:详细的功能区别和迁移方案请参阅 RobotAPI.md

开发流程

标准开发步骤

  1. 环境准备:安装 Android Studio,配置开发环境
  2. 文档学习:阅读 AgentOS SDK 文档和机器人原生接口文档
  3. 示例参考:参考示例代码 (v0.4.5版本)
  4. API查阅:通过API参考文档 (v0.4.5版本) 了解详细的类和方法使用说明
  5. 功能集成:按需集成 AgentOS SDK 和机器人原生API
  6. 测试验证:测试验证功能实现效果

最佳实践

  • 底层控制:合理使用机器人原生接口进行底层控制
  • 异步编程:遵循异步编程模式,避免阻塞主线程
  • 异常处理:做好异常处理和资源管理

其他资源


版本信息

  • 推荐SDK版本:AgentOS SDK v0.4.5(豹小秘2 & Mini机器人通用)
  • 机器人API版本:v11.3C
  • 文档更新时间:2025年11月19日

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors