大多数 AI 工具是个「独立网站」——你跳过去问它，再把答案粘回团队群。Agensis 的思路完全不同：它提出「人机共享工作区」，把 Agent 当作真人队友邀请进你的团队频道（Slack / 飞书 / Discord 之类），本地运行、推理不计入平台账单，和人一样领任务、交成果、参与讨论。本教程手把手教你搭一个能融入现有协作流的 Agent 队友。
🤝 本教程适合：团队已经在用某款协作软件、想让 AI 直接「进群干活」而非另开一个聊天窗口的团队负责人 / 运营。你需要能跑 Docker 的机器和一个大模型 API Key。
先搞懂：共享工作区 vs 传统 chatbot
用一句话理解：传统 chatbot 是「外挂窗口」，共享工作区里的 Agent 是「编入团队的同事」。
| 维度 | 传统 chatbot | Agensis 共享工作区 |
|---|---|---|
| 入口 | 独立网站 / App | 直接在你的团队频道里 @ 它 |
| 上下文 | 看不到团队讨论 | 能读频道历史，知道前因后果 |
| 运行位置 | 厂商云端 | 你本地，推理不计入平台账单 |
| 协作方式 | 你复制粘贴给它 | 它主动领活、交成果、@ 人 |
核心价值：Agent 不再是一个「你得单独照顾的东西」，而是团队里一个「自己会看群、自己领任务」的成员。信息不脱节，流程不中断。
Step 1：部署本地 Agensis 实例
1 本地跑起来（推理不进账单的关键）
Agensis 本地运行，意味着你的对话和推理发生在自己的机器 / 服务器上：
git clone https://github.com/agensis/agensis.git
cd agensis
docker compose up -d
# 配置你自己的模型（本地或自有 API）
export AGENSIS_MODEL="deepseek-v4-flash" # 用你自有的 Key
open http://localhost:3000💡 关键理解：因为模型调用走你自己的 Key / 本地模型，Agensis 平台不托管推理，所以「推理不计入平台账单」——你只为自有模型付费，且数据留在本地。
Step 2：把 Agent 邀请进团队频道
2 像加一个真人同事那样加它
在协作软件里安装 Agensis 集成，然后「邀请」Agent 加入频道：
# 以 Slack 为例
1. 在 Slack 应用目录安装 Agensis 应用
2. 在目标频道输入：/agensis invite @lobster-bot
3. 选它要加入的频道（如 #growth-team）
4. 它在频道里出现，带一个 🤖 头像，可被 @🚀 从此你在群里 @lobster-bot 「帮我把这条用户反馈整理成需求文档」，它直接读群上下文动手，不用你再复述背景。
Step 3：给 Agent 分配角色与权限
3 明确它能碰什么、不能碰什么
把 Agent 当真同事管理，先定角色边界：
# agensis 角色配置
@lobster-bot:
role: 增长团队助理
can: [读频道, 写文档, 总结会议, 起草回复]
cannot: [发邮件, 删消息, 动生产数据库]
scope: 仅 #growth-team 与 #ops安全底线：和人一样，新同事不给最高权限。先给「只读 + 起草」类权限，观察一阵再逐步放开「执行类」操作。
Step 4：派第一个协作任务
4 在群里直接对它说话
因为 Agent 能读频道历史，你不用交代背景，直接派活：
你：@lobster-bot 把上面这 20 条用户吐槽，按「bug / 需求 / 吐槽」分个类，
输出成表格发到 #product-backlog
lobster-bot：✅ 已分类（bug 7 / 需求 9 / 吐槽 4），
表格已发 #product-backlog，并 @ 了产品负责人 review💡 它「知道前因后果」的能力，来自对频道历史的读取——这正是共享工作区相比独立 chatbot 的最大省心点。
Step 5：审阅 Agent 成果并反馈
5 像带新人一样纠正它
Agent 第一次可能不达标，在群里直接反馈，它会记住偏好：
你：@lobster-bot 分类里「想要深色模式」算需求不是 bug，下次注意
lobster-bot：收到，已更新我的判断规则，后续「功能诉求」一律归需求🔑 持续在群里反馈，Agent 会沉淀出团队专属的判断标准——这就是「越用越懂你团队」的来历。
Step 6：成本与隐私（为什么不计入账单）
6 算清账、守住数据
理解它的计费与隐私模型，避免误会：
· 推理费：走你自有的模型 Key / 本地模型，Agensis 平台不收推理费
· 平台费：通常按「接入的 Agent 数量 / 席位」计费，不含 token
· 数据：频道内容在你本地实例处理，敏感信息不出内网注意区分：「推理不计入平台账单」≠「完全免费」。你仍需为自有模型付费；Agensis 收的是平台/席位费。但相比把每轮对话都交给托管 chatbot，长期成本可控得多。
常见问题速查
| 现象 | 原因 & 解决 |
|---|---|
| Agent 读不到历史消息 | 权限没开「读频道」，在集成设置里勾选消息读取范围 |
| 它干了不该干的 | 角色权限太宽，收紧 cannot 列表，先关执行类操作 |
| 响应慢 | 本地实例资源不足，给 Docker 加内存或换更快的本地模型 |
| 账单还是高 | 确认模型走的是自有 Key，而非 Agensis 托管的云端模型 |