Zum Hauptinhalt springen
Connic
Test

Dev Server

Mit connic dev lokale Projektdateien in eine isolierte Cloud-Entwicklungssitzung synchronisieren.

Zuletzt aktualisiert
Auf dieser Seite

Überblick

Direkt mit lokalen Projekt-Dateien entwickeln

Der Befehl connic dev erstellt eine isolierte Cloud-Entwicklungsumgebung, synchronisiert das lokale Projekt und überwacht unterstützte Dateien auf Änderungen. Synchronisierte Änderungen stehen beim nächsten Agenten-Aufruf zur Verfügung. Dazu gehören:

  • Synchronisierte Änderungen testen: Datei speichern, Agenten auslösen und Ergebnis prüfen
  • Verbindungen verwenden: Webhooks, Cron Jobs, Telegram und weitere Verbindungen in der Entwicklungsumgebung konfigurieren
  • Im Editor arbeiten: Lokale Speichervorgänge werden direkt mit der Entwicklungssitzung synchronisiert
  • Vom Produktivbetrieb isoliert bleiben: Dev läuft in einem eigenen Environment mit eigenen API-Keys, Umgebungsvariablen und Verbindungen
Voraussetzungen

• Connic SDK installiert: pip install connic-composer-sdk

• Ein gültiges Agentenprojekt mit mindestens einem Agenten in agents/

Quickstart

1

Authentifizieren

Führe connic login im Projekt-Root aus. Die CLI öffnet das Dashboard zum Erstellen eines API-Keys und fordert anschließend zum Einfügen des Login Tokens auf.

terminal
connic login

Zugangsdaten werden in .connic gespeichert. Füge die Datei zur .gitignore des Projekts hinzu.

2

Dev Session starten

Starte eine Session, um eine Entwicklungsumgebung zu erstellen und die Projektdateien hochzuladen.

terminal
# Ephemere Dev Session starten (beim Beenden automatisch gelöscht)
connic dev

Die CLI lädt das Projekt hoch und beginnt, unterstützte Dateien zu überwachen.

3

Entwickeln und iterieren

Bearbeite die Agent-YAMLs, Tools, Middleware oder Tool Hooks. Die CLI lädt gespeicherte Änderungen nach etwa einer Sekunde hoch. Verwende die Seite Verbindungen im Dashboard oder die Agenten-Detailseite, um Agenten auszulösen und Runs in Echtzeit zu prüfen.

In einem interaktiven Terminal stehen diese Tastenkürzel zur Verfügung:

  • r lädt die aktuellen Dateien sofort hoch
  • t führt die Testsuiten in tests/ gegen die aktive Entwicklungsumgebung aus
  • q beendet die Session und führt das reguläre Cleanup aus

Sind Tastenkürzel nicht verfügbar, beende die Session mit Ctrl+C.

Temporäre und benannte Environments

Entwicklungssitzungen können temporär sein oder unter einem festen Namen gespeichert werden. Die Auswahl bestimmt, ob das zugrunde liegende Environment, seine Verbindungen und seine Umgebungsvariablen nach dem Beenden bestehen bleiben.

Temporär
terminal
connic dev
  • • Wird beim Beenden mit q oder Ctrl+C automatisch gelöscht
  • • Neues Environment bei jeder Sitzung
  • • Ideal für schnelle Experimente und Fehlerreproduktion
Benannt
terminal
# Benanntes Dev Environment über mehrere Sessions wiederverwenden
connic dev my-feature
  • • Bleibt beim Beenden mit q oder Ctrl+C bestehen
  • • Später unter demselben Namen erneut verbinden
  • • Ideal für fortlaufende Feature-Arbeit, bei der Verbindungen und Umgebungsvariablen wichtig sind

Dateiänderungen erkennen

Die CLI überwacht die Standardverzeichnisse des Projekts auf Änderungen:

Projektstruktur
my-agent-project/
agents/✓Überwacht
assistant.yaml
tools/✓Überwacht
calculator.py
middleware/✓Überwacht
assistant.py
hooks/✓Überwacht
assistant.py
schemas/✓Überwacht
guardrails/✓Überwacht
tests/✓Überwacht (mit 't' ausführen)
requirements.txtBeim Start der Session installiert
.connicAuth Config (nicht synchronisiert)

Die CLI wartet nach Dateiänderungen eine Sekunde, bevor sie den Upload startet. So werden mehrere Umbenennungen oder die Änderungen eines Formatierungslaufs gemeinsam hochgeladen. Unterordner in agents/ und tools/ werden rekursiv überwacht. Größere Projekte können Dateien deshalb ohne weitere Änderungen in Namespaces aufteilen.

Abhängigkeiten aus requirements.txt werden beim Start der Entwicklungssitzung installiert. Beende und erstelle die Session nach Änderungen an dieser Datei neu.

Dashboard-Integration

Entwicklungsumgebungen erscheinen neben den regulären Environments:

  • Environment-Auswahl: Entwicklungsumgebungen werden getrennt von Standardumgebungen gruppiert
  • Agentenansicht: Zeigt die in der Entwicklungssitzung verfügbaren Agenten
  • Verbindungen: In der ausgewählten Entwicklungsumgebung erstellen und auslösen
  • Deployment-Seite: Die Entwicklungssitzung wird mit einem Dev session Badge angezeigt und ist dadurch in der Liste leicht zu erkennen

Konfiguration

Authentifizierung über Datei oder Umgebungsvariablen

Die Datei .connic im Projekt-Root speichert die Zugangsdaten:

.connic
{
  "api_key": "cnc_xxxxxxxxxxxx",
  "project_id": "your-project-uuid"
}

Zugangsdaten lassen sich auch über Umgebungsvariablen übergeben. Das ist für CI oder gemeinsam genutzte Shells sinnvoll, in denen die Zugangsdaten nicht in einer Datei im Repository liegen sollen:

.env
# Environment Variables
CONNIC_API_KEY=cnc_xxxxxxxxxxxx
CONNIC_PROJECT_ID=your-project-uuid

Konfliktbehandlung

Pro benanntem Environment kann nur eine Entwicklungssitzung gleichzeitig aktiv sein. Beim Start einer zweiten Session unter demselben Namen erscheint:

Fehler: Für dieses Environment ist bereits eine Entwicklungssitzung aktiv. Beende zuerst die bestehende Session mit q oder Ctrl+C in dem Terminal, in dem sie läuft.

Verwende einen anderen Namen oder lass ihn für eine temporäre Sitzung weg, um parallel zu arbeiten.

Weiter mit Tests

Testing Framework

Deklarative Testsuiten in tests/ schreiben

Deployment

Über Git oder CLI in der Produktivumgebung veröffentlichen

Agent-Konfiguration

Agenten in YAML konfigurieren

Webhooks

Agenten über HTTP Webhooks auslösen