会计自动化代理

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 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认证和租户选择。