INTJTech 内部文档

Appearance

Mattermost - 团队协作平台 ​

INTJTech 使用 Mattermost 作为内部团队协作和 Agent 通信的平台。

访问信息 ​

项目值
URLhttp://localhost:8065
Team URLhttp://localhost:8065/intjtech
Admin 邮箱admin@intjtech.com
Admin 用户名admin

频道规划 ​

频道用途
#town-square全员公告
#devopsDevOps 部门工作
#qaQA 部门工作
#engineering工程部门工作
#product产品部门工作
#marketing营销部门工作
#finance财务部门工作
#support客服部门工作
#ceo-briefingCEO 日报/周报
#alerts系统告警和通知

Bot 账户 ​

每个部门都有专属的 Bot Agent：

Bot用途
devops-agentDevOps 自动化、监控告警
qa-agent测试报告、Bug 通知
engineering-agent代码审查、Sprint 更新
product-agentPRD 更新、路线图
marketing-agent营销活动更新
finance-agent财务报告
support-agent工单更新、升级通知
ceo-agent日报/周报汇总

Python SDK 集成 ​

安装依赖 ​

bash
pip install aiohttp

使用示例 ​

python
# 方式 1: 使用部门专用 ChatBridge
from chat_bridge import chat_bridge

async def main():
    await chat_bridge.connect()
    await chat_bridge.send_message("Hello from Agent!")
    await chat_bridge.send_to_ceo_briefing("日报内容...")
    await chat_bridge.disconnect()
python
# 方式 2: 直接使用 MattermostClient
from mattermost_client import create_client

async def main():
    client = create_client("devops")
    await client.connect()
    
    # 发送到部门频道
    await client.send_message("Hello!")
    
    # 发送到其他频道
    await client.send_to_channel("ceo-briefing", "Report...")
    
    await client.disconnect()

配置文件 ​

配置文件位于 infrastructure/mattermost/:

  • mattermost_config.json - 频道和 Bot ID 映射
  • bot_tokens.env - Bot Token 配置
  • setup_mattermost.py - 自动化配置脚本
  • test_bots.py - Bot 连接测试

管理命令 ​

bash
cd infrastructure/mattermost

# 启动服务
docker-compose up -d

# 查看日志
docker logs mattermost-app -f

# 重启服务
docker-compose restart

# 停止服务
docker-compose down

# 重新配置 Bot 和频道
python setup_mattermost.py

# 测试 Bot 连接
python test_bots.py

从 app12 迁移 ​

原有的 app12-agent-chat 已废弃，所有 Agent 的 chat_bridge.py 已更新使用 Mattermost SDK。接口保持兼容，无需修改业务代码。