@graphysdk/agents-sdk

中文文档
1.9.0-beta.1794847602792发布于 2026/11/17SEE LICENSE IN LICENSE.mdTypeScriptESM + CJS近 30 天下载 1.7万

TypeScript client for the Graphy Agents API

原始使用文档
文档目录7 节
  1. Install
  2. Docs
  3. Datasets
  4. Extract
  5. Agent skills
  6. Licence
  7. Support

@graphysdk/agents-sdk

TypeScript client for the Graphy Agents API.

Learn more at graphy.dev.

Install

npm install @graphysdk/agents-sdk

You need an Agents API key for HTTP calls.

Docs

Datasets

Chart requests accept either inline config.data or a staged datasetRef (graphy://attachments/{uuid}).

Upload a CSV, TSV, or XLSX file with uploadDataset(file), then pass the returned datasetRef to generateGraph, generateGraphStream, and the other graph-generation methods. Do not send both inline data and a datasetRef.

See the Agents docs for size limits.

Extract

See the Agents API docs for route limits and runtime behaviour.

Prefer attachments[] over images[]. Do not send both.

kindPurposeHelper
"image"PNG, JPEG, WebP, GIFbuildImageAttachment
"document"PDFbuildPdfAttachment
"spreadsheet"Excel .xlsxbuildSpreadsheetAttachment

Spreadsheet payloads must be RFC 4648 base64 (no data: prefix) with MIME type application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.

Agent skills

Install the Graphy agent skills from github.com/graphysdk/skills to set up the SDK and author charts from Cursor, Claude Code, and other coding agents.

Licence

This package is available under PolyForm Noncommercial, Small Business, or a 32-day Free Trial. Free Trial is local or internal evaluation only — it does not cover a public page. See what you can do under the trial.

For a commercial licence, talk to us.

Support

Questions and community help: Discord.

版本与发布记录

@graphysdk/agents-sdk 共发布 459 个版本,首次发布于 2026/02/20;过去 12 个月发布了 459 个版本。

版本发布日期距今
1.9.0-beta.1794847602792latest2026/11/17今天
1.9.0-beta.17948408135452026/11/16今天
1.9.0-beta.17948401073962026/11/16今天
1.9.0-beta.17948274193392026/11/16今天
1.9.0-beta.17945866913282026/11/143 天前
1.9.0-beta.17945823311012026/11/133 天前

关于 @graphysdk/agents-sdk 的常见问题

@graphysdk/agents-sdk 是什么?

TypeScript client for the Graphy Agents API

如何安装 @graphysdk/agents-sdk?

在项目目录运行 npm install @graphysdk/agents-sdk,或使用 pnpm add / yarn add / bun add。

@graphysdk/agents-sdk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@graphysdk/agents-sdk 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@graphysdk/agents-sdk 可以商用吗?

@graphysdk/agents-sdk 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@graphysdk/agents-sdk 的下载量有多少?

根据 npm 官方下载统计,@graphysdk/agents-sdk 在 2026/10/17 – 2026/11/15 这 30 天内被下载 16,782 次,日均约 559 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@graphysdk/agents-sdk 还在维护吗?

最新版本 1.9.0-beta.1794847602792 发布于 2026/11/17(今天);至今共发布 459 个版本,其中过去 12 个月发布了 459 个;首次发布于 2026/02/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。