Geyser SDK · 0.2.0

Apps bauen, die Agents an die Arbeit bringen

Bringen Sie Agents in die Software, die Ihr Team oder Ihre Kunden bereits nutzen, damit sie einer Anfrage nachgehen, ein Briefing verfassen oder eine Änderung vorschlagen und ein Ergebnis zurückschicken können, mit dem Ihre Anwendung weiterarbeiten kann.

Mit dem Bauen beginnen Den Quellcode erkunden

„Nennen Sie mir die Aufgabe, das gewünschte Rückgabeformat und ein Limit, an das ich mich halten soll. Ich schicke Ihnen ein Ergebnis zurück, das Ihre App nutzen kann.“

Otis

Dem Support bei einem kniffligen Ticket helfen

Helfen Sie jemandem in Ihrem Support-Team, ein schwieriges Ticket zu verstehen und eine Antwort zu entwerfen. Das Support-Beispiel sortiert die Ticketdetails, die Sie übergeben, bittet einen Agent, den Hintergrund zu recherchieren, und prüft die Quellen, die er nennt.

Ihre App übernimmt die Verbindung zum Helpdesk und reicht die Datensätze weiter. Das Beispiel schreibt einen Entwurf, und ein Mensch entscheidet, ob er stimmt und ob er gesendet wird.

Das Support-Beispiel ausprobieren

Aus Recherche eine Übersicht machen, die Menschen nutzen können

Bauen Sie etwas, das einem Vertriebsteam bei der Vorbereitung eines Kundengesprächs hilft oder einer Forscherin beim Einarbeiten in ein Thema. Übergeben Sie die Notizen und Dokumente und bitten Sie einen Agent um eine Zusammenfassung mit Quellenangaben.

Beginnen Sie mit den Beispielen zur Agent-Prüfung und Quellenkontrolle. Sie finden fehlende oder erfundene Verweise, aber die Fakten müssen Sie weiterhin mit Ihrem eigenen Prüfverfahren kontrollieren.

Die Recherche-Bausteine ausprobieren

Einen Genehmigungsschritt in ein Betriebstool einbauen

Lassen Sie einen Agent eine Änderung an einem Datensatz vorschlagen, einer Person zeigen, was passieren wird, und auf deren Entscheidung warten. Das passt zu internen Tools, in denen Mitarbeitende Änderungen prüfen müssen, bevor sie durchgehen.

Die Beispiele mit freigegebenen Datensätzen laufen gegen eine Beispieldatenbank oder einen Wegwerf-Arbeitsbereich für Agents. Sie decken die Genehmigung und die Wiederaufnahme nach einer unterbrochenen Antwort ab. Jede Verbindung zu einem echten Geschäftssystem kommt von Ihrer App.

Ein genehmigtes Update ausprobieren

Bauen Sie Tools passend zur Arbeitsweise Ihres Teams

Bauen Sie einen Angebotsassistenten oder ein Übergabe-Tool für Projekte, das den Anweisungen Ihres Teams folgt. Packen Sie die nötigen Schritte und den Hintergrund zusammen, damit Sie den Ansatz beim nächsten Auftrag wiederverwenden können.

Ein Agent Bundle bündelt Anweisungen, Fähigkeiten und portablen Kontext. Jede Ausführung folgt weiterhin den aktuellen Berechtigungen des Arbeitsbereichs und bittet vor einer folgenreichen Aktion erneut um Genehmigung.

Einen wiederverwendbaren Ablauf bündeln

Warum auf Geyser aufbauen?

Widmen Sie sich der App, während Geyser die Arbeit im Blick behält

Ihre App besitzt die Oberfläche und ihre Verbindungen zu anderen Diensten. Geyser hält Fortschritt, Budget, Berechtigungen, Genehmigungsanfragen und Ergebnis der Agent-Aufgabe an einem Ort, im Arbeitsbereich des Kunden.

Wenn die Verbindung abbricht, können Sie sich wieder mit derselben Aufgabe verbinden. Sie können außerdem Arbeit anzeigen, die auf eine Entscheidung wartet, und Ergebnisse in dem Format zurückbekommen, das Ihre App erwartet. Diese Funktionen lohnen sich, wenn ein Auftrag mehrere Schritte hat oder Aufsicht braucht; für eine einfache Textumwandlung reicht vielleicht ein direkter Modellaufruf oder eine gewöhnliche Funktion.

Eine Anwendung mit dem SDK bauen

