Potpie

Einführung in die Tools

Potpie ist eine von Momenta Softwares Inc. entwickelte Plattform für Code-Context-Diagramme und AI-Entwicklungsagenten. Sie dient derzeit als tool zur spezifikationsgesteuerten Entwicklung großer Codebasen. Potpie ordnet die Codestruktur, Abhängigkeiten, Versionsgeschichte, Projektdokumentationen sowie Entwicklungsaufgaben in ein abrufbares Context-Diagramm zusammen, wodurch der Agent nach dem Verständnis des Projekts antworten, planen, ändern und debuggen kann.

Hauptfunktionen

Code-Context-Diagramm

Potpie indiziert Repositorien, Branches sowie verknüpfte Projektunterlagen und erstellt Verbindungen zwischen Dateien, Funktionen, Klassen, Aufrufbeziehungen und semantischen Informationen. Der Agent kann das Diagramm mithilfe von Schlüsselwörtern, Knoten oder natürlicher Sprache abfragen und anschließend den eigentlichen Code auslesen, um Fragen über mehrere Dateien hinweg zu beantworten.

• Eignet sich zur Verfolgung von Funktionseingängen, Abhängigkeitsketten, Implementierungsstandorten und Architekturentscheidungen.
• Man kann die Unterschiede zwischen verschiedenen Branches oder Commits vergleichen und die betroffenen Code-Elemente analysieren.
• Die erste Indizierung sowie die Aktualisierung großer Lager erfordern Rechenzeit, und die Qualität des Ergebnisses hängt davon ab, ob der Index vollständig und ausreichend aktuell ist.

Workflows für Ask, Build und Debuggen

Ask dient zur Erklärung von Code und Architektur, Build analysiert zunächst vorhandene Muster, bevor es Änderungen erstellt, und Debug verfolgt die Symptome eines Fehlers bis zu den möglichen Ursachen und bietet entsprechende Lösungen. Komplexe Aufgaben können vom Leiter an spezielle Unteragenten delegiert werden, doch die Ergebnisse müssen dennoch einer Code-Überprüfung und Tests unterzogen werden.

• Frage-Antwort-Szenarien zum Code können die entsprechenden Dateien und Code-Positionen zurückgeben, was Entwicklern die weitere Überprüfung erleichtert.
• Der Code-Generierungs-Agent kann Änderungen vorbereiten und auf ausdrücklichen Wunsch des Benutzers über GitHub eine Pull-Request erstellen.
• Der Spezifikations-Agent kann technische Spezifikationen aus Anforderungen oder vorhandenem Code erzeugen, während der Debugging-Agent dazu dient, Fehlerwege und Korrekturvorschläge zu analysieren.

Integration von Ingenieurssystemen

Potpie kann mit GitHub, Linear, Jira und Confluence verbunden werden, um Code, Anfragen, Projekte und Dokumente in einem gemeinsamen Kontext zusammenzuführen. In der Produktdokumentation werden außerdem Slack, Sentry und VS Code aufgeführt, wobei die verfügbaren Integrationen je nach Deployment-Version unterschiedlich sein können.

• Die GitHub-Integration ermöglicht das Lesen von Repositorien, Issues und Pull Requests sowie die Verwaltung von Branches und Änderungen im Rahmen der Berechtigungen.
• Die Tools Jira, Linear und Confluence ermöglichen es, Projektinformationen abzurufen oder zu aktualisieren – die genauen Möglichkeiten hängen von den Rechten ab, die dem Administrator gewährt wurden.
• VS Code-Erweiterungen bringen den Code-Basen-Chat und den Bearbeitungsprozess in den Editor und verbinden sich über einen lokalen Tunnel mit einem Cloud-Proxy.

CLI, API und benutzerdefinierte Proxye

Die aktuellen Open-Source-Architekturen legen den Schwerpunkt auf die CLI; es ist möglich, entsprechende Befehle oder Fähigkeiten für Claude Code, Codex, Cursor und OpenCode zu installieren. Die API kann Repositorien analysieren, den Indexzustand überprüfen, Sessions erstellen, Nachrichten senden, Projekte sowie Agenten auflisten und semantische Code-Suchen durchführen.

Anleitung zur Verwendung

