使用Pydanthic AI和Box MCP服务器生成Box文档
演示如何构建一个Pydantic AI代理，该代理能够与Box MCP服务器交互并生成文档。
概述
该项目提供了一个命令行界面，用于使用AI代理与Box的文档生成功能进行交互。它使用户能够通过对话提示上传模板、处理数据文件和自动生成文档。
特性
- Box身份验证：与MCP服务器相同
- 文件上传和管理：将本地文件上载到Box文件夹
- 文档模板管理：将文件标记为文档生成模板
- 自动文档生成：使用模板和数据文件创建文档
- 人工智能驱动的交互：与代理自然对话以执行任务
先决条件
- Python 3.11或更高版本
- 具有适当权限的Box帐户
- OpenAI API密钥
安装
- 克隆存储库：
git clone https://github.com/box-community/doc-gen-pydantic-ai-box-mcp-server.git
cd doc-gen-pydantic-ai-box-mcp-server- 创建虚拟环境：
uv lock
uv sync- 创建一个
.env使用OpenAI API密钥的文件：
OPENAI_API_KEY = sk-YOUR API KEY- 在您的Box帐户中创建一个名为的文件夹
OpenAI Doc Gen
用法
运行演示脚本以查看代理的运行情况：
uv run src/demo.py这将：
- 使用Box进行身份验证
- 显示您登录的身份
- 将模板文件上载到指定的Box文件夹
- 将文件标记为文档生成模板
- 以JSON格式上传数据
- 根据模板和数据生成新文档
项目结构
.
├── data/ # Data files and templates
│ ├── nda_template.docx # Example document template
│ └── NDA.json # Example data for document generation
├── src/ # Source code
│ ├── console_utils.py # Utilities for console output
│ └── demo.py # Main demo script
├── .env # Environment variables (create this)
└── README.md # This file运作原理
代理人使用：
- OpenAI的GPT模型 解释用户指令
- pydantic_的 处理代理框架
- Box MCP服务器 与Box的API通信
工作流程通常包括：
- 使用Box工具初始化代理
- 用自然语言处理用户命令
- 执行适当的Box操作
- 对执行的操作提供反馈
贡献
欢迎投稿！请随时提交拉取请求。