Geyser SDK · 0.3.4

Apps bauen, die Agents an die Arbeit bringen

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

„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 dann die Quellen, die der Agent 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, die Fakten sollten Sie aber trotzdem selbst prüfen.

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, bevor sie durchgehen.

Die Beispiele mit freigegebenen Datensätzen laufen gegen eine Beispieldatenbank oder einen Wegwerf-Arbeitsbereich für Agents und 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 Schritte und den nötigen Hintergrund zusammen, und Sie können den Ansatz beim nächsten Auftrag wiederverwenden.

Ein Agent Bundle hält Anweisungen, Fähigkeiten und portablen Kontext zusammen. Jede Ausführung folgt trotzdem den Berechtigungen des Arbeitsbereichs, wie sie in diesem Moment gelten, und bittet vor allem Folgenreichen 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 behält die Aufgabe des Agents an einem Ort im Arbeitsbereich des Kunden im Blick, einschließlich Fortschritt, Budget, Berechtigungen, Genehmigungsanfragen und Ergebnis.

Wenn die Verbindung abbricht, verbinden Sie sich wieder mit derselben Aufgabe. Sie können Arbeit zeigen, die auf eine Entscheidung wartet, und Ergebnisse in dem Format zurückbekommen, das Ihre App erwartet. All das lohnt 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, zusammen mit einem Test, der ungültige Eingaben ablehnt, und zum Ausprobieren brauchen Sie kein Konto.

Der Schnellstart aus dem getaggten Quellcode braucht Python 3.11 oder neuer und eine unterstützte Sandbox, also 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.3.4 · lokale Ausführung
git clone --branch v0.3.4 --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 arbeitet über einen Agent, den Sie auswählen. Die Schlüssel des Projekts gelten nur für dieses Projekt und nur dort, wo die Daten seines Arbeitsbereichs gerade liegen. Ein signiertes JSON-Paket wird erst aktiv, nachdem dieser Agent es Byte für Byte geprüft hat und es seine Tests in einer Sandbox bestanden hat.

Eine reine JSON-Erweiterung kann weder auf die Dateien des Computers noch auf das Netzwerk, andere Prozesse oder Zugangsdaten zugreifen, die sie erben könnte. Agent-Aufgaben, die Sie über das SDK oder die CLI senden, nutzen die Modelle und Tools, die in Ihrem Arbeitsbereich eingerichtet sind. Das SDK selbst steht unter der MIT-Lizenz, und die Nutzung entfernter Modelle und Rechenleistung wird über Ihr Konto abgerechnet. Während der Vorschau gibt es kein kostenloses Rechenkontingent und kein Verfügbarkeits-SLA.

SDK/CLI 0.3.4 ist auf PyPI und GitHub erschienen. Homebrew installiert es auf Macs mit Apple Silicon und auf AMD64-Linux, und lokale Python-Handler brauchen außerdem Python 3.11 oder neuer. Lokal ausführen können Sie schon heute. Eine Aufgabe aus der Ferne auszuführen setzt voraus, dass die Software von Arbeitsbereich und Agent zueinander passt. Prüfen Sie also auf der Entwickler-Seite in der Konsole, bevor Sie eine senden. Ein Bundle erweitert nicht, was ein Agent ohnehin schon darf, und ein Modellprofil wählt aus Modellen, die bereits eingerichtet sind. Öffentliche Inspektions-Forks führen keine Tools aus, und das erneute Abspielen einer Ausführung ist ein eigener Vorgang.

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. Jedes Beispiel ist ein Ausgangspunkt für Ihre eigene Anwendung.