Confluent - 智能会计集成
一个实现财务工作流程无缝衔接的会计自动化代理
______________________________________________________________________
概述
Confluent是专为2025年ADK-TS黑客马拉松打造的一项创新解决方案，提供了一个模型上下文协议（MCP）服务器和AI代理，用于与Zoho和Xero会计平台进行集成。它使用户能够创建由AI驱动的财务工作流，实现会计数据的无缝访问、发票创建以及通过ADK-TS框架驱动的自动化电子邮件通知。
______________________________________________________________________
特点/功能
MCP集成
- Zoho与Xero的连接性： 通过OAuth认证统一访问会计数据。
- 财务数据访问： 检索财务摘要、联系人列表和发票。
- 发票自动化： 在Zoho或Xero上直接创建和管理发票。
- 电子邮件通知： 通过Resend发送专业的发票邮件或自定义消息。
AI代理能力
- 智能工作流 自主完成金融任务中的推理工作，如数据总结或发票创建。
- 多步骤自动化： 处理复杂任务，如创建联系人后随即生成发票。
- 错误处理： 优雅地处理身份验证或租户选择问题的恢复。
- 可定制工具： 可扩展的财务操作和电子邮件生成工具。
客户端接口
- 终端客户端： 通过简单的命令行界面与AI代理进行交互。
- Discord 机器人： 通过Discord进行实时互动，解答财务问题并实现自动化操作。
- 可扩展会话： 支持多用户，并通过会话管理提供个性化体验。
安全与认证
- OAuth 集成： 使用令牌刷新功能安全连接到Zoho和Xero。
- 基于Redis的存储： 安全管理和用户令牌及组织ID。
- 错误恢复： 无缝引导用户完成身份验证或租户选择。
______________________________________________________________________
建筑学
Confluent 由三个核心组件构成：
- MCP 服务器： 处理与Zoho、Xero和Resend的API集成，为财务数据和操作提供统一的接口。
- AI Agent（人工智能代理） 使用ADK-TS构建，负责协调金融工作流、处理用户提示并与MCP服务器进行交互。
- 客户： 提供终端和Discord交互界面，让用户能够无缝访问金融工具。
______________________________________________________________________
技术栈
| 组件 | 技术 |
|---|---|
| 后端 | Node.js, TypeScript, ADK-TS, Redis |
| 数据库 | Redis |
| 集成应用 | Zoho Books, Xero, Resend |
| 客户端 | Discord，终端 |
______________________________________________________________________
快速入门
先决条件
- Node.js 18及以上版本
- Redis（Upstash）
- Zoho Books/Xero API 凭据
- 重新发送API密钥
- Discord 机器人令牌（用于 Discord 客户端 - 可选）
安装
# Clone the repository
git clone https://github.com/Davidthecode/confluent.git
cd confluent
# Set up environment variables
# can find in .env.example
# Update .env with your Zoho, Xero, Resend, and Redis credentials.
# Start the MCP server
cd mcp
pnpm install
pnpm run dev
# Start the AI agent
cd agent
pnpm install
pnpm run start
# Run the client
cd client
pnpm install
(choose one)
# Terminal:
pnpm run start
# Discord:
pnpm run start:discord
人工智能集成
ADK-TS 框架
- 多功能工具工作流程： 协调任务，如联系人创建、发票生成和电子邮件发送。
- 自定义工具： 专门用于财务数据检索、发票创建和电子邮件生成的工具。
- 会话管理： 使用InMemorySessionService支持多用户。
- 错误处理： 针对身份验证、租户选择和API错误的稳健恢复。
代理能力
- 财务总结： 汇总收入、费用和净利润。
- 发票自动化： 开具发票并发送专业电子邮件。
- 联系人管理： 添加和检索客户/供应商详细信息。
- 认证指南： 引导用户完成OAuth认证和租户选择。