Zum Hauptinhalt springen
Connic
Einstieg

Quickstart

Ein erstes Connic-Projekt erstellen, einen Agenten deployen und über dessen Verbindung den ersten Run auslösen.

Zuletzt aktualisiert
Setup mit einem Coding-Agenten

Wähle einen Coding Client, installiere das Connic Plugin, falls ein natives Paket verfügbar ist, und beschreibe dem Agenten das gewünschte Ergebnis. Derselbe Guide behandelt auch das separate Skill- und MCP- Setup für andere Clients. Folge dem Setup für KI-Agenten.

1

Projekt in Connic erstellen

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

2

Lokales Projekt einrichten

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

terminal
pip install connic-composer-sdk

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

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

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

terminal
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 KI-Agenten.

3

Agenten definieren

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

agents/assistant.yaml
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.

4

Deploy

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

Git-Integration
  1. Verbinde das Repository unter Projekt-Settings → Git & Environments
  2. Ordne auf derselben Seite jedes Environment einem Branch zu
  3. Starte das Deployment mit einem Push
terminal
git add .
git commit -m "Initiales Agent-Setup"
git push origin main
CLI Deploy
  1. Erstelle einen API Key unter Projekt-Settings → API Keys & MCP Auth
  2. Führe im Projekt-Ordner connic login aus
  3. Nutze connic dev für Iterationen oder connic deploy für den Produktivbetrieb
terminal
connic login
connic deploy
5

Verbindung erstellen

Erstelle eine Verbindung aus dem Marketplace, um den Agenten auszulösen. Über einen HTTP-Webhook kann beispielsweise eine bestehende Anwendung den Agenten per API aufrufen.

a

Öffne die Detailseite des Agenten im Bereich Agenten

b

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

c

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

d

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

6

Agenten auslösen und prüfen

Löse den Agenten mit der erstellten Verbindung aus. Eine HTTP-Webhook-Verbindung lässt sich beispielsweise mit einem curl-Befehl auslösen:

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

Alles ist bereit!

Der Agent ist jetzt bereitgestellt und einsatzbereit.