文档生成工具

一个基于Pydantic AI和Box MCP服务器的文档生成工具,支持上传模板、处理数据文件并通过对话式提示自动生成文档。

  • by box-community
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 box-community/doc-gen-pydantic-ai-box-mcp-server

使用说明

使用Pydanthic AI和Box MCP服务器生成Box文档

演示如何构建一个Pydantic AI代理,该代理能够与Box MCP服务器交互并生成文档。

概述

该项目提供了一个命令行界面,用于使用AI代理与Box的文档生成功能进行交互。它使用户能够通过对话提示上传模板、处理数据文件和自动生成文档。

特性

  • Box身份验证:与MCP服务器相同
  • 文件上传和管理:将本地文件上载到Box文件夹
  • 文档模板管理:将文件标记为文档生成模板
  • 自动文档生成:使用模板和数据文件创建文档
  • 人工智能驱动的交互:与代理自然对话以执行任务

先决条件

  • Python 3.11或更高版本
  • 具有适当权限的Box帐户
  • OpenAI API密钥

安装

  1. 克隆存储库:

    git clone https://github.com/box-community/doc-gen-pydantic-ai-box-mcp-server.git
    cd doc-gen-pydantic-ai-box-mcp-server
    
  2. 创建虚拟环境:

    uv lock
    uv sync
    
  3. 创建一个 .env 使用OpenAI API密钥的文件:

     OPENAI_API_KEY = sk-YOUR API KEY
    
  4. 在您的Box帐户中创建一个名为的文件夹 OpenAI Doc Gen

用法

运行演示脚本以查看代理的运行情况:

uv run src/demo.py

这将:

  1. 使用Box进行身份验证
  2. 显示您登录的身份
  3. 将模板文件上载到指定的Box文件夹
  4. 将文件标记为文档生成模板
  5. 以JSON格式上传数据
  6. 根据模板和数据生成新文档

项目结构

.
├── 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通信

工作流程通常包括:

  1. 使用Box工具初始化代理
  2. 用自然语言处理用户命令
  3. 执行适当的Box操作
  4. 对执行的操作提供反馈

贡献

欢迎投稿!请随时提交拉取请求。

许可证

MIT许可证