Composer SDK: Bessere Werkzeuge für die Agentenentwicklung

Wir unterstützen seit jeher die Definition von Agenten in YAML und Tools in Python. Einrichtung und Deployment bedeuteten bisher jedoch viel Handarbeit: Dateien einzeln hochladen, die Projektstruktur selbst anlegen und YAML-Tippfehler erst im Nachhinein entdecken. Heute veröffentlichen wir das Composer SDK, um genau das zu ändern.

Wo lag das Problem?

Die Entwicklung von Agenten auf Connic funktionierte bereits, hatte aber unnötige Hürden:

• •Manuelle Uploads: Jede Änderung an einem Agenten oder Tool erforderte einen weiteren Datei-Upload
• •Kein Scaffolding: Verzeichnisstruktur und Boilerplate-Dateien mussten von Grund auf angelegt werden
• •Keine lokale Validierung: YAML-Syntaxfehler oder fehlende Tools wurden erst nach dem Upload sichtbar
• •Langsame Iteration: Der Zyklus aus Upload, Test und Korrektur war besonders bei kleinen Änderungen mühsam

Das SDK behebt diese Punkte mit durchgängigem CLI-Tooling.

Was das SDK bietet

Installation über PyPI:

$ pip install connic-composer-sdk

Danach stehen Befehle für den gesamten Workflow zur Verfügung:

connic init: Projektgerüst

Verzeichnisse müssen nicht länger von Hand angelegt werden. Ein Befehl erstellt eine vollständige Projektstruktur mit Beispiel-Agenten, Tools, Middleware und einem README, das alle Bestandteile erklärt.

$ connic init my-agents

✓ Initialized Connic project in /Users/you/my-agents

Created files:
  agents/assistant.yaml          (LLM agent)
  agents/invoice-processor.yaml  (LLM agent with retry)
  agents/tax-calculator.yaml     (Tool agent)
  agents/document-pipeline.yaml  (Sequential agent)
  agents/orchestrator.yaml       (Orchestrator with trigger_agent)
  agents/retrieval-agent.yaml    (Retrieval agent with RAG)
  tools/calculator.py
  middleware/assistant.py
  .gitignore
  requirements.txt
  README.md

Die generierten Beispiele decken die Agententypen LLM, Tool und Sequential sowie Muster wie Orchestrierung und semantisches Retrieval ab. Nicht benötigte Beispiele können gelöscht und die übrigen angepasst werden.

connic lint: lokale Validierung

Das SDK erkennt Fehler vor dem Upload. Es lädt alle Agenten und Tools lokal, validiert das YAML, prüft referenzierte Tools und zeigt eine Vorschau des Deployments.

$ connic lint

Connic Composer SDK - Validation

Discovering tools...
  Found 3 tools in 1 modules:
    calculator: add, multiply, calculate_tax

Discovering middlewares...
  Found middlewares for 1 agents:
    assistant: before, after

Loading agents...
  Found 3 agents:

  ┌─ assistant [LLM]
  │  Description: A helpful assistant with calculator tools
  │  Model: gemini/gemini-2.5-flash
  │  Tools: calculator.add, calculator.multiply, calculator.calculate_tax
  └─

  ┌─ tax-calculator [Tool]
  │  Description: Calculates tax directly
  │  Tool: calculator.calculate_tax
  └─

  ┌─ document-pipeline [Sequential]
  │  Description: Processes documents through extraction and validation
  │  Chain: assistant → invoice-processor
  └─

✓ Project validation complete

Eine falsch geschriebene Tool-Referenz, ungültiges YAML oder fehlende Middleware wird sofort sichtbar und nicht erst nach dem Upload.

connic dev: Entwicklung mit Hot Reload

Eine Development Session synchronisiert lokale Dateien mit einem isolierten Cloud Runner. Nach dem Ändern und Speichern ist eine Datei ohne manuellen Upload innerhalb von zwei bis fünf Sekunden live.

$ connic dev

Watching for file changes...
  Press Ctrl+C to stop

────────────────────────────────────────────────────────────
  View and trigger your agents: https://connic.co/projects/...
────────────────────────────────────────────────────────────

[14:32:15] Detected change: assistant.yaml
[14:32:16] Files changed, uploading...
[14:32:17] Uploaded 2,847 bytes

Die CLI überwacht agents/, tools/, middleware/und requirements.txt. Verbindungstests im Dashboard spiegeln Codeänderungen innerhalb weniger Sekunden wider.

connic deploy: Deployment per CLI

Deployment direkt aus dem Terminal oder der CI/CD Pipeline ist ohne Umweg über das Dashboard möglich.

$ connic login              # Save credentials
$ connic deploy             # Deploy to default environment
$ connic deploy --env <id>  # Deploy to specific environment

Mit der Git Integration löst ein Push ins Repository automatisch ein Deployment aus. Für den normalen Workflow ist die CLI dann nicht erforderlich.

Neu: Vordefinierte Tools importieren

Zusammen mit dem SDK lassen sich jetzt vordefinierte Tools in Custom Tools importieren. Damit kann Python-Code direkt auf Funktionen wie semantischem Retrieval, Websuche oder Agenten-Orchestrierung aufbauen.

from connic.tools import retrieval_query, retrieval_store

async def lookup_and_summarize(query: str) -> str:
    """Search the retrieval and return a summary."""
    # Use the predefined retrieval tool
    results = await retrieval_query(
        query=query,
        namespace="documents",
        top_k=5
    )

    # Process and return the results
    if not results:
        return "No relevant information found."

    return "\n".join([r["content"] for r in results])

Zuvor konnten nur Agenten vordefinierte Tools direkt verwenden. Jetzt lassen sie sich zu umfassenderer Tool-Logik kombinieren: Retrieval abfragen, Ergebnisse verarbeiten, Entscheidungen treffen und genau die benötigte Ausgabe liefern.

Jetzt loslegen

Das SDK ist ab sofort verfügbar. Vorhandene Connic-YAML-Konfigurationen und Python-Tools funktionieren unverändert und erhalten das neue Tooling als Ergänzung.

$ pip install connic-composer-sdk
$ connic init my-agents  # Or use with your existing project
$ cd my-agents
$ connic lint            # Validate everything locally
$ connic dev             # Start hot-reload development

Der Quickstart beschreibt den gesamten Ablauf. Die vollständige Referenz steht in der SDK-Dokumentation.