Développeurs et ateliers pédagogiques · pilote privé

Une API pour tester des décisions.

GardenArena expose son moteur de simulation de ferme à des applications et des assistants. Envoie une politique GardenScript, exécute-la sur une courte période et compare deux approches depuis la même ferme. Le noyau LSK, écrit en Rust, calcule les conséquences sans rappeler un modèle d’IA.

Le pilote API Pro est accessible sur invitation, avec des projets privés, des clés et des quotas. Il n’y a ni achat automatique ni facturation activée. Tu peux déjà découvrir le jeu et sa mission sans clé Pro.

Ce que le pilote permet aujourd’hui

• Valider un programme GardenScript de ferme : diagnostics et empreinte de la source exacte.
• Exécuter une politique pendant une à sept journées simulées, sur un journal de ferme rejouable.
• Comparer deux politiques depuis la même base, avec la même durée demandée et le même plafond d’achats de jeu.
• Exporter les décisions, états, journaux et empreintes. Un export de comparaison compatible peut être réimporté dans la ferme ; la reprise d’une branche reste un choix explicite après recalcul.

Le périmètre actuel est farm-harvest-365-v4, à météo fictive déterministe, avec le moteur lsk-farm-v0.4.0 et GardenScript 0.6. La météo réelle, les autres arènes et une campagne annuelle complète ne sont pas proposés par cette API pilote. Les programmes sont des politiques bornées, jamais du Python ou du code arbitraire.

Un calcul privé, une trace explicable

1. Consulter le catalogue et la version du moteur.
2. Soumettre validate, run ou compare avec une clé Bearer et une clé d’idempotence.
3. Suivre le job en respectant Retry-After, puis télécharger son artefact avant expiration.
4. Lire les différences de décisions, de travaux et d’états. Une différence ne crée pas automatiquement un vainqueur.

Deux branches peuvent avancer moins longtemps que prévu ou s’arrêter à des jours différents. Le rapport conserve ces limites : moins dépenser sur trois jours ne prouve pas une meilleure gestion que tenir sept jours. Les empreintes identifient le programme, le scénario et l’artefact ; elles ne certifient ni l’auteur du programme ni une observation de terrain.

Des limites explicites

• Corps de requête limité à 64 Kio, chaque source à 16 Kio et le journal à 512 commandes.
• Un calcul simultané dans le pilote ; file bornée et quotas par projet. Ce n’est pas une capacité réservée ni un SLA.
• Une validation réserve une unité ; une exécution, le nombre de jours demandé ; une comparaison, deux fois cette durée. Une réponse calculée valide consomme ces unités, même si la stratégie échoue dans le jeu. Une erreur technique les libère.
• Les unités ne sont ni des euros, ni des tokens, ni les crédits utilisés par le fermier.
• Nouveaux projets pilotes : accès de 30 jours par défaut. Résultats disponibles au plus 24 heures après calcul, et jamais au-delà de l’accès autorisé.

Les quotas exacts de ton projet sont consultables dans la console. La suppression d’un artefact ne remet pas le compteur à zéro. Les clés restent côté serveur dans une intégration tierce, jamais intégrées dans une application publique ou une URL.

Jeu, MCP et API Pro : trois usages du même noyau

La ferme permet de jouer dans le navigateur, avec sauvegarde locale et calcul serveur. Le MCP public permet à ton propre assistant d’utiliser les ateliers sous leurs quotas. L’API Pro privée ajoute une file de jobs, un suivi d’usage et des artefacts isolés par projet pour une intégration serveur-à-serveur. Une clé Pro n’est pas nécessaire pour le MCP public.

GardenArena ne paie pas un appel LLM à chaque journée ou replay. L’assistant de l’utilisateur peut avoir son propre coût ; l’hébergement, les calculs Rust et le stockage ont aussi un coût. Le pilote n’est pas un service illimité.

Vérifier avant d’intégrer

Catalogue versionné JSON · Contrat OpenAPI JSON · Guide technique et démonstration · Sources du noyau LSK et licence MIT · Données privées et conservation.

Ce service teste des décisions dans un modèle pédagogique exploratoire. Ce n’est ni un conseil agronomique, ni une preuve de supériorité générale d’une IA, ni un résultat physique. Le Trial terrain suit son propre protocole et son propre état de préparation.