94421e5c2b98a3a630f4f4503e5c710b92e86b82
bot042
基于 deepagents 的自主行动机器人原型:理解任务、自主规划(todo)、调用机器人工具在模拟环境中行动。
特性
- 深度智能体:内置任务规划 / 子智能体 / 工具调用循环(deepagents)
- 机器人工具:感知
perceive、移动move、播报speak,附带简易虚拟世界状态 - uv 管理依赖与 Python,国内镜像加速(见
uv.toml) - CLI 入口:单次任务 / 交互模式
快速开始
uv sync
$env:OPENAI_API_KEY = "sk-..." # PowerShell;bash 用 export
uv run bot042 "感知环境,然后向北移动 2 步并播报状态"
交互模式:
uv run bot042 -i
配置(环境变量)
| 变量 | 说明 | 默认值 |
|---|---|---|
BOT042_MODEL |
langchain 模型标识(provider:model) |
openai:gpt-4o-mini |
OPENAI_API_KEY |
OpenAI 兼容 API Key | — |
OPENAI_BASE_URL |
兼容网关地址(DeepSeek / Kimi 等均可) | 官方地址 |
BOT042_MAX_STEPS |
单次任务最大步数(recursion_limit) | 50 |
BOT042_LOG_LEVEL |
日志级别 | INFO |
使用 DeepSeek 等 OpenAI 兼容服务示例:
$env:OPENAI_BASE_URL = "https://api.deepseek.com/v1"
$env:OPENAI_API_KEY = "sk-..."
$env:BOT042_MODEL = "openai:deepseek-chat"
目录结构
src/bot042/
__main__.py # CLI 入口(uv run bot042)
config.py # 环境变量配置
agent/ # 智能体:组装(agent.py)、提示词(prompts.py)、工具(tools.py)
channels/ # 通道:与外部世界交互,base.py 定义协议,cli.py 为 CLI 实现
flows/ # 编排:单任务流程(task.py)、交互会话流程(session.py)
tests/ # 冒烟测试
uv.toml # 国内镜像配置(TUNA PyPI + npmmirror Python)
分层关系:channels(收/发消息)→ flows(组织流程)→ agent(智能体与工具)。新增通道实现 channels.base.Channel 协议即可复用现有 flows。
开发
uv run pytest # 运行测试
uv run ruff check # 代码检查
uv run ruff format # 格式化
镜像源
uv.toml 已配置国内镜像,uv sync / uv python install 均自动生效:
- PyPI 包:清华大学 TUNA —
https://pypi.tuna.tsinghua.edu.cn/simple - Python(python-build-standalone):npmmirror —
https://registry.npmmirror.com/-/binary/python-build-standalone
Description
Autonomous robot prototype built on deepagents
712 KiB
0 Stars
1 Watchers
0 Forks
Languages
Python
100%