1
Geben Sie ihm eine Aufgabe
Übergeben Sie Informationen, die Sie nutzen dürfen, das gewünschte Rückgabeformat und Grenzen für Zeit und Ausgaben.
2
Die Aufgabe starten
Verwenden Sie dieselbe Vorgangs-ID, damit Ihre App die Aufgabe wiederfindet, falls die Verbindung abbricht.
3
Der Arbeit folgen
Den Fortschritt lesen und Menschen jede Bitte um Genehmigung oder um Hilfe bei der Wiederaufnahme einer unterbrochenen Aktion zeigen.
4
Das Ergebnis nutzen
Holen Sie das gespeicherte Ergebnis aus dem Arbeitsbereich des Kunden und prüfen Sie es, bevor Sie es verwenden.

Beginnen Sie mit einem kleinen funktionierenden Beispiel

Ihr erstes Tool auf Ihrem eigenen Rechner ausführen

Schreiben Sie ein Python-Tool, das JSON entgegennimmt, führen Sie es mit den Beispieleingaben aus und sehen Sie sich an, was herauskommt. Der Schnellstart führt Ihren echten Code in einer eingeschränkten Umgebung aus, einschließlich eines Tests, der ungültige Eingaben ablehnt, und Sie brauchen kein Konto.

Sie brauchen Python 3.11 oder neuer für den Schnellstart aus dem getaggten Quellcode sowie eine unterstützte Sandbox: macOS sandbox-exec oder Linux bubblewrap mit erlaubten User-Namespaces. Nach der Installation nutzt der Handler weder ein Modell noch Netzwerkzugriff oder Zugangsdaten.

Den Erweiterungsvertrag verstehen

Getaggte Version 0.2.0 · lokale Ausführung

git clone --branch v0.2.0 --depth 1 https://github.com/geyserlabs/geyser-open.git
cd geyser-open
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ./sdk/python -e ./cli
geyser init tool word-count
geyser test word-count
geyser --json dev word-count

Befugnisse und Verfügbarkeit, klar benannt

Wo die Dinge laufen und was sie kosten

Jedes Projekt wählt einen Agent aus, und seine Zugangsdaten sind an dieses Projekt und seine aktuelle Customer Cell gebunden. Ein signiertes JSON-Paket wird erst aktiv, nachdem der zugewiesene Agent die exakten Bytes verifiziert hat und das Paket seine Sandbox-Tests bestanden hat.

Reine JSON-Erweiterungen können keine Host-Dateien, kein Netzwerk, keine Unterprozesse und keine geerbten Zugangsdaten nutzen. Offene Agent-Aufgaben nutzen die Modelle und Tools, die in Ihrem Arbeitsbereich konfiguriert sind. Das SDK selbst steht unter der MIT-Lizenz, und die Nutzung von Remote-Modellen und -Rechenleistung wird über Ihr Konto abgerechnet. Während der Vorschau versprechen wir weder ein kostenloses Rechenkontingent noch ein Verfügbarkeits-SLA.

Ein Projekt einrichten

Einrichtung in der Console, Zugangsdaten mit begrenztem Umfang und die ausgestellte API-URL

Kosten und Limits

Budgets, Anfragelimits, Aufbewahrung und Support

Verfügbarkeit

Veröffentlichte Pakete, erforderliche Upgrades der Laufzeitumgebung und unterstützte Funktionen

Datenverwahrung

Kundenspeicher, Agent-Rechenleistung und Klartext-Relay-Transit

API-Vertrag

Generierte OpenAPI, typisierte Schemas und bedingte Entscheidungen

Sicherheit

Vertrauen in Herausgeber, Widerruf und private Meldung von Sicherheitslücken

SDK/CLI 0.2.0 ist auf PyPI und GitHub veröffentlicht. Die Homebrew-Installation funktioniert auf macOS mit Apple Silicon und auf Linux mit AMD64, und lokale Python-Handler brauchen außerdem Python 3.11 oder neuer. Lokal können Sie heute schon loslegen. Die Remote-Ausführung braucht zueinander passende Kunden-Cell- und Agent-Software. Prüfen Sie also auf der Entwickler-Seite in der Konsole, ob sie bereit ist, bevor Sie eine Remote-Aufgabe senden. Bundles behalten bestehende Berechtigungen bei, und Modellprofile wählen ein Modell, das bereits konfiguriert ist. Öffentliche Inspektions-Forks führen keine Tools aus; das erneute Abspielen einer Ausführung ist ein eigener Vorgang.

Python SDK auf PyPI CLI auf PyPI SDK/CLI 0.2.0 herunterladen Änderungen und Migrationshinweise lesen

Loslegen

Beginnen Sie mit einer Aufgabe, die Ihre App erleichtern könnte

Wählen Sie ein Beispiel, passen Sie es an die Arbeitsweise Ihres Teams an und sehen Sie, ob es Ihnen erspart, die Aufgabenverwaltung selbst zu bauen. Die Beispiele sind Ausgangspunkte für Ihre Anwendung, und wir haben keine unabhängigen Ergebnisse zur Verbreitung veröffentlicht.

Schnellstart ausführen Einen Ablauf ausprobieren und Feedback geben