Orbit-代理工作流自动化系统
Orbit是一个智能代理,旨在通过集成Jira、Google Calendar和其他生产力工具来简化日常工作流程。它自动化了任务管理、会议安排、进度跟踪和状态报告,使团队和个人能够专注于高价值的工作,而不是手动协调。
架构概述
Orbit由三个核心组件组成:
1. 近江 -入口点
记录对话并向系统发送语音命令的语音捕获设备。
- 收听语音命令,如“预订优步”、“安排会议”、“更新我的Jira票”
- 将音频片段发送到webhook进行处理
- 接收任务确认和状态更新
2. 纽带 -中间件代理
处理语音命令并与外部服务通信的智能代理。
- 使用LLM解析语音命令
- 将命令路由到适当的MCP(模型上下文协议)服务器
- 从对话流中维护上下文
- 执行多步骤工作流
3. MCP服务器 -服务集成
用于连接到外部服务的可扩展协议:
- Jira -更新工单、创建问题、管理冲刺
- Slack -发送消息、创建频道、发布通知
- 团队 -发送消息、安排会议
- 日历 -安排会议,检查可用性
- 公关系统 -创建pull请求,管理代码审查
- *(可以添加更多服务)*
项目结构
orbit/
├── main.py # FastAPI app with webhook and endpoints
├── ride_detector.py # LLM-powered command extraction
├── simple_storage.py # File-based user storage
├── auth_manager.py # Authentication and session management
├── uber_automation.py # Browser automation for ride booking
│
├── middleware/
│ ├── agent.py # Nexus agent - MCP server communication
│ ├── mcp_client.py # MCP protocol client
│ └── AGENTVERSE_README.md # Nexus architecture documentation
│
├── requirements.txt # Python dependencies
├── .env.example # Environment variables template
├── Dockerfile # Docker configuration
├── docker-compose.yml # Multi-container setup
├── railway.toml # Railway deployment config
└── README.md # This file特性
语音命令处理
- 滑动窗系列 -通过5秒的静音检测对语音片段进行批量处理
- LLM动力提取 -理解自然语言并纠正拼写错误
- 多业务路由 -将命令路由到适当的MCP服务器
支持的命令
乘车预订(通过优步自动化)
"Book an Uber to Pier 39"
"Get me a ride from UCSC to the airport"
"Call an Uber to downtown UCSC"Jira集成(通过Nexus+MCP)
"Update my Jira ticket PROJ-123 to done"
"Create a new ticket for bug fix"
"Show me my assigned tickets"日历集成(通过Nexus+MCP)
"Schedule a meeting with the team tomorrow at 2pm"
"Check my availability next week"
"Add this to my calendar"可扩展到更多服务:
- 松弛通知
- 团队消息
- 公关创建和审查
- 还有更多。..
设置
1.安装
git clone
cd orbit
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
playwright install chromium2.配置
cp .env.example .env
# Add your API keys:
# - OPENAI_API_KEY (for LLM processing)
# - JIRA_API_TOKEN (for Jira integration)
# - Other service credentials as needed3.跑步
uvicorn main:app --reload访问 http://localhost:8000
配置
环境变量
OPENAI_API_KEY-用于LLM处理的OpenAI API密钥JIRA_API_TOKEN-用于票务管理的Jira API代币JIRA_DOMAIN-您的Jira实例域PORT-服务器端口(默认值:8000)AUTO_REQUEST-自动预订游乐设施(默认值:false)
示例.env:
OPENAI_API_KEY=sk-proj-xxxxx
JIRA_API_TOKEN=your-jira-token
JIRA_DOMAIN=your-domain.atlassian.net
PORT=8000
AUTO_REQUEST=falseAPI终点
获取 /
显示系统状态和身份验证的主页。
获取 /auth
优步帐户连接的身份验证流程。
发布 /webhook
Omi设备语音命令的主要入口点。
请求正文:
{
"segments": [
{
"text": "Book an Uber to Pier 39",
"speaker": "user"
}
],
"gps_lat": 37.7749,
"gps_lon": -122.4194
}答复:
{
"message": "Processing command...",
"command_type": "ride_booking|jira_update|calendar_event",
"status": "processing|completed|failed"
}获取 /health
健康检查端点。
工作流示例
示例1:语音到优步预订
User (via Omi): "Book an Uber to Pier 39"
↓
Webhook receives segments
↓
Sliding window waits for 5s silence
↓
LLM extracts: destination="Pier 39"
↓
Browser automation books ride
↓
Confirmation sent back to Omi示例2:语音转Jira更新
User (via Omi): "Update ticket PROJ-123 to done"
↓
Webhook receives segments
↓
LLM extracts: ticket="PROJ-123", status="done"
↓
Nexus agent connects to Jira MCP server
↓
Jira ticket updated
↓
Confirmation sent back to Omi示例3:语音转日历事件
User (via Omi): "Schedule a meeting tomorrow at 2pm"
↓
Webhook receives segments
↓
LLM extracts: event details from conversation context
↓
Nexus agent connects to Calendar MCP server
↓
Meeting scheduled
↓
Confirmation sent back to Omi文档
有关详细的架构和系统设计文档,请参阅:
- 文档/START_HERE.md -带有系统概述和架构图的快速入门指南
- 文档/架构/ARCHITECTURE_UNIVERSE.md -完整的系统架构和数据流
- 文档/架构/ARCHITECTURE_OMI.md -语音入口点(Omi设备)文档
- 文档/架构/架构_NEXUS.md -中间件大脑(Nexus代理)文档
- 文档/架构/ARCHITECTURE_MCP.md -服务集成(Jira MCP、谷歌日历MCP、优步服务)
- 文档/架构/ARCHITECTURE_GUIDE.md -所有架构文档的导航指南
Nexus代理(中间件)
Nexus代理是一种智能中间件,它:
- 维护对话上下文
- 将命令路由到适当的服务
- 处理多步骤工作流
- 管理服务集成
看 middleware/AGENTVERSE_README.md 详细的架构。
部署
码头工人
docker-compose up铁路
railway link
railway variables set OPENAI_API_KEY=your_key
railway upHeroku
heroku create your-app-name
heroku config:set OPENAI_API_KEY=your_key
git push heroku main安全
- ✅ 本地存储的会话文件(不在版本控制中)
- ✅ 存储在环境变量中的API密钥
- ✅ HTTPS在生产中强制执行
- ✅ 端点速率限制
- ✅ 用户身份验证
可扩展性
要添加新服务,请执行以下操作:
- 为服务创建MCP服务器
- 添加连接逻辑
middleware/agent.py - 更新
ride_detector.py识别服务的命令 - 为服务凭据添加环境变量
- 通过webhook使用语音命令进行测试
发展
运行测试
pytest tests/代码风格
black *.py
flake8 *.py许可证
专有许可证-需要批准
此项目是专有的,在使用、修改或分发之前需要作者的明确书面批准。
请求批准:
- 电子邮件:subhan.shaikh.me@gmail.com
- 电话:+1 925-430-9582
- 包括:项目细节、预期用例和时间表
- 在继续之前等待书面批准
禁止未经授权的使用、修改或分发。
______________________________________________________________________
专为企业工作流自动化而构建
