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/ und tests/ 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
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.
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.

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.