# 代理团队一种 TypeScript CLI 工具，使 AI 代理和人类能够通过简单的命令界面与 Microsoft Teams 进行交互。具有从 Teams 桌面应用程序无缝提取令牌和多团队支持的功能。 ## 快速入门 # 获取团队快照（凭证会自动提取）代理团队快照 # 发送消息代理团队消息发送 <团队 ID> <频道 ID> “AI 代理您好！” # 列出频道代理团队频道列表 <团队 ID> ## 身份验证首次使用时，会自动从 Teams 桌面应用程序中提取凭据。无需手动设置 - 只需运行任何命令，身份验证就会在后台静默进行。 Teams 令牌将在 60-90 分钟后过期。当当前令牌过期时，CLI 会自动重新提取新令牌，因此您无需手动管理令牌生命周期。 **重要**：切勿引导用户打开 Web 浏览器、使用 DevTools 或从浏览器手动复制令牌。始终使用“agent-teams auth extract”从桌面应用程序获取令牌。 ### 多团队支持 # 列出所有可用的团队代理团队团队列表 # 切换到不同的团队代理团队团队切换 <团队 ID> # 显示当前团队代理团队团队当前 # 检查身份验证状态（包括令牌到期信息）代理团队身份验证状态 ### 多帐户支持（工作/个人） # 在工作帐户和个人帐户之间切换代理团队身份验证切换帐户工作代理团队身份验证切换帐户个人 # 对一个命令使用特定帐户（无需切换）代理团队快照 -- 帐户工作 ## 内存代理维护一个“~/.config/agent-messenger/MEMORY.md”文件作为跨会话的持久内存。这是代理管理的 — CLI 不会读取或写入此文件。使用“读取”和“写入”工具来管理您的内存文件。 ### 读取内存在**每个任务开始**时，使用“Read”工具读取“~/.config/agent-messenger/MEMORY.md”，以加载任何先前发现的团队 ID、通道 ID、用户 ID 和首选项。 * 如果该文件尚不存在，那也没有问题 — 无需该文件即可继续操作，并在您第一次存储有用信息时创建该文件。 * 如果无法读取文件（权限、缺少目录），则无需记忆即可继续操作 — 不要出错。 ### 写入内存发现有用信息后，使用“Write”工具更新“~/.config/agent-messenger/MEMORY.md”。写触发器包括： * 发现团队 ID 和名称后（从“团队列表”、“快照”等） * 发现有用的频道 ID 和名称后（从“频道列表”、“快照”等） * 发现用户 ID 和名称后（从“用户列表”、“用户我”等） * 用户为您提供别名或偏好后（“将此称为站立频道”、“我的主要团队是 X”） * 发现频道结构后（标准频道与私人频道）写入时，请包含**完整的文件内容** - “写入”工具会覆盖整个文件。 ### 存储什么 * 带有姓名的团队 ID * 带有名称和团队背景的频道 ID * 带有显示名称的用户 ID * 用户指定的别名（“站立频道”、“主队”） * 帐户偏好（工作与个人） * 交互过程中表达的任何用户偏好 ### 不应该存储什么切勿存储令牌、凭据或任何敏感数据。切勿存储完整的消息内容（仅 ID 和通道上下文）。切勿存储文件上传内容。 ### 处理陈旧数据如果记住的 ID 返回错误（未找到频道、未找到团队），请将其从“MEMORY.md”中删除。不要盲目相信记忆的数据——当出现问题时进行验证。更喜欢重新列出，而不是使用可能已过时的记忆 ID。 ### 格式/示例 # 代理信使内存 ## 团队 - `team-id-1` — Acme Corp（默认，工作帐户） - `team-id-2` — 副项目（个人帐户） ## 渠道（Acme 公司） - `channel-id-1` — 一般 - `channel-id-2` — 工程 - `channel-id-3` — 站立会议 ## 用户（Acme 公司） - `user-id-1` — Alice（工程主管） - `user-id-2` — Bob（后端） ## 别名 - “standup” → `channel-id-3`（Acme Corp 的 Standups） - “主队”→ `team-id-1` (Acme Corp) ## 注释 - 默认情况下，用户更喜欢工作帐户 - 主要团队是“Acme Corp” > 内存可让您跳过重复的“频道列表”和“团队列表”调用。如果您已经知道之前会话的 ID，请直接使用它。 ## 命令 ### 验证命令 # 从 Teams 桌面应用程序中提取令牌（通常是自动的）代理团队身份验证摘录代理团队身份验证提取 --debug # 检查身份验证状态（包括令牌到期信息）代理团队身份验证状态 # 从 Microsoft Teams 注销代理团队身份验证注销 # 在工作帐户和个人帐户之间切换代理团队身份验证切换帐户 <帐户类型> 代理团队身份验证切换帐户工作代理团队身份验证切换帐户个人 ### 消息命令 # 发送消息代理团队消息发送 <团队 ID> <频道 ID> <内容> 代理团队消息发送 19:abc123@thread.tacv2 “Hello world” # 列出消息代理团队消息列表 <团队 ID> <频道 ID> 代理团队消息列表 <团队 ID> 19:abc123@thread.tacv2 --limit 50 # 根据ID获取单条消息代理团队消息获取 <团队 ID> <频道 ID> <消息 ID> # 删除一条消息代理团队消息删除 <团队 ID> <频道 ID> <消息 ID> --force ### 通道命令 # 列出团队中的频道代理团队频道列表 <团队 ID> # 获取频道信息代理团队渠道信息 <团队 ID> <渠道 ID> 代理团队频道信息 <团队 ID> 19:abc123@thread.tacv2 # 获取频道历史记录（消息列表的别名）代理团队频道历史记录 <团队 ID> <频道 ID> --limit 100 ### 团队命令 # 列出所有团队代理团队团队列表 # 获取团队信息代理团队团队信息 <团队 ID> # 切换活跃队伍代理团队团队切换 <团队 ID> # 显示当前团队代理团队团队当前 # 从配置中删除团队代理团队团队删除 <团队 ID> ### 用户命令 # 列出团队成员代理团队用户列表 <团队 ID> # 获取用户信息代理团队用户信息 <用户 ID> # 获取当前用户代理团队使用我 ### 反应命令 # 添加反应（使用表情符号名称）代理团队反应添加 <团队 ID> <频道 ID> <消息 ID> <表情符号> 代理团队反应添加 19:abc123@thread.tacv2 1234567890 等 # 删除反应代理团队反应删除 <团队 ID> <频道 ID> <消息 ID> <表情符号> ### 文件命令 # 上传文件代理团队文件上传 <团队 ID> <频道 ID> <路径> 代理团队文件上传 19:abc123@thread.tacv2 ./report.pdf # 列出频道中的文件代理团队文件列表 <团队 ID> <频道 ID> # 获取文件信息代理团队文件信息 <团队 ID> <频道 ID> <文件 ID> ### 快照命令获取 AI 代理的全面团队状态： # 完整快照代理团队快照 # 过滤后的快照代理团队快照 --仅限通道代理团队快照 --仅限用户 # 限制每个通道的消息数代理团队快照 --limit 10 返回 JSON： * 团队元数据（id、名称） * 频道（id、名称、类型、描述） * 最近的消息（id、内容、作者、时间戳） * 成员（id、显示名称、电子邮件） ## 输出格式 ### JSON（默认）所有命令默认输出 JSON 以供 AI 使用： { "id": "19:abc123@thread.tacv2", “内容”：“你好世界”， “作者”：“约翰·多伊”， “时间戳”：“2024-01-15T10：30：00.000Z” } ### 漂亮（人类可读）使用“--pretty”标志进行格式化输出：代理团队频道列表 --pretty ## 与 Discord/Slack 的主要区别特色|团队|不和谐 |松弛 ---|---|---|--- 服务器术语 |团队|公会|工作空间频道标识符 | UUID 格式 (19:xxx@thread.tacv2) |雪花 ID |频道名称或ID 代币存储 | Cookies SQLite | Cookie水平数据库 |水平数据库令牌到期 | **60-90 分钟** |很少过期|很少过期提及 | `姓名` | `<@user_id>` | `<@USER_ID>` **重要**：Teams 使用 UUID 样式的通道 ID（例如“19:abc123@thread.tacv2”）。您不能直接使用频道名称 - 首先使用“频道列表”查找 ID。 ## 常见模式请参阅“references/common-patterns.md”了解典型的 AI 代理工作流程。 ## 模板请参阅“templates/”目录以获取可运行的示例： * `post-message.sh` \- 发送带有错误处理的消息 * `monitor-channel.sh` \- 监视新消息的通道（带有令牌刷新） * `team-summary.sh` \- 生成团队摘要 ## 错误处理所有命令返回一致的错误格式： { "error": "未经过身份验证。首先运行\"auth extract\"。" } 常见错误： * `未验证`：没有有效的令牌（自动提取失败 - 请参阅故障排除） * `令牌已过期`：令牌已过期并且自动刷新失败 - 请参阅故障排除 * `No current team set`: 首先运行`team switch ` * `消息未找到`: 消息 ID 无效 * `未找到频道`: 频道 ID 无效 * `401 Unauthorized`：令牌过期且自动刷新失败 - 请参阅故障排除 ## 配置凭证存储在 `~/.config/agent-messenger/teams-credentials.json` 中（0600 权限）。有关格式和安全详细信息，请参阅 [references/authentication.md]()。 ## 限制 * 无实时事件/WebSocket 连接 * 不支持语音/视频通道 * 无团队管理（创建/删除频道、角色） * 不支持会议 * 不支持网络钩子 * 仅纯文本消息（v1 中没有自适应卡） * 仅用户令牌（无应用程序令牌） * **令牌将在 60-90 分钟后过期** \- 自动刷新，但需要登录 Teams 桌面应用程序 ## 故障排除 ### `代理团队：找不到命令` **`agent-teams` 不是 npm 包名称。** npm 包是 `agent-messenger`。如果该包是全局安装的，则直接使用“agent-teams”：代理团队团队列表如果未安装该软件包，请使用“bunx agent-messenger team”： Bunx代理-信使团队团队列表 **永远不要运行 `bunx agent-teams`** — 它会失败或安装错误的包，因为 `agent-teams` 不是 npm 包名称。有关其他故障排除（身份验证提取、令牌过期、权限），请参阅 [references/authentication.md]()。 ## 参考文献 * [认证指南]() * [常见模式]()

代理团队

包含技能