> 功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

Expanso csv-to-json

专业版增值服务

典型场景

不适用于：需要人工判断的复杂决策场景

输入定义

输出说明

{
  "success": true,
  "data": {
    "final_result": {
      "json_result": "json_result_value",
      "json_metadata": "json_metadata_value",
      "json_status": "json_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/expanso-csv-to-json_template

环境要求

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力边界

• 需要API Key，无Key环境无法使用

创新特色

效率提升量化分析

差异化对比

核心痛点解决

常见问题FAQ

Q1: 如何在Expanso中调用CSV转JSON工具？

A: 在Expanso的AI Agent对话中，输入相应的命令或函数调用，提供必要的CSV文件和配置参数即可。

Q2: CSV转JSON工具支持哪些格式的CSV文件？

A: CSV转JSON工具支持标准的CSV文件格式，包括逗号分隔、制表符分隔等。

Q3: CSV转JSON工具如何处理错误数据？

A: CSV转JSON工具会自动检测错误数据，并提供错误报告，用户可以选择忽略错误数据或进行修正。

Q4: CSV转JSON工具是否支持批量转换？

A: 是的，CSV转JSON工具支持批量转换，可以将多个CSV文件一次性转换为JSON格式。

Q5: CSV转JSON工具是否支持自定义转换规则？

A: 目前CSV转JSON工具提供基本的转换规则，未来版本将支持用户自定义转换规则。

安全指导原则

1. 确保CSV文件来源安全可靠，避免传输和存储过程中泄露敏感信息。
2. 对转换后的JSON数据进行加密存储，防止数据泄露。
3. 定期更新CSV转JSON工具，以修复已知的安全漏洞。
4. 限制工具的访问权限，仅授权给需要使用的人员。
5. 对转换过程中的异常数据进行记录和监控，以便及时发现问题。

安全风险防范

异常恢复指南

针对"CSV转JSON工具"使用中可能遇到的常见问题,提供以下排查方案:

"CSV转JSON工具"通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

快速熟悉

1. 配置API密钥: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