OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add stahura/domo-ai-vibe-rules --skill ai-service-layer
Toolkit-first AIClient patterns for generation, text-to-sql, and response parsing.
npx skills add stahura/domo-ai-vibe-rules --skill ai-service-layer
This rule is toolkit-first. Use AIClient from @domoinc/toolkit.
Do not instantiate AIClient for these methods.
Wrong:
Correct:
text_to_sql schema argument must be an arrayWrong:
Correct:
(Approximate; check installed toolkit typings for exact current signature.)
Why array: this supports multi-table SQL generation (including join-aware SQL) when multiple schemas are provided.
text_to_sql is great for ad-hoc SQL, but /sql/v1 does not automatically apply dashboard/page filters.
If filter-awareness is required in embedded cards, use Query API (/data/v1 via @domoinc/query) for execution.
AIClient responses are not always shaped like other toolkit clients:
response.dataoutput and choicesUse defensive parsing plus a strict string guard:
AIClient methods use snake_case (generate_text, text_to_sql, etc.)AIClient methods are called statically (for example AIClient.text_to_sql(...), not instance methods)AIClient.text_to_sql second argument is DataSourceSchema[] (array), not a single objectdata/body fallbackawait AIClient.text_to_sql('...');const response = await AIClient.generate_text(
'Explain this sales trend in simple terms',
{ template: 'You are a business analyst. ${input}' },
{ tone: 'professional' },
undefined,
{ temperature: 0.7 }
);
const body = response.data || response.body || response;
const text = body.output || body.choices?.[0]?.output;await AIClient.text_to_sql('Show top vendors by spend', {
dataSourceName: 'vendorPayments',
columns: [{ name: 'amount', type: 'number' }]
});await AIClient.text_to_sql('Show top vendors by spend', [
{
dataSourceName: 'vendorPayments',
description: 'Vendor payment invoices',
columns: [
{ name: 'vendor', type: 'string' },
{ name: 'amount', type: 'number' },
{ name: 'date', type: 'date' }
]
}
]);AIClient.text_to_sql(
input: string,
dataSourceSchemas?: DataSourceSchema[], // array
promptTemplate?: any,
parameters?: Record<string, string>,
model?: string,
modelConfiguration?: Record<string, Object>
): Promise<Response<TextAIResponse>>;const sqlResult = await AIClient.text_to_sql('Show total sales by region', [
{
dataSourceName: 'Sales',
description: 'Sales transactions',
columns: [{ name: 'region', type: 'string' }, { name: 'amount', type: 'number' }]
}
]);
const beastModeResult = await AIClient.text_to_beastmode(
'Calculate year over year growth percentage',
{ dataSourceName: 'Revenue', columns: [{ name: 'revenue', type: 'number' }, { name: 'date', type: 'date' }] }
);const body = response?.data ?? response?.body ?? response;
const outputCandidate = body?.output ?? body?.choices?.[0]?.output;
const output = typeof outputCandidate === 'string' ? outputCandidate.trim() : '';
if (!output) throw new Error('AI returned no usable output');