SDK Geyser · 0.2.0

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, et renvoyer un résultat exploitable par votre application.

Commencer à construire Explorer le code source

« 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 à comprendre 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 et vérifie les sources qu’il 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 il vous faudra toujours votre propre processus de 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 adapté aux outils internes où le personnel doit examiner 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. Ils 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 pour pouvoir réutiliser la méthode sur la mission suivante.

Un Agent Bundle regroupe des instructions, des compétences et un contexte portable. Chaque exécution suit toujours les permissions actuelles de l’espace de travail 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 conserve au même endroit l’avancement de la tâche de l’Agent, son budget, ses autorisations, ses demandes d’approbation et son résultat, dans l’espace de travail du client.

Si la connexion est coupée, vous pouvez vous reconnecter à la même tâche. Vous pouvez aussi présenter un travail en attente de décision et récupérer les résultats dans le format attendu par votre application. Ces contrôles sont utiles quand une tâche comporte plusieurs étapes ou nécessite 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
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
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
Suivre le travail
Suivre l’avancement, et présenter aux personnes toute demande d’accord ou d’aide pour reprendre une action interrompue.
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, y compris un test qui rejette les entrées invalides, et vous n’avez pas besoin de compte.

Il vous faut Python 3.11 ou plus récent pour le guide de démarrage rapide depuis les sources taguées, ainsi qu’un bac à sable pris en charge : 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.2.0 · exécution 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

Les droits et la disponibilité, dits clairement

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

Chaque projet désigne un Agent, dont les identifiants sont liés à ce projet et à sa Customer Cell actuelle. Un paquet JSON signé ne devient actif qu’une fois que l’Agent désigné en a vérifié les octets exacts et que le paquet a réussi ses tests en bac à sable.

Les extensions en pur JSON ne peuvent pas utiliser les fichiers de l’hôte, le réseau, les sous-processus ni les identifiants hérités. Les tâches Open Agent 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, nous ne promettons ni quota de calcul gratuit ni SLA de disponibilité.

Créer un projet

Configuration dans la console, identifiants à portée limitée et URL d’API attribuée

Coûts et limites

Budgets, limites de requêtes, conservation et assistance

Disponibilité

Paquets publiés, mises à jour d’exécution requises et fonctionnalités prises en charge

Garde des données

Stockage client, calcul des Agents et transit en clair par le relais

Contrat d’API

OpenAPI généré, schémas typés et décisions conditionnelles

Sécurité

Confiance envers les éditeurs, révocation et signalement privé des vulnérabilités

Le SDK/CLI 0.2.0 est publié sur PyPI et GitHub. L’installation par Homebrew fonctionne sur macOS Apple Silicon et Linux AMD64, et les gestionnaires Python locaux demandent aussi Python 3.11 ou plus récent. Vous pouvez l’exécuter en local dès aujourd’hui. L’exécution à distance suppose que la Customer Cell et le logiciel de l’Agent soient à des versions compatibles : consultez la page Developers de la console pour savoir si c’est prêt avant de soumettre une tâche à distance. Les bundles conservent les droits existants tels quels, et les profils de modèle choisissent un modèle déjà configuré. Les forks d’inspection publics n’exécutent pas d’outils ; rejouer une exécution est une opération distincte.

SDK Python sur PyPI CLI sur PyPI Télécharger le SDK/CLI 0.2.0 Lire 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. Les exemples sont des points de départ pour votre application, et nous n’avons publié aucun résultat d’adoption indépendant.

Lancer le démarrage rapide Essayer un workflow et donner votre avis