1. Entscheiden Sie zunächst, ob Sie gehostete Unternehmensdienste oder eine selbst gehostete Open-Source-Version verwenden möchten, und bereiten Sie entsprechend den Sicherheitsanforderungen der Organisation ein eigenes Testrepository vor.
2. Nach der Installation von Potpie durch den CLI-Benutzer wird der Einrichtungswizard gestartet, in dem der lokale Repository, der Kodierhelfer sowie das zu verbindende Projektsystem ausgewählt werden.
3. Der Hosted-User installiert die GitHub-Anwendung und erteilt nur Zugriff auf das gewünschte Repository. Anschließend wählt er das Repository, den Branch sowie den Agenten für Ask, Build oder Debug aus.
4. Warten Sie, bis der Status des Indexes feststeht. Fragen Sie zunächst nach der Architektur oder den wichtigsten Abläufen und überprüfen Sie, ob die Antworten auf die richtigen Dateien und Implementierungen verweisen.
5. Bei der Anpassung des Codes sollten Anforderungen, Einschränkungen und Akzeptanzkriterien klar festgelegt werden. Die Unterschiede sollten in einer isolierten Branch überprüft und die Projekttests ausgeführt werden.
6. Wenn Automatisierung erforderlich ist, werden API-Schlüssel erstellt, es werden minimale Berechtigungen für die Anfragen festgelegt, und diese Schlüssel werden im Schlüsselspeicher gespeichert sowie regelmäßig ausgetauscht.

Versionen und Verwendungsmöglichkeiten

Für welche Benutzer geeignet

• Es ist notwendig, Softwareentwicklerteams zu verstehen, die mit großen, veralteten oder in mehreren Codebibliotheken untergebrachten Systemen arbeiten.
• Technischer Leiter, der hofft, die Zeit zu verkürzen, die neue Mitarbeiter benötigen, um sich mit der Architektur vertraut zu machen sowie Implementierungen und Abhängigkeiten zu analysieren.
• Unternehmen, die Änderungen am Code mit Projektdokumenten wie Jira, Linear, Confluence usw. verknüpfen müssen.
• Teams, die intelligente Self-Hosting-Code-Agenten, erweiterbare Proxy-Werkzeuge oder interne Entwicklungsprozesse über APIs erstellen möchten.

Preise und Angebote

Auf der aktuellen Preisanzeige des Unternehmens werden keine festen Preise angegeben. Die Kosten setzen sich aus den Kosten für die Nutzerlizenzen sowie den Gebühren für die Plattform in Abhängigkeit von der Anzahl der unterstützten Benutzer zusammen. Die Kosten für die verwendete Technologie selbst werden nicht extra berechnet. In den Bedingungen wird darauf hingewiesen, dass es kostenlose sowie bezahlte Angebote sowie ein Pro-Plan geben könnte. Auf der offiziellen Kaufseite werden jedoch keine einheitlichen Preise oder Mengenangaben für diese Optionen bereitgestellt.

Vorteile des Produkts

• Das Kontextgraph verbindet gleichzeitig die Codestruktur, die Historie sowie die technischen Dokumente und eignet sich daher besser für das Schlussfolgern über mehrere Komponenten als eine einfache Dateisuche.
• Fragen und Antworten, Spezifikationen, Entwicklung und Debugging teilen denselben Projektkontext, wodurch die Informationsunterbrechungen zwischen verschiedenen Agenten verringert werden.
• Der Kern-Repository wird unter der liberalen Apache 2.0-Lizenz bereitgestellt, wodurch der Code überprüft und eigenständig bereitgestellt werden kann.
• Gleichzeitig werden CLI, Webseiten, Editor-Erweiterungen und API bereitgestellt, um die Anbindung an verschiedene Entwicklungsprozesse zu erleichtern.

Einsatzbeschränkungen und Hinweise

• Veraltete Indizes, fehlende private Abhängigkeiten oder unvollständige Projektdokumentationen können dazu führen, dass bei der Beantwortung von Fragen sowie bei der Analyse der Auswirkungen wichtiger Kontexte übersehen werden.
• Von Agenten erzeugter Code kann Sicherheits-, Leistungs- oder Kompatibilitätsprobleme verursachen und ersetzt keine Tests, Überprüfungen und Freigabestimmungen.
• Die Verbindung von GitHub mit dem Aufgabensystem gewährt Lese- oder Schreibrechte; es sollte ein möglichst kleiner Zugriffsbereich verwendet werden und die Produktionsanmeldeinformationen sollten isoliert werden.
• Dass die Open-Source-Version kostenlos ist, bedeutet nicht, dass ihre Nutzung kostenlos ist. Bei selbst gehosteter Nutzung müssen weiterhin Kosten für den Aufruf der Modelle, die Berechnungen, die Speicherung, die Authentifizierung sowie die Wartung entstehen.
• Das Dokument umfasst sowohl die alte als auch die neue Architektur. Die Einstellungen und Funktionen der CLI-Vorabversion können von denen der Web-Proxy-Version nicht vollständig übereinstimmen.

