星战科技xingzhan.cloud
返回市场
零号代理工具包

零号代理工具包

作者：XeroAPI13 星标更新：2025-08-08
安装使用来源：spider==github.com

项目介绍

Xero Agent Toolkit

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

概述

此仓库提供了使用不同AI框架构建能够与Xero会计数据交互的智能代理的实际示例。每个示例都演示了如何利用Xero MCP服务器，以提供结构化的访问权限到Xero全面的会计功能。

你可以构建什么

该仓库中的示例展示了如何创建能够执行以下操作的AI代理：

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

可用示例

Python实现

🔗 Google ADK集成

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

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

🦜 LangChain集成

高级LangChain集成展示：

  • 专门的代理（发票专员、联系人管理器）
  • 多步骤业务工作流
  • 智能发票分析和建议
  • 支持异步/等待以优化性能

🤖 OpenAI代理SDK

OpenAI代理SDK实现，包括：

  • 多种专门的代理类型
  • 多代理协作工作流
  • 互动聊天界面
  • 全面的示例场景

TypeScript实现

🔧 OpenAI代理SDK（TypeScript）

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

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

🦜 LangChain（TypeScript）

TypeScript LangChain集成，包括：

  • 专门的代理（发票专员、联系人管理器）
  • 多步骤业务工作流和发票分析
  • 实时Xero操作的互动聊天界面
  • 组织洞察和全面报告
  • 使用@langchain/mcp-adapters进行类型安全操作

预备条件

所有示例所需

  • Xero开发者账户：从Xero开发者门户获取您的凭据
    • 客户ID
    • 客户密钥 确保您创建的是自定义连接类型的App - Web应用和PKCE应用将无法与这些示例一起工作。
  • Node.js和npm：用于Xero MCP服务器

框架特定需求

  • Google 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结合的AI代理

架构

此仓库中的所有示例都使用Xero MCP服务器作为AI框架和Xero API之间的桥梁。这种架构提供了：

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

示例用例

业务自动化

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

对话式会计

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

多代理工作流

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

获取帮助

贡献

我们欢迎贡献！无论您想：

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

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

许可证

该项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

相关项目

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