SuperAPI AI 工具集

domo-code-engine

编程与开发

查看项目

更新于 10-16 06:57

技能介绍

用途:本规则用于在 Domo App Platform 中从应用内执行 Code Engine 函数。规则强调 toolkit-first 方式,即通过 CodeEngineClient 调用函数,而非默认使用原始 domo.post 等 endpoint-first 方式;旧的 endpoint-first 指南已归档到 archive/legacy-rules/domo-code-engine.md。

主要能力:使用 CodeEngineClient 执行已定义的 Code Engine 函数。资料给出安装与引入方式:yarn add @domoinc/toolkit,然后 import { CodeEngineClient } from '@domoinc/toolkit';。调用形式为 await CodeEngineClient.execute('calculateTax', { amount: 1000, state: 'CA' }),并通过 response.body.output 获取结果。

使用方式与清单要求:Code Engine 函数仍需在 manifest.json 中配置 packageMapping。资料给出示例:在 packageMapping 数组中定义别名 alias(如 calculateTax),在 parameters 中声明参数别名、类型、是否可空、是否为列表及子级,并声明 output 结构与类型。调用时应使用 CodeEngineClient.execute(),输出解析使用 response.body;同时需要处理错误并将错误呈现到 UI 或日志。

错误处理模式:资料提供了一个 executeFunction 封装示例,在 try 中执行 CodeEngineClient.execute(alias, payload) 并返回 response.body,在 catch 中打印错误信息并重新抛出错误,以便将失败暴露给调用方。

适用场景:面向在 Domo App Platform 中开发应用、需要在应用内调用 Code Engine 函数的场景。

限制与注意事项:资料列出清单——函数别名需在 packageMapping 中定义;默认应使用 CodeEngineClient.execute() 而非原始 domo.post;输出解析应使用 response.body;错误需被处理并反馈到 UI 或日志。此外,资料提到可参考的规范规则文件包括 .cursor/rules/04-toolkit.mdc(toolkit 模式)、.cursor/rules/06-manifest.mdc(manifest 映射细节)、.cursor/rules/09-gotchas.mdc(操作注意事项)。关于具体可用的函数、调用限制、平台版本要求、收费或价格等信息,资料中暂未提供。