SDK Geyser · 0.3.4

Créez des applications qui mettent les Agents au travail

Intégrez des Agents aux logiciels que votre équipe ou vos clients utilisent déjà. Ils peuvent examiner une demande, rédiger un brief ou proposer une modification, puis renvoyer un résultat exploitable par votre application.

« Donnez-moi la tâche, le format de retour souhaité et une limite à respecter. Je vous renverrai un résultat exploitable par votre application. »

Otis

Aider le support à creuser un ticket épineux

Aidez un membre de votre équipe support à y voir clair dans un ticket difficile et à rédiger une réponse. L’exemple support trie les détails du ticket que vous transmettez, demande à un Agent d’en étudier le contexte, puis vérifie les sources que l’Agent cite.

Votre application gère la connexion au service d’assistance et transmet les dossiers. L’exemple rédige un brouillon, et une personne décide s’il est juste et s’il faut l’envoyer.

Essayer l’exemple d’assistance client

Transformer une recherche en note de synthèse exploitable

Créez un outil qui aide une équipe commerciale à préparer un appel client, ou un chercheur à se mettre à niveau sur un sujet. Transmettez les notes et les documents, et demandez à un Agent une synthèse avec ses références.

Commencez par les exemples de relecture par un Agent et de vérification des sources. Ils repèrent les références manquantes ou inventées, mais vous voudrez toujours votre propre relecture pour vérifier les faits.

Essayer les briques de recherche

Ajouter une étape d’approbation à un outil opérationnel

Laissez un Agent proposer une modification d’un enregistrement, montrer à une personne ce qui va se passer et attendre sa décision. C’est idéal pour les outils internes où le personnel examine les modifications avant qu’elles ne soient appliquées.

Les exemples d’enregistrements approuvés s’exécutent sur une base de données de test ou un espace de travail d’Agent jetable, et couvrent l’approbation et la reprise après une réponse interrompue. Toute connexion à un vrai système métier vient de votre application.

Essayer une mise à jour approuvée

Créez des outils adaptés à la façon dont travaille votre équipe

Créez un assistant de propositions commerciales ou un outil de passation de projet qui suit les consignes de votre équipe. Regroupez les étapes et le contexte dont il a besoin, et vous pourrez réutiliser la méthode sur la mission suivante.

Un Agent Bundle réunit des instructions, des compétences et un contexte portable. Chaque exécution suit toujours les permissions de l’espace de travail telles qu’elles sont à ce moment-là, et redemande une approbation avant toute action importante.

Empaqueter un processus réutilisable
Pourquoi développer sur Geyser ?

Consacrez votre temps à l’application pendant que Geyser suit le travail

Votre application gère l’interface et ses connexions aux autres services. Geyser suit la tâche de l’Agent en un seul endroit, dans l’espace de travail du client : avancement, budget, permissions, demandes d’approbation et résultat.

Si la connexion est coupée, vous retrouvez la même tâche. Vous pouvez montrer à d’autres un travail qui attend une décision, et récupérer les résultats dans le format attendu par votre application. Tout cela devient utile quand une tâche comporte plusieurs étapes ou demande une supervision. Pour une simple transformation de texte, un appel direct au modèle ou une fonction ordinaire peut suffire.

Créer une application avec le SDK
  1. 1
    Confiez-lui une tâche

    Transmettez les informations que vous avez le droit d’utiliser, le format de réponse souhaité et des limites de temps et de dépenses.

  2. 2
    Lancer la tâche

    Réutilisez le même identifiant d’opération pour que votre application retrouve la tâche si la connexion est coupée.

  3. 3
    Suivre le travail

    Suivre l’avancement, et présenter aux personnes toute demande d’accord ou d’aide pour reprendre une action interrompue.

  4. 4
    Utiliser le résultat

    Récupérez le résultat enregistré dans l’espace de travail du client, et vérifiez-le avant de l’utiliser.

Commencez par un petit exemple qui fonctionne

Lancez votre premier outil sur votre propre machine

Écrivez un outil Python qui prend du JSON, exécutez-le sur les entrées d’exemple et regardez ce qui en sort. Le guide de démarrage rapide exécute votre vrai code dans un environnement restreint, avec un test qui rejette les entrées invalides, et vous n’avez pas besoin de compte pour l’essayer.

Le guide de démarrage rapide depuis les sources taguées demande Python 3.11 ou plus récent et un bac à sable pris en charge, c’est-à-dire sandbox-exec sur macOS ou bubblewrap sur Linux avec les espaces de noms utilisateur autorisés. Une fois l’installation faite, le handler n’utilise ni modèle, ni accès réseau, ni identifiants.

Comprendre le contrat d’extension
Version taguée 0.3.4 · exécution locale
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
Les droits et la disponibilité, dits clairement

Où tout tourne, et ce que ça coûte

Chaque projet passe par un Agent que vous choisissez. Les clés du projet ne fonctionnent que pour ce projet et uniquement là où sont actuellement conservées les données de son espace de travail. Un package JSON signé n’est mis en service qu’une fois que cet Agent l’a vérifié octet par octet et qu’il a réussi ses tests dans un bac à sable.

Une extension en pur JSON ne peut toucher ni aux fichiers de l’ordinateur, ni au réseau, ni aux autres processus, ni aux identifiants dont elle pourrait hériter. Les tâches d’Agent que vous envoyez via le SDK ou la CLI utilisent les modèles et les outils configurés dans votre espace de travail. Le SDK lui-même est sous licence MIT, et l’utilisation des modèles et du calcul distants est facturée sur votre compte. Pendant la préversion, il n’y a ni quota de calcul gratuit ni SLA de disponibilité.

Le SDK/CLI 0.3.4 est disponible sur PyPI et GitHub. Homebrew l’installe sur les Mac Apple silicon et sous Linux AMD64, et les gestionnaires Python locaux demandent aussi Python 3.11 ou plus récent. L’exécution en local fonctionne dès aujourd’hui. Exécuter une tâche à distance suppose que le logiciel de l’espace de travail et celui de l’Agent soient à des versions compatibles : consultez la page Developers de la console avant d’en envoyer une. Un bundle n’élargit pas ce qu’un Agent a déjà le droit de faire, et un profil de modèle choisit parmi des modèles déjà configurés. Les forks d’inspection publics n’exécutent pas d’outils, et rejouer une exécution est une opération distincte.

SDK Python sur PyPICLI sur PyPITélécharger le SDK/CLI 0.3.4Lire les changements et les notes de migration
Se lancer

Commencez par une tâche que votre application pourrait faciliter

Choisissez un exemple, adaptez-le à la façon dont travaille votre équipe, et voyez s’il vous évite de développer vous-même la gestion des tâches. Chaque exemple est un point de départ pour votre propre application.