Quickstart

Projekt in connic erstellen

Erstelle ein neues Projekt im connic dashboard. Der Einrichtungsassistent führt durch die Anbindung des Repositorys.

Lokales Projekt einrichten

Installiere das SDK und erstelle anschließend entweder ein Projektgerüst aus einem Template oder ein minimales Projekt.

pip install connic-composer-sdk

Option A: Mit einem Template starten (empfohlen). Durchsuche die Agent Templates und führe Folgendes aus:

connic init my-project --templates=invoice,customer-support --skill
cd my-project

Option B: Bei null anfangen. Erstelle eine minimale Struktur:

connic init my-agents --skill
cd my-agents

Das optionale Flag --skill fügt dem Projekt den connic skill hinzu. In einem interaktiven Terminal erkennt die CLI außerdem Codex und Claude Code und bietet die Installation des vollständigen Plugins an, das Skill und MCP bündelt. Lehne die Abfrage ab, um nur den Skill einzurichten. Weitere Informationen stehen unter Setup für Coding-Agenten.

Agenten definieren

Bearbeite die YAML-Datei des Agenten, um ihn zu konfigurieren.

version: "1.0"

name: assistant
model: connic/gpt-5.6-terra
description: "Ein hilfreicher Assistent"
system_prompt: |
  Du bist ein hilfreicher Assistent. Beantworte Fragen
  klar und präzise.

temperature: 0.7
max_concurrent_runs: 1

Jede YAML-Datei im Ordner agents/ definiert einen Agenten. Ein einzelnes Projekt kann mehrere Agenten enthalten. Halte die Dateien bei einfachen Projekten auf der obersten Ebene; bei größeren Projekten lassen sich Agenten in Unterordnern unter agents/ organisieren.

Deploy

Wähle Git (automatisches Deployment bei jedem Push) oder die CLI (funktioniert mit jedem Provider).

git add .
git commit -m "Initiales Agent-Setup"
git push origin main

connic login
connic deploy

Verbindung erstellen

Erstelle eine Verbindung aus dem Marketplace, um den bereitgestellten Agenten mit echten Anfragen zu verbinden. Über einen HTTP-Webhook kann beispielsweise eine bestehende Anwendung den Agenten per API aufrufen.

1. a

   Öffne die Detailseite des Agenten im Bereich Agenten

2. b

   Klicke im Diagramm der Verbindungen auf den Button + und wähle anschließend Create New Connector

3. c

   Wähle im Marketplace einen Verbindungstyp aus und konfiguriere ihn (Name, Mode usw.)

4. d

   Nach dem Erstellen wird die Verbindung automatisch mit dem Agenten verknüpft

Agenten auslösen und prüfen

Öffne den Playground in der Projektnavigation und wähle einen aktiven Agenten. Gib bei einem Text-, Tool- oder Sequential-Agenten den Input als Text oder JSON ein und klicke auf Run. Du kannst bis zu 10 Dateien mit insgesamt höchstens 10 MiB anhängen oder den Run bis zu 30 Tage im Voraus planen. Sind Testvarianten bereitgestellt, wähle unter Run version den Basisagenten oder eine Variante aus. Ein Voice-Agent startet stattdessen eine Live-Session über das Mikrofon; wähle seine Basisversion oder eine bereitgestellte Voice-Variante aus und klicke auf Run. Der Playground verwendet die Tools und Verbindungen des gewählten Environments und zeigt Ausgabe, Traces, Logs sowie die letzten manuellen Runs an.

Du kannst den Agenten auch über seine Verbindung auslösen. Nutze für eine HTTP-Webhook-Verbindung beispielsweise diesen curl-Befehl:

curl -X POST <webhook-url> \
  -H "Content-Type: application/json" \
  -H "X-Connic-Secret: <your-secret-key>" \
  -d '{"message": "Hallo, Agent!"}'

Prüfe im Bereich Runs des Projekts die Antwort und Trace-Details des Agenten.