Skip to main content
AI Agents is currently in alpha. APIs may change.
Graphy AI Agents create, transform, and analyze charts using natural language. Most agents take a GraphConfig and a prompt and return an updated GraphConfig ready to render.

​
Architecture

Agents are stateless. Each request contains the full context needed to process it—no sessions, no conversation history. This design simplifies integration:
  • No session management or cleanup
  • Requests are idempotent and cacheable
  • Easy to retry on failure
  • Works with any architecture (serverless, edge, traditional)

​
Available Agents

AgentEndpointSDK MethodDescription
Chart MakerPOST /api/v0/generategenerateGraph()Modify chart type, styling, and data transformations
SuggestionsPOST /api/v0/suggestionsgenerateSuggestions()Suggest chart types and data preparations
MutationPOST /api/v0/mutategenerateMutation()Transform the dataset — filter, group, derive, sort
AnnotationPOST /api/v0/annotategenerateAnnotations()Add highlights, tooltips, and other annotations
NarrativePOST /api/v0/narrategenerateNarrative()Write the chart title, subtitle, and caption
ExtractPOST /api/v0/extractextractFromProse()Build a dataset from text, images, PDFs, or spreadsheets

​
Prerequisites

​
Integration Options

TypeScript SDK — Full-featured client with streaming, retries, and type validation. 
import { GraphyAiSdk } from '@graphysdk/agents-sdk';

const ai = new GraphyAiSdk({
  apiKey: 'your-api-key',
  baseUrl: 'https://agents.graphy.dev',
});

const result = await ai.generateGraph({
  config: myGraphConfig,
  userPrompt: 'Change to a stacked bar chart',
});
REST API — Direct HTTP integration for any language. Returns Server-Sent Events for streaming progress. 
curl -N https://agents.graphy.dev/api/v0/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"config": {...}, "userPrompt": "Add a trend line"}'

​
Next Steps

Quickstart

First working call in 5 minutes

TypeScript SDK

Install and configure the SDK

REST API

Direct HTTP integration

Type Reference

Complete type definitions