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
S
Description
Autonomous robot prototype built on deepagents
Readme
712 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 100%