开发者文档
从快速入门到高级用法，我们提供了详尽的文档来帮助你快速集成 Devicebase。
快速开始
先注册账户，再创建并获取 API Key，然后选择接入方式。Agent Skills 适合 AI Agent， SDK 适合你自己的应用或服务端代码集成。
1
创建账户并获取 API Key
先注册账户，登录后在控制台创建API Key。然后可以复制带 API Key 的 Prompt 给你的 AI Agent 来自动完成接入 Devicebase。
2
选择接入方式
Agent Skills 适合 AI Agent，SDK 适合你自己的应用或服务端代码集成。
方式 A · Agent Skills
通过 AI Agent 直接操作设备
适合 AI 原生产品、Copilot 工作流、面向自然语言的自动化场景。
接入更快自然语言交互适合 AI Agent
1
安装 devicebase skill 到你的 AI Agent
$ npx skills add https://github.com/devicebase/skills --skill devicebase
2
检查并安装 devicebase-cli
$ which devicebase || curl -fsSL https://downloads.devicebase.cn/cli/install.sh | bash
3
配置设备访问凭证
$ export DEVICEBASE_API_KEY="your_api_key"
4
在AI对话中直接调用技能操作设备
使用 `devicebase` 技能操作设备 `your-device-serial-number` 告诉我主屏幕有什么内容。
方式 B · SDK 集成
在代码中调用 Devicebase API
适合 Web 服务、后端任务、自动化平台，以及需要精细控制设备流程的场景。
控制更灵活多语言支持适合应用集成
1
安装 SDK
$ pip install devicebase
2
初始化客户端
from devicebase import DeviceBaseClient
client = DeviceBaseClient(
api_key="your-api-key",
serial="device-serial-number"
)
3
开始调用 API
from devicebase import DeviceBaseClient
client = DeviceBaseClient(
api_key="your-api-key",
serial="device-serial-number"
)
# 获取设备信息
device_info = client.get_device_info()
# 截取设备屏幕
screenshot_bytes = client.get_screenshot()
# 执行自动化命令
result = client.tap("100", "200")
result = client.launch_app("com.tencent.mm")