Geyser SDK · 0.2.0

Crea app che mettono al lavoro gli Agents

Aggiungi gli Agents al software che il tuo team o i tuoi clienti già usano, così possono esaminare una richiesta, scrivere un brief o suggerire una modifica e restituire un risultato che la tua applicazione sa usare.

“Dimmi il compito, il formato in cui lo vuoi e un limite da rispettare. Ti rimando un risultato che la tua app può usare.”

Otis

Aiuta l’assistenza a venire a capo di un ticket complicato

Aiuta qualcuno del tuo team di assistenza a capire un ticket difficile e a preparare una risposta. L’esempio per l’assistenza ordina i dettagli del ticket che gli passi, chiede a un Agent di approfondire il contesto e controlla le fonti che cita.

La tua app gestisce la connessione con l’help desk e passa i record. L’esempio scrive una bozza, e una persona decide se è giusta e se inviarla.

Prova l’esempio per l’assistenza

Trasforma la ricerca in una scheda che le persone possono usare

Costruisci qualcosa che aiuti un team vendite a prepararsi a una chiamata con un cliente, o che aiuti un ricercatore a mettersi in pari su un argomento. Passa note e documenti e chiedi a un Agent un riepilogo con i riferimenti.

Parti dagli esempi di revisione degli Agents e di verifica delle fonti. Individuano i riferimenti mancanti o inventati, ma ti serve comunque un tuo processo di revisione per controllare i fatti.

Prova i componenti di base per la ricerca

Aggiungi un passaggio di approvazione a uno strumento operativo

Lascia che un Agent proponga una modifica a un record, mostri a una persona che cosa succederà e aspetti la sua decisione. Va bene per gli strumenti interni in cui il personale deve rivedere le modifiche prima che vengano applicate.

Gli esempi dei record approvati girano su un database di prova o su uno spazio di lavoro usa e getta dell’Agent. Coprono l’approvazione e il ripristino da una risposta interrotta. Qualsiasi collegamento a un sistema aziendale reale viene dalla tua app.

Prova un aggiornamento approvato

Crea strumenti sul modo in cui lavora il tuo team

Crea un assistente per le proposte o uno strumento per i passaggi di consegne tra progetti, che segue le istruzioni del tuo team. Raccogli i passaggi e il contesto che gli servono per riutilizzare lo stesso approccio al lavoro successivo.

Un Agent Bundle raccoglie insieme istruzioni, competenze e contesto portabile. Ogni esecuzione segue comunque le autorizzazioni attuali dello spazio di lavoro e chiede una nuova approvazione prima di un’azione importante.

Crea un flusso di lavoro riutilizzabile
Perché costruire su Geyser?

Dedica il tuo tempo all’app mentre Geyser tiene traccia del lavoro

La tua app possiede l’interfaccia e le connessioni con altri servizi. Geyser tiene in un unico posto avanzamento, budget, autorizzazioni, richieste di approvazione e risultato del compito dell’Agent, dentro lo spazio di lavoro del cliente.

Se la connessione si interrompe, puoi ricollegarti allo stesso compito. Puoi anche mostrare il lavoro in attesa di una decisione e ricevere i risultati nel formato che la tua app si aspetta. Questi controlli sono utili quando un lavoro richiede più passaggi o va supervisionato; per una semplice trasformazione di testo può bastare una chiamata diretta al modello o una normale funzione.

Crea un’applicazione con l’SDK
  1. 1
    Dagli un compito

    Passa le informazioni che hai il diritto di usare, il formato che vuoi ricevere e i limiti di tempo e di spesa.

  2. 2
    Avvia il compito

    Riusa lo stesso ID operazione così la tua app può ritrovare il compito se la connessione si interrompe.

  3. 3
    Segui il lavoro

    Leggere l’avanzamento e mostrare alle persone ogni richiesta di approvazione o di aiuto per riprendere un’azione interrotta.

  4. 4
    Usa il risultato

    Recupera il risultato salvato dallo spazio di lavoro del cliente e controllalo prima di usarlo.

Parti da un piccolo esempio funzionante

Avvia il tuo primo strumento sulla tua macchina

Scrivi uno strumento in Python che accetta JSON, eseguilo sugli input di esempio e guarda che cosa produce. La guida rapida esegue il tuo codice vero in un ambiente ristretto, compreso un test che rifiuta gli input non validi, e non ti serve un account.

Per la guida rapida dal sorgente taggato ti serve Python 3.11 o successivo, più un sandbox supportato: sandbox-exec di macOS, oppure bubblewrap su Linux con i user namespace consentiti. Una volta installato, l’handler non usa un modello, l’accesso alla rete né credenziali.

Capisci il contratto delle estensioni
Versione 0.2.0 · esecuzione in locale
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
Autorità e disponibilità, dette chiaramente

Dove girano le cose e quanto costano

Ogni progetto sceglie un Agent, e le sue credenziali sono legate a quel progetto e alla sua Cell cliente attuale. Un pacchetto JSON firmato diventa attivo solo dopo che l’Agent assegnato ne ha verificato i byte esatti e il pacchetto ha superato i test in sandbox.

Le estensioni in puro JSON non possono usare file dell’host, rete, sottoprocessi o credenziali ereditate. Le attività aperte degli Agents usano i modelli e gli strumenti configurati nel tuo spazio di lavoro. L’SDK stesso ha licenza MIT, e l’uso remoto di modelli e calcolo viene fatturato sul tuo account. Durante l’anteprima non promettiamo una quota di calcolo gratuita né uno SLA di disponibilità.

SDK/CLI 0.2.0 è pubblicato su PyPI e GitHub. L’installazione con Homebrew funziona su macOS con Apple Silicon e su Linux AMD64, e gli handler Python locali richiedono anche Python 3.11 o versioni successive. Puoi eseguire in locale già oggi. L’esecuzione remota richiede che Customer Cell e software dell’Agent siano corrispondenti, quindi controlla la pagina Sviluppatori nella console per vedere se è pronta prima di inviare un compito remoto. I bundle mantengono l’autorità esistente così com’è, e i profili dei modelli scelgono un modello già configurato. I fork pubblici di ispezione non eseguono strumenti; rieseguire un’esecuzione è un’operazione a parte.

SDK Python su PyPICLI su PyPIScarica SDK/CLI 0.2.0Leggi le modifiche e le note di migrazione
Inizia

Parti da un compito che la tua app potrebbe semplificare

Scegli un esempio, adattalo al modo di lavorare del tuo team e vedi se ti evita di dover costruire da te la gestione dei compiti. Gli esempi sono punti di partenza per la tua applicazione, e non abbiamo pubblicato risultati di adozione indipendenti.