finance-agent#

finance-agent 是一个用于记录公司开销并生成汇总表格的 Agent 技能。所有数据持久化到 Google Drive 的 CSV 文件中，确保数据安全可靠。

使用场景#

当用户需要以下操作时，请调用本技能：

• 记录一笔新的公司开销（如差旅、餐饮、办公用品等）
• 查看所有开销记录的汇总表格
• 导出开销报告为 CSV 或 Markdown 格式
• 追踪特定类别的开销

操作说明#

添加开销记录#

调用 add_expense 方法，传入以下参数：

参数类型说明示例date``str开销日期，格式为 YYYY-MM-DD``"2026-02-28"``category``str开销类别"Travel", "Meals", "Office Supplies"``amount``float开销金额250.75``description``str开销描述"Flight to client meeting"python

from finance_agent import FinanceAgent

agent = FinanceAgent()
agent.add_expense('2026-02-28', 'Travel', 250.75, 'Flight to client meeting')

生成开销汇总表格#

调用 generate_expense_table 方法，通过 output_format 参数指定输出格式：

格式说明"dataframe"返回 Pandas DataFrame 对象（默认）"csv"返回 CSV 格式字符串"markdown"返回 Markdown 格式表格字符串python

# 生成 Markdown 格式报告
markdown_table = agent.generate_expense_table(output_format='markdown')
print(markdown_table)

# 生成 CSV 格式报告
csv_data = agent.generate_expense_table(output_format='csv')

导出报告#

调用 export_report 方法，将报告保存到指定路径：

python

agent.export_report(output_path='expense_report.csv', output_format='csv')

数据持久化#

本技能使用 CSV 文件进行数据持久化。默认情况下，数据保存在 expense_report.csv 文件中。

若需将数据同步到 Google Drive，请确保已正确配置 GDRIVE_CREDENTIALS 环境变量，并使用 Google Drive API 将 CSV 文件上传到指定目录。

环境变量#

变量名说明GDRIVE_CREDENTIALSGoogle Drive API 凭据文件路径（JSON 格式）

文件结构#

text

finance-agent/
├── SKILL.md                # 本文件，技能说明文档
├── finance_agent.py        # 技能主逻辑实现
└── expense_report.csv      # 开销数据持久化文件（示例数据）

示例输出#

以下是 Markdown 格式的开销汇总表格示例：

DateCategoryAmountDescription2026-02-27Office Supplies55.0Printer paper and ink2026-02-26Travel250.75Flight to client meeting2026-02-25Meals45.5Lunch with a potential partner