🤖 Onboard AI——AI员工入职代理
黑客马拉松项目 --内置于 阿奇斯特拉,开源MCP原生安全AI平台。
一个智能代理,可以自动化跨部门的员工入职流程 GitHub, Slack, Google 云端硬盘,以及 内部wiki --所有这些都是通过Archestra的安全MCP平台进行编排的,该平台具有内置的治理、成本监控和及时的注入保护。
______________________________________________________________________
✨ 特性
| 特性 | 描述 |
|---|---|
| 🚀 一个指令登机 | 告诉代理人派人上船,它会处理一切 |
| 🔗 GitHub 集成 | 组织邀请、仓库访问、开发设置问题 |
| 💬 Slack集成 | 欢迎DM、渠道邀请、团队介绍 |
| 📁 Google 云端硬盘 | 共享手册,创建个人文件夹 |
| 🌐 Wiki浏览 | 剧作家MCP浏览内部文档 |
| 📊 实时仪表板 | 漂亮的深色主题UI跟踪入职进度 |
| 🔒 设计安全 | Archestra的双LLM可防止快速注射 |
| 💰 成本控制 | 内置代币限制和成本优化 |
| 🎯 基于角色的工作流 | 工程、设计等不同的检查表。 |
______________________________________________________________________
🏗️ 建筑
┌─────────────────────────────────────────────────────┐
│ Archestra Platform │
│ ┌───────────────┐ ┌────────────────────────────┐ │
│ │ Chat UI / │ │ Security Engine │ │
│ │ Agent Builder│ │ (Dual LLM, Dynamic Tools)│ │
│ └──────┬────────┘ └────────────────────────────┘ │
│ │ │
│ ┌──────▼────────────────────────────────────────┐ │
│ │ MCP Gateway & Orchestrator │ │
│ │ ┌──────────┐ ┌──────────┐ ┌───────────────┐ │ │
│ │ │ Onboard │ │Playwright│ │ Cost/Limits │ │ │
│ │ │ MCP Srv │ │ MCP Srv │ │ Monitoring │ │ │
│ │ └──────────┘ └──────────┘ └───────────────┘ │ │
│ └───────────────────────────────────────────────┘ │
└──────────┬──────────────────────────────────────────┘
│
┌──────▼──────┐
│ Dashboard │
│ (Web UI) │
└─────────────┘______________________________________________________________________
🚀 快速开始
先决条件
1.克隆和启动
git clone https://github.com/your-username/onboard-agent.git
cd onboard-agent
# Start Archestra + Onboarding MCP Server
cd archestra
docker-compose up -d2.设置代理
遵循详细信息 安装指南 致:
- 在Archestra中注册自定义MCP服务器
- 安装Playwright MCP
- 创建入职代理
- 添加您的LLM API密钥
3.打开仪表板
打开 dashboard/index.html 在浏览器中查看入职跟踪用户界面。
4.开始登机!
前往Archestra聊天界面 http://localhost:3000 并尝试:
Onboard Sarah Chen as a Software Engineer on the Platform team.
Her email is sarah.chen@acme-corp.com and GitHub is sarahchen.______________________________________________________________________
📁 项目结构
onboard-agent/
├── mcp-server/ # Custom MCP Server (Python)
│ ├── server.py # FastMCP server with 8 tools
│ ├── models.py # Pydantic data models
│ ├── store.py # Data persistence layer
│ ├── requirements.txt # Python dependencies
│ └── integrations/
│ ├── github_integration.py
│ ├── slack_integration.py
│ └── gdrive_integration.py
├── workflows/ # Role-based onboarding templates
│ ├── general.json
│ ├── engineering.json
│ └── design.json
├── archestra/ # Archestra Platform Config
│ ├── agent-config.yaml # Agent definition & system prompt
│ ├── docker-compose.yml # Full local stack
│ └── setup-guide.md # Step-by-step setup instructions
├── dashboard/ # Onboarding Dashboard (Web UI)
│ ├── index.html
│ ├── styles.css
│ └── app.js
├── Dockerfile # Container image for MCP server
├── .env.example # Environment variables template
└── README.md______________________________________________________________________
🛠️ MCP工具
| 工具 | 说明 |
|---|---|
onboard_new_hire | 完整的入职流程 |
github_invite_to_org | GitHub组织邀请+仓库访问 |
slack_send_welcome | Slack DM+频道邀请 |
gdrive_share_docs | 共享驱动器文档和文件夹 |
check_onboarding_status | 实时进度检查 |
get_onboarding_checklist | 特定角色任务列表 |
complete_task | 将任务标记为已完成 |
list_all_employees | 列出所有入职员工 |
______________________________________________________________________
🔒 Archestra的安全保障
该项目利用了Archestra的企业安全功能:
- 双LLM --工具响应由单独的安全模型处理,防止从工具输出中迅速注入
- 动态工具 --工具仅在需要时暴露,减少了攻击面
- 成本限制 --每次对话令牌和工具调用限制可防止成本失控
- 可观测性 --对每次审计工具调用进行全面跟踪
______________________________________________________________________
🔧 配置
复制 .env.example 到 .env 并填写您的API密钥:
cp .env.example .env| 变量 | 必填 | 描述 |
|---|---|---|
GITHUB_TOKEN | 否 | GitHub PAT用于真实组织邀请 |
SLACK_BOT_TOKEN | 否 | 用于真实消息的Slack机器人令牌 |
GDRIVE_SERVICE_ACCOUNT_KEY | 否 | 谷歌服务帐户JSON路径 |
注: 所有集成都在 模拟模式 没有代币——非常适合演示!
______________________________________________________________________
🤝 构建于
______________________________________________________________________
📄 许可证
麻省理工学院许可证——专为黑客马拉松打造,随心所欲地使用! 🎉
