Examples

List available semantic functions related to revenue

list_semantic_functions({ search: "revenue" })

get_function_schema({ function_name: "_REVENUE_BY_PRODUCT" })

ask_a_single_question({ question: "Show me customer churn by region for Q4 2024" })

create_semantic_function({
  source_inquiry_id: "inquiry_abc123",
  function_name: "_CHURN_BY_REGION",
  description: "Customer churn breakdown by region",
  parameterize: ["region", "date_range"]
})

Create a React dashboard showing revenue by product over time using
_REVENUE_BY_PRODUCT. Include a date range selector, a bar chart, and a
table view. Use the @jedify/sdk and handle loading and error states.

npm install @jedify/sdk

# .env.local
JEDIFY_API_KEY=your-api-key
JEDIFY_BASE_URL=your-base-url

import { Jedify } from '@jedify/sdk';
import { useState, useEffect } from 'react';

const jedify = new Jedify({
  apiKey: process.env.JEDIFY_API_KEY!,
  baseUrl: process.env.JEDIFY_BASE_URL,
});

function TotalRevenue({ dateRange }) {
  const [revenue, setRevenue] = useState<number | null>(null);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState<string | null>(null);

  useEffect(() => {
    async function load() {
      try {
        const data = await jedify.call('_TOTAL_REVENUE', {
          start_date: dateRange.start,
          end_date: dateRange.end,
        });
        setRevenue(data[0].TOTAL_REVENUE); // UPPERCASE field
      } catch (err) {
        setError((err as Error).message);
      } finally {
        setLoading(false);
      }
    }
    load();
  }, [dateRange]);

  if (loading) return <Spinner />;
  if (error) return <ErrorMessage error={error} />;
  return <MetricCard title="Total Revenue" value={revenue} format="currency" />;
}

import { Jedify } from '@jedify/sdk';
import { useState, useEffect } from 'react';
import { BarChart, Bar, XAxis, YAxis } from 'recharts';

const jedify = new Jedify({
  apiKey: process.env.JEDIFY_API_KEY!,
  baseUrl: process.env.JEDIFY_BASE_URL,
});

function RevenueDashboard({ filters }) {
  const [byProduct, setByProduct] = useState([]);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    async function loadAll() {
      try {
        const [productData] = await Promise.all([
          jedify.call('_REVENUE_BY_PRODUCT', {
            start_date: filters.startDate,
            end_date: filters.endDate,
            region: filters.region,
          }),
        ]);
        setByProduct(productData);
      } catch (err) {
        console.error('Failed to load dashboard data:', err);
      } finally {
        setLoading(false);
      }
    }
    loadAll();
  }, [filters]);

  if (loading) return <Spinner />;

  return (
    <BarChart data={byProduct} width={600} height={300}>
      <XAxis dataKey="PRODUCT_CATEGORY" />
      <YAxis />
      <Bar dataKey="TOTAL_REVENUE" fill="#6E6DF2" />
    </BarChart>
  );
}