Python SDK

BeeOS 发布两个相关的 Python package：

Package	用途
`beeos`	推荐使用的官方入口和稳定 facade。
`beeos-sdk`	完整 OpenAPI 生成 client，import 名为 `beeos_sdk`。

两者都调用 https://openapi.beeos.ai 的 Platform OpenAPI，不封装独立的 A2A 或 MCP 协议。

如果正在构建 LangChain 或 LangGraph 应用，langchain-beeos 基于公开的 beeos 包，将实例、智能体、计算机和移动设备操作公开为类型化工具。参见 LangChain 与 LangGraph。

安装

python -m pip install beeos

beeos 会安装兼容版本的 beeos-sdk。只有需要直接使用生成代码时，才需要单独安装 beeos-sdk。应用部署时应在锁文件中固定解析后的版本。本文档不再写死补丁版本，因此每次包发布后无需额外提交仅用于更新版本号的文档改动。

配置

先在环境变量中设置 API Key：

export BEEOS_API_KEY="oag_..."

BeeOS() 会自动读取 BEEOS_API_KEY，并默认连接生产环境。只有需要连接其他环境时才需要设置 BEEOS_API_URL。

创建异步任务

from beeos import BeeOS

client = BeeOS()
agent = client.agents.list().data[0]
task = client.tasks.create(
    agent_id=agent.id,
    message="帮我做一个宣传 BeeOS 的视频",
)

print(task.data.task_id)

认证方式与其他 OpenAPI SDK 相同，支持用户 JWT 或 oag_ 用户 API Key。客户端不强制使用 with；需要明确管理生命周期时仍可使用上下文管理器。

显式配置

from beeos import BeeOS

client = BeeOS(
    api_key="oag_...",
    base_url="https://openapi.beeos.ai",
)

完整的生成 API 和 model 位于 beeos.sdk。也可以直接 import beeos_sdk：

import beeos_sdk

configuration = beeos_sdk.Configuration(
    host="https://openapi.beeos.ai",
    access_token="oag_...",
)

with beeos_sdk.ApiClient(configuration) as api_client:
    agents = beeos_sdk.AgentsApi(api_client).list_agents()

生成与兼容性

beeos-sdk 与 TypeScript、Go SDK 使用同一份 beeos-platform-v1.yaml 生成。OpenAPI 出现 breaking release 时，生成 class 和方法名可能变化；稳定的顶层 import 建议使用官方 beeos facade。

GitHub：beeos-ai/sdk-python
PyPI：beeos
PyPI：beeos-sdk

快速开始

指南

架构

A2A 协议

MCP

集成

SDK

参考

安装

配置

创建异步任务

显式配置

生成与兼容性

​安装

​配置

​创建异步任务

​显式配置

​生成与兼容性

安装

配置

创建异步任务

显式配置

生成与兼容性