用途:为 Domo App Platform 中的 AI 调用提供以工具包为先的规范,统一使用 @domoinc/toolkit 的 AIClient,覆盖文本生成、text-to-sql 与响应解析。
主要能力与用法:安装依赖 yarn add @domoinc/toolkit,导入 import { AIClient } from '@domoinc/toolkit'。AIClient 方法为静态方法,不要实例化,例如应写 await AIClient.text_to_sql('...'),而非 new AIClient()。文本生成使用 AIClient.generate_text,可传入模板、tone 与 temperature 等配置。text_to_sql 的第二个参数必须是 DataSourceSchema 数组,而非单个对象,数组形式支持多表及 join 感知的 SQL 生成。另有 text_to_beastmode 等方法。
响应解析:AIClient 响应结构与其他工具包客户端不同,常使用 response.data,可能同时含 output 与 choices。建议按 data/body 回退解析,并对输出做字符串守卫与空值处理,无可用输出时抛出错误。
限制:text_to_sql 适合临时 SQL,但 /sql/v1 不会自动应用仪表板或页面筛选器;若嵌入卡片需要筛选感知,应改用 Query API(/data/v1,通过 @domoinc/query)执行。签名以已安装工具包的类型定义为准。资料未提供收费、价格与平台支持范围等信息。