Zum Hauptinhalt springen
connic
Build

Projektstruktur

Übersicht über Agent-Definitionen, Python-Erweiterungen, Tests und Abhängigkeiten in einem connic-Projekt.

Zuletzt aktualisiert

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/
agents/
_defaults.yamlOptional defaults inherited by agents below
assistant.yamlLLM agent
tax-calculator.yamlTool agent
document-pipeline.yamlSequential agent
tools/
search.pyCustom tools
calculator.py
middleware/Optional run-level hooks
assistant.py
hooks/Optional tool-call hooks
assistant.py
guardrails/Optional custom guardrails
account-policy.py
schemas/Structured-output schemas
support-response.json
tests/
assistant.yamlTest cases and assertions
connectors/Optional connectors applied by deploys
support-inbox.yaml
requirements.txtPython dependencies

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-agents

Das 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.