SuperAPI AI 工具集

twenty-record-presentation

数据与分析

查看项目

更新于 10-16 04:20

技能介绍

用途

Twenty Record Presentation 用于从 Twenty CRM 中检索回答用户问题所需的记录,并将其呈现为有用的答案,而不是原始 API 输出。它始终将技术字段、时间戳、ID 和嵌套结构转换为可读的摘要,帮助用户浏览、比较和操作数据。

主要能力

  • 通过已连接的 Twenty MCP 服务器发现相关对象、字段、过滤器和排序选项,而不是猜测确切的 API 名称。
  • 仅检索回答所需的字段,以及用于排序或消歧的字段。
  • 对于“最新”“最近”等请求,包含用于排序的相关时间戳字段。
  • 对于宽泛列表,应用实际限制并说明显示了记录数量。
  • 将原始字段名转换为面向用户的标签,例如 createdAt → Created、updatedAt → Last updated。
  • 按含义格式化值:空值显示为 Not set,布尔值显示 Yes/No,金额包含货币和分组,URL 和电子邮件可点击,ID 和 UUID 默认隐藏。
  • 将 ISO/RFC3339 时间戳、Unix 秒和毫秒解析并转换为用户时区(已知时),保留仅日期值不跨时区偏移。
  • 生成记录链接,使用 Twenty 展示页路径 /object/:objectNameSingular/:objectRecordId,优先链接记录显示名称而非原始 ID 列。
  • 根据记录数量选择呈现形式:单条记录用标签块,2 至 10 条可比较记录用 Markdown 表格,更大数据集显示最相关行并提及总数。
  • 表格对齐有明确规范:文本列左对齐,数值金额/计数列右对齐,短状态列仅在确实改善浏览时居中。

使用方式

使用选定的已连接 Twenty MCP 服务器(当可用时),遵循 learn_tools → execute_tool 的工作流。如果缺少必要上下文且无法从工具中发现,提出一个简洁的澄清问题。如果没有可用的 Twenty MCP 工具,说明当前线程中没有可调用的 Twenty MCP 服务器,并请用户连接或暴露预期的工作区。

适用场景

  • 查询 Twenty CRM 中的单条记录并获取可读摘要。
  • 比较 2 至 10 条记录,例如机会、人员或公司。
  • 获取“最新”“最近”记录列表,并按时间排序展示。
  • 跨工作区比较记录,优先使用包含 Workspace 列的合并表格。
  • 需要将记录链接回其原始 Twenty 上下文。

限制

  • 需要已连接的 Twenty MCP 服务器;没有可用服务器时无法检索记录。
  • 仅当用户要求调试、导出、精确 API 负载、模式检查或可复现命令时,才显示原始 JSON、原始时间戳、内部 ID 或完整嵌套对象。
  • 如果工作区来源未知,不编造主机名;添加紧凑的 Record 列包含对象名和记录 ID,或说明直接链接需要工作区 URL。
  • 时区未知时,保留源时区或仅在影响含义时询问。
  • 日期显示包含年份,除非在同年小表格中确实冗余;秒和毫秒仅在调试、审计日志或排序近乎相同时间的事件时显示。