Zum Hauptinhalt springen
Connic

Vordefiniert, selbst gebaut
oder jeder MCP Server

Ein wachsender Katalog stellt typisierte, getestete Tools bereit. Eigene Tools sind einfache Python-Funktionen; MCP Server machen ihre Tools für alle Agenten im Projekt verfügbar.

Tools-Dokumentation lesen

Tools

6 verknüpft
  • Eigenes Toolinvoices.parse_pdf
  • Eigenes Toolinvoices.store
  • Vordefiniertweb_search
  • MCPlinear.create_issue
  • MCPcontext7.search_docs
  • Eigenes Toolbilling.calculate_vat

Tools, die Teams sonst selbst neu bauen müssten

Integrierte Tools für semantisches Retrieval, die Projektdatenbank, die Zusammenarbeit mehrerer Agenten und Webzugriff.

Retrieval
retrieval_query

Retrieval nach relevanten Informationen durchsuchen.

Retrieval
retrieval_store

Neue Informationen zur Retrieval-Indexierung einreihen.

Retrieval
retrieval_delete

Einträge aus dem Retrieval entfernen.

Retrieval
retrieval_list_namespaces

Retrieval Namespaces und ihre Hierarchie auflisten.

Database
db_find

Dokumente einer Collection mit Filtern abfragen.

Database
db_insert

Ein oder mehrere Dokumente in eine Collection einfügen.

Database
db_update

Dokumente aktualisieren, die einem Filter entsprechen.

Database
db_upsert

Das erste passende Dokument aktualisieren oder ein neues einfügen, wenn keines passt.

Database
db_delete

Dokumente löschen, die einem Filter entsprechen.

Database
db_count

Dokumente einer Collection zählen, optional gefiltert.

Database
db_list_collections

Collections mit Anzahl und Speichergröße auflisten.

Orchestration
trigger_agent

Einen anderen Agenten im selben Projekt starten.

Orchestration
trigger_agent_at

Einen Agenten für einen zukünftigen Zeitpunkt planen.

Web
web_search

Das Web nach aktuellen Informationen durchsuchen.

Web
web_read_page

Eine Webseite abrufen und ihren Inhalt als Markdown zurückgeben.

Vollständige Referenz in der Dokumentation ansehen.

Eine Python-Funktion ist ein Tool

Einfache Funktionen unter tools/. Type Hints und ein Docstring sind alles, was Connic benötigt, um sie einem Agenten bereitzustellen.

tools/billing.py
from datetime import date

def calculate_late_fee(
    invoice_total: float,
    due_date: date,
    paid_date: date,
) -> dict:
    """Verzugsgebühr für eine überfällige Rechnung berechnen.

    Args:
        invoice_total: Ursprünglicher Rechnungsbetrag in Dollar
        due_date: Ursprüngliches Fälligkeitsdatum
        paid_date: Datum, an dem die Rechnung bezahlt wurde

    Returns:
        Dict mit der Gebühr in Cent und der Anzahl überfälliger Tage.
    """
    days_overdue = max(0, (paid_date - due_date).days)
    fee_cents = int(invoice_total * 100 * 0.015 * days_overdue)
    return {"fee_cents": fee_cents, "days_overdue": days_overdue}
Type Hints werden zum Schema

Der Agent sieht ein typisiertes JSON Schema, das aus der Funktionssignatur erzeugt wird. Keine Decorators, keine manuelle Schema-Definition.

Der Docstring wird zur Beschreibung

Das LLM entscheidet anhand des Docstrings, wann es das Tool aufruft. Die unter Args beschriebenen Parameter helfen ihm, die richtigen Werte zu übergeben.

Automatisch unter tools/ erkannt

Eine Datei im Verzeichnis tools/ wird im Agent YAML als module.function referenziert. Wildcards wie calculator.* funktionieren ebenfalls.

Jeder MCP Server für jeden Agenten

Unter mcp_servers im Agent YAML eingetragene Server werden von Connic verbunden. Connic erkennt ihre Tools und stellt sie dem LLM zur Laufzeit bereit.

support-triage
ruft Tools wie lokale Funktionen auf
MCP Client
context7HTTP
research-hubHTTP
agents/support.yaml
mcp_servers:
  - name: context7
    url: https://mcp.context7.com/mcp

  - name: research-hub
    url: https://mcp.example.com/research
    headers:
      Authorization: "Bearer ${RESEARCH_TOKEN}"
    tools:
      - search_papers
      - fetch_abstract

  - name: internal-tools
    url: https://mcp.internal.company.com/tools
    headers:
      Authorization: "Bearer ${INTERNAL_TOKEN}"
    discoverable: true   # für On-Demand-Suche indexiert, nicht vorab geladen

Funktionen für Tool-Aufrufe im Produktivbetrieb

Vordefinierte Tools, eigene Tools und MCP-Tools werden nach denselben Regeln erkannt, ausgeführt und in Traces erfasst.

Automatische Erkennung

Eine Python-Datei unter tools/ wird im Agent YAML als module.function referenziert. Unterverzeichnisse und Wildcards wie calculator.* funktionieren.

Sauber stoppen oder abbrechen

StopProcessing aus einem Tool beendet den Run erfolgreich mit einer abschließenden Nachricht. AbortTool aus einem Hook überspringt einen einzelnen Aufruf.

Integrierte Observability

Jeder Tool-Aufruf erscheint mit Inputs, Output und Dauer in den Run Details. Print-Ausgaben, stderr und tools.* Logger streamen in den Tab Logs.

Auffindbare Tools

Selten verwendete Tools oder ganze MCP-Server lassen sich als discoverable markieren. Ihre Definitionen werden erst in den Modellkontext aufgenommen, wenn der Agent anhand ihrer Beschreibung nach ihnen sucht.

Häufig gestellte Fragen

Eigene Tools werden derzeit in Python geschrieben. Anderswo implementierte Logik kann in einem MCP Server gekapselt und unter mcp_servers ergänzt werden. Der Agent sieht diese Tools nativ neben eigenen Python Tools.

Einfache Python-Funktionen im Verzeichnis tools/ werden automatisch erkannt; Decorators sind nicht erforderlich. Das Agent YAML referenziert sie als module.function, zum Beispiel calculator.add. Wildcards wie calculator.* oder search.web_* binden mehrere gleichzeitig ein.

Ja. connic dev beobachtet das Verzeichnis tools/ und registriert Tools direkt nach dem Speichern neu. Weitere Details stehen in der Dev-Server-Dokumentation.

HTTP und SSE. STDIO wird nicht unterstützt; MCP Server müssen aus dem Agent Container über das Netzwerk erreichbar sein. Headers übernehmen die Authentifizierung, zum Beispiel Authorization: Bearer ${TOKEN}; Secrets verwenden die Syntax ${VAR}.

Vordefinierte Tools decken allgemeine Aufgaben ab: semantisches Retrieval (retrieval_query), die Projektdatenbank (db_find, db_insert, …), die Zusammenarbeit mehrerer Agenten (trigger_agent) und Webzugriff (web_search, web_read_page). Eigenes Python eignet sich für fachliche Logik, etwa Berechnungen, interne API-Aufrufe oder die Steuerung von Workflows. Datenbank-Tools sollten in eigene Funktionen eingebunden werden, die genau die benötigte Aufgabe abdecken.

Ja. Das vordefinierte Tool trigger_agent lässt den aufrufenden Agenten einen anderen Agenten im selben Projekt über dessen Namen starten und optional auf die Antwort warten. trigger_agent_at plant einen zukünftigen Run per Verzögerung oder absolutem Timestamp, bis zu 30 Tage im Voraus.