Potpie

Présentation des outils

Potpie est une plateforme de graphes de contexte de code et d’agent de développement IA développée par Momenta Softwares Inc., conçue actuellement comme un outil de développement piloté par des spécifications pour de grands dépôts de code. Elle organise la structure du code, les dépendances, l’historique des versions, la documentation du projet et les tâches d’ingénierie en un graphique de contexte consultable, permettant à l’agent de comprendre le projet puis de répondre, planifier, modifier et déboguer.

Fonction principale

Carte du contexte de code

Potpie indexe les dépôts, les branches et les données de projet associées, et établit des liens entre les fichiers, les fonctions, les classes, les relations d’appel ainsi que les informations sémantiques. Le proxy permet de rechercher le graphe à l’aide de mots-clés, de nœuds ou de langage naturel, puis de lire le code réel pour répondre aux questions跨fichiers.

• Idéal pour suivre les points d’accès aux fonctionnalités, les chaînes de dépendances, les emplacements d’implémentation et les décisions architecturales.
• Il est possible de comparer les changements entre des branches ou des commits, et d’analyser les éléments de code affectés.
• L’indexation initiale et la mise à jour des grands entrepôts nécessitent du temps de calcul, et la qualité des résultats dépend du fait que l’index soit complet et suffisamment récent.

Flux de travail Ask, Build et Debug

Ask sert à expliquer le code et l’architecture, Build examine d’abord les patterns existants avant de générer des modifications, tandis que Debug trace les symptômes des pannes jusqu’à leurs causes possibles et propose des solutions ciblées. Les tâches complexes peuvent être décomposées par un agent principal en sous-agents spécialisés, mais les résultats générés doivent néanmoins faire l’objet d’une revue de code et de tests.

• Les questions de code peuvent retourner les fichiers pertinents et l’emplacement du code, ce qui facilite la vérification par les développeurs.
• L’agent de génération de code peut préparer les modifications et créer une demande de pull via GitHub à la demande explicite de l’utilisateur.
• L’agent de spécification peut générer des spécifications techniques à partir des besoins ou du code existant, tandis que l’agent de débogage sert à analyser les chemins d’erreur et les points de correction.

Intégration de systèmes d’ingénierie

Potpie peut se connecter à GitHub, Linear, Jira et Confluence pour regrouper le code, les tickets, les projets et les documents dans un même contexte. La documentation du produit mentionne également Slack, Sentry et VS Code, mais les intégrations disponibles peuvent varier selon les versions déployées.

• L’intégration GitHub permet de lire les dépôts, les issues et les demandes de pull, ainsi que de gérer les branches et les modifications dans le cadre des autorisations accordées.
• Les outils Jira, Linear et Confluence permettent de consulter ou de mettre à jour les informations des projets, selon les droits accordés par l’administrateur.
• Les extensions VS Code intègrent les conversations sur le dépôt de code et les processus de modification dans l’éditeur, en se connectant à un proxy cloud via un tunnel local.

CLI, API et proxy personnalisé

Les architectures open source actuelles donnent la priorité à la CLI, permettant d’installer des commandes ou des compétences correspondantes pour Claude Code, Codex, Cursor et OpenCode. L’API peut analyser les dépôts, vérifier l’état de l’index, créer des sessions, envoyer des messages, lister les projets et les agents, ainsi que réaliser des recherches sur du code sémantique.

Tutoriel d'utilisation

1. Décidez d’abord si vous utilisez des services hébergés professionnellement ou une version open source auto-hébergée, et préparez un dépôt de test distinct en fonction des exigences de sécurité de l’organisation.
2. Après avoir installé Potpie, l’utilisateur CLI exécute le guide de configuration et sélectionne le dépôt local, l’assistant de codage ainsi que le système de projet auquel il souhaite se connecter.
3. L’utilisateur gestionnaire installe l’application GitHub et n’autorise que le répertoire cible, puis sélectionne le répertoire, la branche ainsi que l’agent Ask, Build ou Debug.
4. Attendez que l’état de l’index soit finalisé, demandez d’abord à propos de l’architecture ou des processus clés, et vérifiez si les réponses font référence aux fichiers et aux implémentations corrects.
5. Lors de la modification du code, précisez les exigences, les contraintes et les critères d’acceptation, examinez les différences dans une branche isolée et exécutez les tests du projet.
6. Lorsqu’une automatisation est nécessaire, créez une clé API, définez les permissions minimales pour les requêtes, et conservez-la dans un trésor de clés en la renouvelant régulièrement.

Version et mode d’utilisation

À qui s’adresse-t-il

• Il est nécessaire de comprendre les équipes d’ingénierie logicielle de grande taille, héritées ou composées de plusieurs bases de code de services.
• Responsable technique souhaitant réduire le temps nécessaire pour que les nouveaux membres se familiarisent avec l’architecture, déterminent les implémentations et analysent les dépendances.
• Les organisations d’entreprise qui doivent associer les modifications de code aux documents de projet tels que Jira, Linear, Confluence, etc.
• Équipes souhaitant des agents de code auto-hébergés, des outils d’agent d’extension ou des processus de développement internes construits via une API.

Prix et forfaits

