modbender 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" |
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 格式表格字符串 |
# 生成 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 方法，将报告保存到指定路径：
agent.export_report(output_path='expense_report.csv', output_format='csv')
数据持久化
本技能使用 CSV 文件进行数据持久化。默认情况下，数据保存在 expense_report.csv 文件中。
若需将数据同步到 Google Drive，请确保已正确配置 GDRIVE_CREDENTIALS 环境变量，并使用 Google Drive API 将 CSV 文件上传到指定目录。
环境变量
| 变量名 | 说明 |
|---|---|
GDRIVE_CREDENTIALS |
Google Drive API 凭据文件路径（JSON 格式） |
文件结构
finance-agent/
├── SKILL.md # 本文件，技能说明文档
├── finance_agent.py # 技能主逻辑实现
└── expense_report.csv # 开销数据持久化文件（示例数据）
示例输出
以下是 Markdown 格式的开销汇总表格示例：
| Date | Category | Amount | Description |
|---|---|---|---|
| 2026-02-27 | Office Supplies | 55.0 | Printer paper and ink |
| 2026-02-26 | Travel | 250.75 | Flight to client meeting |
| 2026-02-25 | Meals | 45.5 | Lunch with a potential partner |