Privatsphäre, Sicherheit und Rückerstattung

Die Hosting-Dienste kümmern sich um den Code, die Anweisungen, die erzeugten Ergebnisse, die Autorisierungstoken sowie die Nutzungslogs. Zudem können sie anonymisierte Eingaben und Ergebnisse nutzen, um interne Modelle zu verbessern. Die Funktion zur Ausklammerung sensiblen Codes in Pro-Daten wird schrittweise eingeführt. Benutzer von sensiblem Code sollten zunächst schriftlich die Einstellungen bestätigen oder eine lokale sowie proprietäre Implementierung wählen, die den Anforderungen der Organisation entspricht.

Laut der Datenschutzerklärung können Eingaben, Protokolle und Rückmeldungen aus historischen, analytischen oder Schulungszwecken langfristig – sogar unbegrenzt – gespeichert werden. Die Nutzer können die Löschung dieser Daten beantragen, doch Backups, Audits sowie rechtliche Verpflichtungen können eine Aufbewahrung erforderlich machen. Die Plattform eignet sich nicht zur Verarbeitung regulierter, sensibler Daten. Der Zugriffskontroll, die Netzwerksicherheit sowie die Bereitstellung von Patches liegen in der Verantwortung der Organisation, die die Plattform betreibt.

Zahlungen werden in der Regel nicht rückerstattet; bei technischen Störungen, mehrfachen Abbuchungen, höherer Gewalt oder nachgewiesenen Gründen für eine Stornierung kann innerhalb von 7 Tagen nach der Transaktion schriftlich eine Anfrage gestellt werden. Die Entscheidung über die Rückerstattung liegt dann bei dem Unternehmen. Eine Genehmigung der Rückerstattung dauert in der Regel 7 bis 14 Arbeitstage – genaue Fristen sind jedoch im Bestellvertrag festgelegt.

APIs, SDKs und Open Source

Potpie bietet Schnittstellen mit API-Schlüssel-Authentifizierung, über die Operationen wie Lageranalyse, Statusabfragen, Sessions, Nachrichten, Projekte, Proxy-Einsatz sowie semantische Suche durchgeführt werden können. Derzeit gibt es kein eigenständig benanntes universelles SDK; Entwickler können die Schnittstellen direkt anhand der Dokumentation integrieren.

Sowohl der Core Potpie-Repository als auch das Repository mit eigenständiger Web-Oberfläche werden unter der Apache 2.0-Lizenz bereitgestellt. Die Markenrechte für die vollständigen Produkte, die Hosting-Dienste, die Unternehmensfunktionen sowie die Integration mit Drittanbietern werden dadurch nicht automatisch freigegeben. Bei selbst gehostetem Einsatz müssen zudem die Lizenzbedingungen sowie die Vorgaben für Modelle, Datenbanken, Authentifizierung und externe Plattformen eingehalten werden.

Häufige Fragen

Ist Potpie völlig kostenlos?

Offener Quellcode kann unter der Apache 2.0-Lizenz verwendet werden, doch die Bereitstellung, das Verwalten der Modelle sowie die Wartung verursachen eigene Kosten. Dienste mit Unternehmenshosting werden nach Anzahl der Nutzer und Größe der Plattform berechnet und sind keine kostenlosen Produkte mit festen öffentlich bekannten Preisen.

Kann Potpie den Code direkt ändern?

Der Build- oder Code-Generierungsagent kann die Änderungen vorbereiten und auf ausdrücklichen Wunsch eine Pull-Request erstellen. Der Benutzer sollte zunächst die Unterschiede in einer isolierten Branch überprüfen, Tests ausführen und die Freigabe durch das Team einholen.

Wird privater Code zur Schulung verwendet?

Die Datenschutzrichtlinien erlauben die Verwendung von anonymisierten Eingaben zur Verbesserung interner Systeme, und es wird angegeben, dass Pro standardmäßig eine Nutzung für das Training ausschließt, da dieses noch in Entwicklung ist. Im Falle von proprietärem Code sollten vor dem Hochladen Vertragsbedingungen, Datenvorgaben, Aufbewahrungsfristen sowie Einsatzzwecke überprüft werden.