起步

Poco 是一个面向开发者和业务团队的 Agent 执行平台。你只需要给出目标，系统会创建会话、调度运行环境、调用工具、沉淀产物，并把执行过程记录下来。

本节适合第一次使用 Poco 的用户，也适合管理员在培训前快速熟悉核心入口。

前置条件

• Node.js 22.x
• pnpm 10.x
• Python 3.12+
• uv
• PostgreSQL

如果只是体验线上环境，可跳过本地启动部分，直接从 界面导航 开始阅读。

启动前端

cd frontend
source ~/.nvm/nvm.sh && nvm use 22
pnpm install
pnpm dev

前端默认运行在 http://localhost:13030。

启动后端服务

每个 Python 服务都有独立的 pyproject.toml，需要分别进入目录启动。

cd backend
uv sync
uv run python -m app.main

cd executor
uv sync
uv run python -m app.main

cd executor_manager
uv sync
uv run python -m app.main

推荐阅读路径

1. 界面导航：先了解首页、侧边栏、搜索和设置入口。
2. 创建第一个任务：学会写清楚任务目标，并选择合适的执行方式。
3. 如何切换模型：选择适合当前任务的模型配置，并了解配置何时生效。
4. 会话执行：看懂执行状态、工具调用、人工确认和继续追问。
5. 产物管理：查看、预览和下载任务结果。
6. 分享与继续探索：分享 Agent、对话和产物，并让其他用户基于共享内容继续工作。
7. 发布页：把 HTML 或 Markdown 产物发布为固定地址，并了解智能推荐发布。
8. 能力配置：按场景启用 Skills、MCP、插件、环境变量和通知。
9. 子代理：理解子代理的作用、创建方式和复杂任务拆分。
10. 代理团队：了解如何让多个 Agent 协作处理复杂生产制造任务。

管理员建议继续阅读 管理员快速配置。

第一次完整闭环

1. 启动 Backend、Executor、Executor Manager 和 Frontend。
2. 登录前端。
3. 在首页或 Agent 工作台创建任务。
4. 进入会话页，观察状态、消息、Todo、工具调用和文件变化。
5. 任务完成后，在产物面板预览或下载结果。

示例任务：

请阅读这个仓库，梳理后端服务启动流程，并生成一份面向新同事的 Markdown 说明。
输出要求：
1. 先列出服务依赖。
2. 再给出本地启动步骤。
3. 最后补充常见问题。

使用建议

• 目标越具体，Agent 越容易交付可用结果。
• 涉及仓库、文件、接口、部署环境时，把路径、约束和期望格式写清楚。
• 不确定任务方案时，优先使用计划模式，让 Agent 先给计划再执行。
• 需要周期性产出的任务，沉淀为定时任务或场景 Agent。

常见问题

• 前端 lint 报 structuredClone is not defined：确认已切换到 Node.js 22.x。
• 任务没有执行：确认 Executor Manager 能访问 Backend 和 Executor。
• 回调没有入库：确认 callback token 和 callback base URL 配置一致。