AI导哈

会计代理工具包

一个全面的示例集合，展示如何使用不同的AI框架和Xero MCP服务器构建与Xero API集成的AI代理。

  • by XeroAPI
  • Python
  • 本地部署
  • 57 星标
  • 更新于
在 GitHub 查看 XeroAPI/xero-agent-toolkit

使用说明

Xero代理工具包

一个全面的示例集合，演示如何使用各种代理框架和Xero MCP（模型上下文协议）服务器构建与Xero API集成的AI代理。

概述

该存储库提供了构建智能代理的实际示例，这些代理可以使用不同的人工智能框架与Xero会计数据进行交互。每个示例都演示了如何利用 Xero MCP服务器 为代理人提供对Xero全面会计功能的结构化访问。

你能建造什么

此存储库中的示例显示了如何创建AI代理，这些代理可以：

  • 📝 管理发票：使用自然语言创建、更新和跟踪发票
  • 👥 处理联系人：创建和管理客户和供应商
  • 💰 处理付款：根据发票记录和跟踪付款
  • 👨‍💼 工资单操作：管理员工、时间表和休假（如适用）
  • 💬 自然语言接口：处理有关会计数据的会话查询

可用示例

Python实现

🔗 谷歌ADK集成

演示与谷歌代理开发工具包（ADK）的集成，包括：

  • 通过MCP实时集成Xero
  • 会计查询的自然语言处理
  • 交互式演示模式和批处理操作
  • 全面的错误处理

🦜 LangChain集成

先进的LangChain集成展示：

  • 专业代理（发票专员、联系人经理）
  • 多步骤业务工作流程
  • 智能发票分析和建议
  • 异步/等待支持，实现最佳性能

🤖 OpenAI代理SDK

OpenAI代理SDK实现具有以下特点：

  • 多种专业代理类型
  • 多代理协作工作流
  • 交互式聊天界面
  • 综合示例场景

TypeScript实现

🔧 OpenAI代理SDK（TypeScript）

OpenAI代理SDK的TypeScript实现，包括：

  • Xero操作类型安全
  • 现代异步/等待模式
  • 交互式演示模式
  • 全面的代理工作流程

🦜 语言链（TypeScript）

TypeScript语言链集成具有以下特点：

  • 专业代理（发票专员、联系人经理）
  • 多步业务流程和发票分析
  • 具有实时Xero操作的交互式聊天界面
  • 组织见解和全面报告
  • 使用@langchain/mcp适配器进行类型安全操作

先决条件

所有示例都需要

  • Xero开发人员帐户：从获取您的凭据 Xero开发者门户
    • 客户端ID
    • 客户端密钥 确保您正在创建 自定义连接 应用程序类型-Web应用程序和PKCE应用程序不适用于这些示例
  • Node.js和npm：Xero MCP服务器需要

框架特定要求

  • 谷歌ADK：Google AI Studio API键或Vertex AI设置
  • LangChain：OpenAI API密钥
  • OpenAI代理：OpenAI API密钥

快速开始

  1. 克隆存储库：

    git clone https://github.com/xeroapi/xero-agent-toolkit.git
cd xero-agent-toolkit

  2. 选择您喜欢的框架 并导航到其目录

  3. 遵循特定的README 在每个子目录中查看详细的设置说明

  4. 设置环境变量 如每个示例中所述

  5. 运行示例 观看人工智能代理与Xero的合作

建筑

此存储库中的所有示例都使用 Xero MCP服务器 作为人工智能框架和Xero API之间的桥梁。该架构提供：

  • 标准化接口：所有框架的工具定义一致
  • 安全认证：MCP服务器处理的OAuth2流
  • 类型安全：所有Xero操作的结构化模式
  • 错误处理：强大的错误管理和重试逻辑
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Framework  │ ←→ │  Xero MCP       │ ←→ │   Xero API      │
│  (LangChain,    │    │  Server         │    │                 │
│   OpenAI, etc.) │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

示例用例

业务自动化

  • 自动化的月度发票工作流程
  • 客户入职与联系人创建
  • 付款处理和对账
  • 财务报告和分析

会话式会计

  • “为ABC公司开具1500美元咨询服务的发票”
  • “显示所有逾期发票”
  • “这个季度我的利润和亏损是多少？”
  • “使用电子邮件创建一个名为XYZ有限公司的新客户contact@xyz.com"

多代理工作流

  • 联系人管理→ 发票专家协作
  • 自动化的端到端业务流程
  • 智能数据分析和建议

获取帮助

贡献

我们欢迎捐款！您是否愿意：

  • 添加对新AI框架的支持
  • 改进现有示例
  • 添加新的用例或工作流
  • 修复错误或改进文档

请随时打开问题或提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关项目

准备好构建智能会计代理了吗？ 从上面的示例中选择您喜欢的框架并开始构建！ 🚀

相关 MCP