La page de tarification actuelle de l’entreprise ne divulgue pas de prix unitaire fixe ; les frais se composent d’une licence utilisateur et d’une redevance de plateforme calculée en fonction du nombre de personnes prises en charge, tandis que le coût de l’ensemble des technologies existantes n’est pas facturé séparément. Les conditions mentionnent la possibilité d’offres gratuites et payantes ainsi qu’un plan Pro, mais la page d’achat publique ne fournit pas de prix ou de quotas unifiés pour ces niveaux.

Avantages du produit

• Le graphe contextuel relie en même temps la structure du code, l’historique et les documents d’ingénierie, ce qui le rend plus adapté au raisonnement inter-composants que la simple recherche de fichiers.
• Les questions-réponses, les spécifications, la construction et le débogage partagent un contexte de projet commun, réduisant la fragmentation des informations entre différents agents.
• Le dépôt principal est soumis à la licence permissive Apache 2.0, permettant d’examiner le code et de l’installer soi-même.
• Il offre en même temps une CLI, un interface web, des extensions d’éditeur et une API, afin de faciliter l’intégration dans différents processus de développement.

Restrictions d'utilisation et précautions

• Une indexation obsolète, l’absence de dépendances privées ou des documents de projet incomplets peuvent entraîner des omissions de contexte essentiel dans les réponses et les analyses d’impact.
• Le code généré par un agent peut introduire des problèmes de sécurité, de performance ou de compatibilité, et ne peut pas remplacer les tests, l’examen et l’approbation de publication.
• Relier GitHub au système de tâches accorde des droits de lecture ou d’écriture ; il convient d’utiliser le plus petit périmètre d’accès possible et d’isoler les identifiants de production.
• Le fait que la version open source soit gratuite ne signifie pas que son exécution l’est également ; avec un hébergement auto-géré, il reste nécessaire de prendre en charge les coûts d’appel des modèles, de calcul, de stockage, d’authentification et de maintenance.
• Le document couvre à la fois les architectures anciennes et nouvelles ; les configurations et fonctionnalités de la version CLI prioritaire peuvent ne pas être entièrement identiques à celles de la version via proxy web.

Confidentialité, sécurité et remboursements

Les services de gestion s’occupent du code, des prompts, des résultats générés, des tokens d’autorisation et des journaux d’utilisation, et peuvent utiliser des données d’entrée et de sortie déidentifiées pour améliorer les modèles internes. La fonction d’exclusion par défaut des données Pro est encore en cours de mise en place progressivement ; les utilisateurs de code sensible doivent d’abord obtenir une confirmation écrite des paramètres, ou choisir une implémentation locale et propriétaire conforme aux exigences de leur organisation.

La politique de confidentialité indique que les données saisies, les journaux et les retours peuvent être conservés sur le long terme ou même indéfiniment pour des raisons historiques, d’analyse et d’entraînement ; les utilisateurs peuvent demander leur suppression, mais les sauvegardes, les audits et les obligations légales peuvent entraîner une conservation. La plateforme n’est pas adaptée au traitement de données sensibles soumises à réglementation, et le contrôle d’accès, les réseaux et les correctifs dans un environnement auto-hébergé relèvent principalement de l’organisation qui le déploie.

Les paiements ne sont généralement pas remboursables ; en cas de panne technique, de prélèvement répété, de force majeure ou de raison de annulation avérée, une demande écrite peut être soumise dans un délai de 7 jours après la transaction, à la discrétion de l’entreprise. Le remboursement, une fois approuvé, devrait prendre de 7 à 14 jours ouvrés, selon les conditions stipulées dans le contrat de commande.

API, SDK et open source

Potpie propose des interfaces avec authentification par clé API, permettant d’effectuer des opérations telles que l’analyse des entrepôts, la consultation de l’état, les sessions, les messages, les projets, les proxies et la recherche sémantique. Aucun SDK généralisé à nom propre n’est actuellement disponible ; les développeurs peuvent l’intégrer directement en se référant à la documentation des interfaces.

Tant le dépôt principal Potpie que l’interface de site web indépendante sont soumis à la licence Apache 2.0 ; cependant, les marques des produits complets, les services d’hébergement, les fonctionnalités d’entreprise et les intégrations avec des tiers ne deviennent pas automatiquement accessibles en vertu de cette licence. Lors de l’hébergement propre, il convient également de respecter séparément les licences et conditions relatives aux modèles, aux bases de données, à l’authentification et aux plateformes externes.

Questions fréquentes

Potpie est-il complètement gratuit ?

Le code source open source peut être utilisé sous la licence Apache 2.0, mais son déploiement, ses modèles et sa maintenance entraînent des coûts supplémentaires. Les services hébergés par des entreprises sont facturés en fonction du nombre d’utilisateurs et de l’échelle de la plateforme ; il ne s’agit pas de produits gratuits à un prix fixe et public.

Est-il possible de permettre à Potpie de modifier directement le code ?

Build ou l’agent de génération de code peut préparer les modifications et créer une demande de pull sur demande explicite. L’utilisateur doit d’abord vérifier les différences dans une branche isolée, exécuter des tests et obtenir l’approbation de l’équipe.

Le code privé est-il utilisé pour l’entraînement ?

La politique de confidentialité autorise l’utilisation d’entrées déidentifiées et de suggestions pour améliorer les systèmes internes, et indique que Pro exclut par défaut l’entraînement qui est encore en cours de mise en place. Lorsqu’il s’agit de code propriétaire, il convient de vérifier avant le téléchargement les contrats, les options de données, la durée de conservation et les limites de déploiement.