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

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

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

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

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

建筑

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

• 标准化接口：所有框架的工具定义一致
• 安全认证：MCP服务器处理的OAuth2流
• 类型安全：所有Xero操作的结构化模式
• 错误处理：强大的错误管理和重试逻辑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Framework  │ ←→ │  Xero MCP       │ ←→ │   Xero API      │
│  (LangChain,    │    │  Server         │    │                 │
│   OpenAI, etc.) │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

示例用例

业务自动化

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

会话式会计

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

多代理工作流

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

获取帮助

• 框架特定问题：检查每个子目录中的README
• Xero API 问题：参观 Xero开发者门户
• MCP服务器问题：参见 Xero MCP服务器存储库
• 一般性问题：在此存储库中打开一个问题

贡献

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

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

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

许可证

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

相关项目

• Xero MCP服务器 -Xero的模型上下文协议服务器
• 模型上下文协议 -连接AI系统的开放标准
• Xero API文档 -官方Xero API文档

______________________________________________________________________

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