IaGenify SDK Alpha: ein Client, überall dort, wo Ihr Code läuft.

Das IaGenify SDK begann als dünne HTTP-Schicht um unsere API. In der Alpha ist es zu dem Werkzeug geworden, mit dem wir selbst bauen: ein JavaScript-Client für Node.js, Browser und Cloudflare Workers, der Authentifizierung, Sitzungen und Abrechnungsschutz hinter einer kleinen objektorientierten Oberfläche verbirgt.

Dies ist kein Referenzhandbuch, sondern ein Rundgang durch unsere Ideen, die tatsächliche Syntax und die Richtung des SDK.

Ein Client, überall dort, wo Ihr Code läuft

Der Client erkennt beim Start seine Laufzeit und verwaltet Authentifizierung, Sitzungen und Abrechnungsgrenzen, damit die Anwendung sich auf ihre Aufgabe konzentriert.

import { IaGenify } from "iagenify";

const api = new IaGenify({
  apiKey: process.env.IAGENIFY_API_KEY,
  appName: "release-notes-bot",
});

Unter Node.js liegt die Sitzung in einer privaten Datei unter ~/.iagenify/, im Browser in localStorage und am Edge im Speicher. Der API-Schlüssel wird gegen ein kurzlebiges, still erneuertes Token getauscht. Node-spezifische Module werden verzögert geladen, damit webpack-, Vite- und Gatsby-Builds funktionieren.

Assistenten sind Sitzungen, keine Prompts

Statt für jeden Aufruf einen Prompt neu zu bauen, erstellen Sie einmal eine Sitzung mit Modell, Rolle, Anweisungen, optionalem JSON Schema und Gedächtnis. generate() arbeitet danach mit typisierten Ein- und Ausgaben für Text, Bilder, Audio, Video und Dokumente.

const assistant = await api.models.create({ model: "gemini-3.5-flash", settings: { role: "Senior release engineer", instructions: "Answer in three short bullet points." }, schema: { type: "object", properties: { summary: { type: "string" } } }, memory: true });
const first = await assistant.generate({ inputs: [{ type: "text", content: "Summarise the changes shipped in v2.4.0." }] });
const followUp = await assistant.generate({ inputs: [{ type: "text", content: "Which risk should we fix first?" }] });

Der Server veröffentlicht seinen Preiskatalog; api.catalogue() liest ihn. Anwendungen können Kosten anzeigen, ohne eine veraltende Preistabelle zu kopieren.

Ein Agent mit sichtbarem Budget

Agentenarbeit darf nicht zu offenen Kosten führen. Jeder Lauf trägt das festgelegte Budget und eine Spur der Werkzeuge, Entscheidungen und Ergebnisse.

Ein Agent verbindet Modellsitzungen mit Websuche, Seitenabruf, Screenshots, Dokumentumwandlung und Medienerzeugung. maxSteps begrenzt die Schleife, budget die Credits. Vor jedem Werkzeug wird anhand gemessener Produktionskosten geprüft.

const agent = api.agents.create({ model: { main, image }, tools: { search: api.tools.search, openPage: api.tools.fetch, createImage: api.tools.image }, maxSteps: 8, budget: 100 });
const result = await agent.run({ inputs: [{ type: "text", content: "Find the latest Node.js LTS release and draw a cover image for it." }] });

Fehler behalten auch in einem gestreamten Lauf ihren Typ; instanceof NotEnoughCredits funktioniert bei einfachen Aufrufen und langen Agentenläufen gleich.

Strukturierte Ausgabe ist der Normalfall

Anwendungen benötigen verlässliche Daten statt nachträglich zu zerlegender Absätze. Strukturierte Ergebnisse und typisierte Fehler sind im Browser, Worker und Server der normale Weg.

Dies ist eine Alpha. Die Oberfläche bleibt bewusst klein, während wir aus echten Anwendungen lernen und die dauerhaften Teile stabilisieren.

Das SDK ist der Beginn der Entwicklererfahrung. Dokumentation und Entwicklerseite wachsen um die Teile, die sich bewähren.

Was als Nächstes kommt

Eine Alpha verspricht eine Richtung, keine Termine: Framework-Integrationen, Live-Rückmeldungen, Speicher als Agentengedächtnis und eigene Modelle über denselben models.create()-Aufruf.

Die Alpha wird mit Early-Access-Teams geteilt, während sich die API stabilisiert; Namen können sich ändern. Kontaktieren Sie uns und verfolgen Sie die IaGenify-Dokumentation.