开始使用Devicebase
从快速入门到高级用法，我们提供了详尽的文档来帮助你快速使用与集成 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
让 AI 自主安装推荐
把下面这句提示词直接发给你正在使用的 AI 工具，它会自己读取安装说明，完成 skill 安装、CLI 安装与凭证配置。
请根据 https://www.devicebase.cn/install.md 的说明来安装Devicebase技能
或 · 手动分步安装
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-serialno` 告诉我主屏幕有什么内容。
方式 B · SDK 集成
在代码中调用 Devicebase API
适合 Web 服务、后端任务、自动化平台，以及需要精细控制设备流程的场景。
控制更灵活多语言支持适合应用集成
1
安装 SDK
$ pip install devicebase
2
初始化客户端
from devicebase import DeviceBaseClient
client = DeviceBaseClient(
api_key="your-api-key",
serialno="your-serialno"
)
3
开始调用 API
from devicebase import DeviceBaseClient
with DeviceBaseClient(api_key="your-api-key", serialno="your-serialno") as client:
# 获取设备信息
device_info = client.get_device_info()
# 截取设备屏幕
screenshot_bytes = client.get_screenshot()
# 执行自动化命令
client.tap(100, 200)
client.launch_app("com.tencent.mm")