介绍
Poco AI Agent 平台文档入口，帮助你按角色找到使用、集成、部署与开发内容。
Poco: Your Pocket Coworker. 是面向开发者工作流和团队自动化场景的 AI Agent 执行平台。
它把任务创建、会话执行、产物沉淀、能力扩展、自动化调度和外部系统集成放在同一套平台里，让团队可以把一次性的 AI 对话变成可复用、可追踪、可治理的工作流。
先读哪一部分
- 第一次使用 Poco：从 起步 开始，再完成 创建第一个任务。
- 想看懂一次任务如何执行：阅读 会话执行 和 产物管理。
- 需要交付或复用结果：阅读 分享与继续探索 和 发布页。
- 需要配置团队能力：阅读 能力配置、Agent 工作台 和 管理员配置。
- 需要做自动化交付：阅读 自动化任务。
- 需要接入外部系统：先读 API 与 WebHook，再查看 API 文档 和 WebHook。
- 需要部署或维护系统：阅读 部署指南、配置参考 和 数据库迁移回滚。
- 需要理解架构或参与开发：阅读 整体技术方案与架构说明 和 开发指南。
文档地图
快速开始
快速开始 面向日常使用者，按真实使用顺序覆盖界面导航、任务创建、会话协作、产物管理、分享复用、Agent、能力配置、自动化任务、外部接入和管理员配置。
如果你只想尽快跑通一次完整闭环，这是最合适的入口。
平台说明
平台说明 面向需要理解系统边界、产品能力和设计方案的读者。
这里包含整体架构、功能模块、Agent 工作台设计、浏览器登录态、记忆架构、产物智能推荐、浏览器实时预览、IM 多通道方案和内部培训材料。
外部集成
外部集成 面向需要把 Poco 接入业务系统、工具平台或通知链路的开发者。
这里提供 API、OpenAPI 风格接口、会话复用、附件上传、SSE 流式响应、公开发布页和 WebHook 签名验签说明。
运维部署
运维部署 面向部署、配置和维护 Poco 的人员。
这里说明 Docker Compose 启动方式、环境变量、对象存储、数据库、Memory Service、RustFS 以及数据库迁移回滚边界。
开发指南
开发指南 面向参与 Poco 代码维护的开发者。
这里说明前端、Python 服务、Backend 分层边界、关键链路源码、配置快照、日志规范和文档开发约定。
常见问题与更新日志
常见问题 用于解释 Agent、Workflow 等基础概念。
更新日志 记录版本变化、功能新增、问题修复和重要行为调整。
平台能力一览
- 任务执行：通过场景 Agent、新任务入口、临时对话或外部 API 发起任务。
- 会话协作：在执行过程中查看状态、补充指令、人工确认、停止或继续追问。
- 产物管理：预览、下载、分享、导出和沉淀 Agent 生成的文件。
- 能力扩展：通过 Skills、MCP、插件、Subagents、环境变量和记忆增强执行能力。
- 自动化交付：通过定时任务、发布中心、案例库和工作流看板复用稳定流程。
- 外部集成：通过 API、WebHook、SSE 和公开发布页连接业务系统。
- 运维治理：通过管理员配置、模型配置、通知、资源菜单、成本审计和配置文档维护平台。
核心执行链路
一次典型任务会经过以下链路：
- 用户在 Web 界面或外部系统创建任务。
- Backend 持久化会话、配置快照和执行状态。
- Executor Manager 负责调度、分发和运行时编排。
- Executor 在隔离工作区中执行任务，并按需使用浏览器、文件、Skills、MCP、记忆等能力。
- 高频流式内容从 Executor 直达 Backend 并实时推送；普通状态、终态和异常降级仍经过 Executor Manager。
- 前端按消息序号展示内容，断线或缺口从历史事件恢复，终态再与服务端消息历史校准。
更完整的服务边界、状态机、时序图和部署拓扑，请阅读 整体技术方案与架构说明。