Microsoft Excel 集成

概述

让你的智能体在 OneDrive 或 SharePoint 中创建和管理 Excel 工作簿、工作表、表格和图表。你可以操作数据区域、创建可视化、管理表格，并借助 AI 自动化简化电子表格工作流。

前提条件

在使用 Microsoft Excel 集成之前，请确保你已具备：

• 一个拥有有效订阅的 CrewAI AMP 账户
• 一个可访问 Excel 与 OneDrive/SharePoint 的 Microsoft 365 账户
• 通过 集成页面 连接了你的 Microsoft 账户

设置 Microsoft Excel 集成

1. 连接你的 Microsoft 账户

1. 访问 CrewAI AMP Integrations
2. 在 Authentication Integrations 部分找到 Microsoft Excel
3. 点击 Connect 并完成 OAuth 流程
4. 授予文件和 Excel 工作簿访问所需权限
5. 从 Integration Settings 复制你的 Enterprise Token

2. 安装所需包

uv add crewai-tools

3. 环境变量设置

Note

要在 Agent(apps=[]) 中使用集成，你必须使用你的 Enterprise Token 设置 CREWAI_PLATFORM_INTEGRATION_TOKEN 环境变量。

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

或者将其添加到你的 .env 文件中：

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

可用操作

microsoft_excel/create_workbook

说明： 在 OneDrive 或 SharePoint 中创建一个新的 Excel 工作簿。

参数：

• file_path (string, required): 创建工作簿的路径（例如：MyWorkbook.xlsx）
• worksheets (array, optional): 要创建的初始工作表

  [
    {
      "name": "Sheet1"
    },
    {
      "name": "Data"
    }
  ]

microsoft_excel/get_workbooks

说明： 获取 OneDrive 或 SharePoint 中的所有 Excel 工作簿。

参数：

• select (string, optional): 选择要返回的特定属性
• filter (string, optional): 使用 OData 语法过滤结果
• expand (string, optional): 内联展开相关资源
• top (integer, optional): 要返回的项目数。最小值：1，最大值：999
• orderby (string, optional): 按指定属性排序结果

microsoft_excel/get_worksheets

说明： 获取 Excel 工作簿中的所有工作表。

参数：

• file_id (string, required): Excel 文件的 ID
• select (string, optional): 选择要返回的特定属性（例如：id,name,position）
• filter (string, optional): 使用 OData 语法过滤结果
• expand (string, optional): 内联展开相关资源
• top (integer, optional): 要返回的项目数。最小值：1，最大值：999
• orderby (string, optional): 按指定属性排序结果

microsoft_excel/create_worksheet

说明： 在 Excel 工作簿中创建一个新的工作表。

参数：

• file_id (string, required): Excel 文件的 ID
• name (string, required): 新工作表名称

microsoft_excel/get_range_data

说明： 获取 Excel 工作表中指定区域的数据。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• range (string, required): 区域地址（例如：A1:C10）

microsoft_excel/update_range_data

说明： 更新 Excel 工作表中指定区域的数据。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• range (string, required): 区域地址（例如：A1:C10）
• values (array, required): 要写入该区域的二维数组

  [
    ["Name", "Age", "City"],
    ["John", 30, "New York"],
    ["Jane", 25, "Los Angeles"]
  ]

microsoft_excel/add_table

说明： 在 Excel 工作表中创建一个表格。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• range (string, required): 表格区域（例如：A1:D10）
• has_headers (boolean, optional): 第一行是否包含表头。默认值：true

microsoft_excel/get_tables

说明： 获取 Excel 工作表中的所有表格。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称

microsoft_excel/add_table_row

说明： 向 Excel 表格中添加一行。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• table_name (string, required): 表格名称
• values (array, required): 新行的值数组

  ["John Doe", 35, "Manager", "Sales"]

microsoft_excel/get_table_data

说明： 获取 Excel 工作表中指定表格的数据。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• table_name (string, required): 表格名称

microsoft_excel/create_chart

说明： 在 Excel 工作表中创建图表。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• chart_type (string, required): 图表类型（例如：ColumnClustered、Line、Pie）
• source_data (string, required): 图表数据区域（例如：A1:B10）
• series_by (string, optional): 解释数据的方式（Auto、Columns 或 Rows）。默认值：Auto

microsoft_excel/get_cell

说明： 获取 Excel 工作表中单个单元格的值。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• row (integer, required): 行号（从 0 开始）
• column (integer, required): 列号（从 0 开始）

microsoft_excel/get_used_range

说明： 获取 Excel 工作表的已使用区域（包含所有数据）。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称

microsoft_excel/get_used_range_metadata

说明： 获取 Excel 工作表已使用区域的元数据（仅维度，无数据）。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称

microsoft_excel/list_charts

说明： 获取 Excel 工作表中的所有图表。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称

microsoft_excel/delete_worksheet

说明： 从 Excel 工作簿中删除一个工作表。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 要删除的工作表名称

microsoft_excel/delete_table

说明： 从 Excel 工作表中删除一个表格。

参数：

• file_id (string, required): Excel 文件的 ID
• worksheet_name (string, required): 工作表名称
• table_name (string, required): 要删除的表格名称

microsoft_excel/list_names

说明： 获取 Excel 工作簿中的所有命名区域。

参数：

• file_id (string, required): Excel 文件的 ID