Agent

灵活扩展的 Cloud Agent，AI 工作流的运行底座

主要特性

• 多会话并行，多层子任务
• 上下文自动压缩，保留近期完整 loop
• 插件系统：生命周期钩子 + 命令钩子，功能扩展不修改核心代码
• 技能系统：SKILL.md 指令模板，从 agent/skills/ 和 skills/ 加载，注入系统提示词
• MCP 支持：通过 agent-mcp 服务对接 Model Context Protocol

部署

uv sync
uv run python -m agent

Agent 监听 ws://localhost:8765。

Docker

docker compose up -d --build

外部服务需要单独启动：

cd services/mcp && docker compose up -d --build
cd services/searxng_search && docker compose up -d

配置

config.yml 覆盖默认值，支持 ${VAR} 环境变量展开。agent/AGENTS.md 作为 system prompt。

model:
  providers:
    deepseek:
      base_url: https://api.deepseek.com
      api_key: ${DEEPSEEK_API_KEY}
      models:
        v4-pro:
          name: deepseek-v4-pro
          max_tokens: 128000
  alias:
    main: deepseek:v4-pro
    flash: deepseek:v4-flash

agent:
  max_concurrent: 10
  max_iterations: 100

tools:
  - subjob
  - websearch:
      search_url: http://searxng:8080

plugins:
  - websocket:
      host: 0.0.0.0
      port: 8765
  - session:
      max_load_messages: 100
      max_tokens: 128000
      compress_threshold: 0.9
      system_prompt_path: agent/AGENTS.md
  - workspace
  - subjob:
      max_depth: 2
  - logging
  - mcp:
      base_url: http://agent-mcp:8001

外部服务

• services/mcp/ — agent-mcp 服务，管理 Node.js MCP servers，端口 8001
• services/searxng_search/ — SearXNG 搜索服务，端口 8080