Build
Projektstruktur
Übersicht über Agent-Definitionen, Python-Erweiterungen, Tests und Abhängigkeiten in einem connic-Projekt.
Zuletzt aktualisiert
Auf dieser Seite
Ein connic-Projekt ist ein Repository mit wenigen fest definierten Verzeichnissen. connic init erstellt agents/, tools/, middleware/ und schemas/. Füge guardrails/, hooks/, tests/ und connectors/ bei Bedarf hinzu.
Projektstruktur
my-agent-project/
Inhalt der einzelnen Verzeichnisse
agents/
YAML-Dateien, die jeden Agenten definieren. Nutze
_defaults.yaml für gemeinsame Einstellungen und überschreibe sie anschließend in den einzelnen Agent-Definitionen.tools/
Python-Module mit eigenen Tools. Parametertypen und Standardwerte definieren Input-Schemas, Docstrings liefern die Beschreibungen.
middleware/
Optionale Python-Module, die vor und nach einer Agent-Ausführung laufen. Ordne Module wie unter Middleware beschrieben den Agenten zu.
hooks/
Optionale Python-Module, die einzelne Tool-Aufrufe umschließen. Erkennung und Signaturen sind unter Tool Hooks dokumentiert.
guardrails/
Optionale Python-Module mit eigenen Guardrail Checks.
schemas/
JSON-Schema-Dateien, auf die das output_schema-Feld eines Agenten verweist.
tests/
YAML Testsuiten mit Eingaben, Mocks und Assertions. Der Guide zum ersten Test erklärt Zuordnung von Dateien und Ausführung.
connectors/
Optionale YAML-Dateien, eine pro Verbindung, die Deployments anlegen, aktualisieren oder stilllegen. Siehe Verbindungen im Code.
requirements.txt
Python-Pakete, die mit dem Projekt installiert werden. Speichere keine Zugangsdaten in dieser Datei, sondern nutze Environment Variables für sensible Werte zur Laufzeit. Jede Zeile muss eine einfache Anforderung wie
httpx>=0.27 sein; Optionen, URLs und Dateipfade werden abgelehnt. Pakete werden nur aus vorgebauten Wheels für Python 3.12 unter Linux x86-64 installiert, Builds aus dem Quellcode sind deaktiviert. Ist ein Paket oder eine seiner Abhängigkeiten nur als Quellcode veröffentlicht, schlägt der Build fehl. connic lehnt Abhängigkeiten mit ausführbaren .pth-Hooks oder importierbaren Modulen namens sitecustomize oder usercustomize ab. Pfade in .pth-Dateien müssen innerhalb von site-packages bleiben und dürfen nicht auf Dateien verweisen.Projektstruktur anlegen
terminal
connic init my-agents --skill
cd my-agentsDas optionale --skill-Flag ergänzt die connic-Projekt-Anweisungen für kompatible KI-Coding-Agenten. Führe nach Änderungen an der Dateistruktur connic lint aus, um zu prüfen, ob die Projektdateien korrekt erkannt werden.