Zum Inhalt springen
OmniChannels.ai

KI-Assistenten und Agenten

LlamaIndex + OmniChannels.ai: Messaging-Tools für Ihre Agenten

Verbindung über MCPVerbindung über API & WebhooksAktualisiert

Kurze Antwort

LlamaIndex-Agenten nutzen OmniChannels.ai über unseren Remote-MCP-Server. Mit llama-index-tools-mcp macht ein BasicMCPClient, der auf https://mcp.broadnet.me/mcp zeigt und in McpToolSpec eingebettet ist, unsere Tools für Versand, Vorlagen und Zustellberichte zu Agenten-Tools. Unser Server verlangt einen Authorization: Bearer-Header; prüfen Sie in der Dokumentation des Pakets, wie Ihre Version ihn setzt, oder rufen Sie unsere REST API aus eigenen Tools auf.

Was Sie damit tun können

  • Zustell-Support-Agent nur mit Lese-Tools

    Behalten Sie nur die Lese-Tools, damit der Agent Fragen zur Zustellung beantwortet, ohne senden zu können.

    Beispielanfrage

    “Bau einen Agenten, der Fragen zur Zustellung nur mit Lese-Tools beantwortet und jede Anfrage zum Senden einer Nachricht ablehnt.”

  • Aus Ihren Dokumenten antworten, über Tools handeln

    Kombinieren Sie eine Query Engine über Ihre eigenen Richtlinien mit unseren Messaging-Tools, damit Antworten Ihren Regeln folgen, bevor etwas gesendet wird.

    Beispielanfrage

    “Bau einen Agenten, der unseren Index zur Erstattungsrichtlinie prüft, eine WhatsApp-Antwort auf Arabisch und Englisch entwirft und mich fragt, bevor er sie an 971500000000 sendet.”

  • Vorlagenbewusster Workflow

    Der Agent listet freigegebene WhatsApp-Vorlagen auf und befüllt die Variablen für vom Unternehmen initiierte Nachrichten außerhalb des 24-Stunden-Fensters.

    Beispielanfrage

    “Schreib einen Workflow, der die freigegebene Vorlage appointment_reminder findet und sie nach meiner Freigabe mit dem Zeitfenster von morgen an 966500000000 sendet.”

  • Schlanke REST-Tools

    Kapseln Sie eine einzelne REST-Operation in einem FunctionTool, wenn Sie volle Kontrolle über Felder, Validierung und Logging wollen.

    Beispielanfrage

    “Schreib ein LlamaIndex-FunctionTool, das per POST /sms/sendSms eine SMS sendet und BROADNET_TOKEN aus der Umgebung liest.”

  • Fehleranalyse

    Der Agent liest Zustellberichte und gruppiert Fehlschläge für Ihr Operations-Team nach Grund.

    Beispielanfrage

    “Erstell einen Agenten, der die Zustellberichte von gestern liest und FAILED- und REJECTED-Nachrichten nach Grund und Kanal zusammenfasst.”

So funktioniert die Verbindung

Verbindung über MCPVerbindung über API & Webhooks

llama-index-tools-mcp stellt BasicMCPClient bereit, der sich per URL mit einem Remote-MCP-Server verbindet, sowie McpToolSpec, das die Tools dieses Servers in eine Tool-Liste für einen LlamaIndex-Agenten umwandelt. Richten Sie den Client auf https://mcp.broadnet.me/mcp, einen Streamable-HTTP-Endpunkt. Jede Anfrage an unseren Server muss einen Authorization: Bearer-Header enthalten; wie Sie ihn setzen, etwa über einen eigenen HTTP-Client, hängt von der Paketversion ab, prüfen Sie daher deren Dokumentation.

Filtern Sie die Tool-Liste, damit jeder Agent nur die Tools hat, die er braucht, und fügen Sie vor jedem Versand einen Bestätigungsschritt ein. Passt die Header-Option Ihrer Version nicht, schreiben Sie eigene FunctionTool-Wrapper um unsere REST API mit einem Bearer-Token und nutzen die OpenAPI-3.1-Spezifikation für die exakten Felder; Einzel-SMS nutzt JSON, Massenversand und die meisten anderen Kanäle nutzen multipart/form-data.

  • MCP: BasicMCPClient für https://mcp.broadnet.me/mcp, eingebettet in McpToolSpec
  • Authorization: Bearer-Header bei jeder Anfrage erforderlich
  • Tools nach Namen filtern und vor jedem Versand bestätigen
  • REST-Alternative: FunctionTool-Wrapper auf Basis der OpenAPI-3.1-Spezifikation

Einrichtung

  1. 1

    API-Zugang anfordern

    Fordern Sie einen Testzugang an und erhalten Sie ein API-Token. Testnachrichten gehen nur an Ihre eigenen verifizierten Nummern.

  2. 2

    Temporären Schlüssel abrufen

    Öffnen Sie im Admin-Portal Integrations und dann MCP Integration, wählen Sie Get temporary key und setzen Sie ihn als BROADNET_TOKEN.

    Anleitung: MCP server for AI agents
  3. 3

    llama-index-tools-mcp installieren

    Installieren Sie das Paket und prüfen Sie in seiner Dokumentation, wie Ihre Version benutzerdefinierte Header an einen Remote-Server übergibt.

  4. 4

    Tools laden

    Erstellen Sie einen BasicMCPClient für unsere URL mit dem Authorization-Header, betten Sie ihn in McpToolSpec ein und rufen Sie die Tool-Liste ab.

    Anleitung: MCP server for AI agents
  5. 5

    Einschränken und absichern

    Übergeben Sie dem Agenten nur die Tools, die er braucht, und verlangen Sie vor jedem Tool, das sendet, eine Bestätigung.

  6. 6

    Mit Ihrer eigenen Nummer testen

    Lassen Sie den Agenten mit Ihrer verifizierten Nummer laufen und prüfen Sie den Zustellbericht, bevor Sie den Zugriff erweitern.

Dokumentation des Anbieters

LlamaIndex ist eine Marke ihres Inhabers. OmniChannels.ai ist weder mit LlamaIndex verbunden noch von LlamaIndex unterstützt; diese Seite beschreibt eine Verbindung über die eigenen MCP-, HTTP- oder Webhook-Funktionen von LlamaIndex.

Beispiel-Workflow

So läuft eine typische Anfrage von LlamaIndex zu Ihrem Kunden und zurück.

  1. 01

    Ihr LlamaIndex-Agent

    Agent oder Workflow mit Tools aus McpToolSpec

  2. 02

    OmniChannels.ai MCP-Server

    Tools für Versand, Vorlagen und Zustellberichte

  3. 03

    Telefon des Kunden

    SMS-, WhatsApp- oder RCS-Nachricht zugestellt

  4. 04

    Zustellbericht

    Vom Agenten ausgelesen oder an Ihren Webhook gesendet

1. Ihr LlamaIndex-Agent: Agent oder Workflow mit Tools aus McpToolSpec 2. OmniChannels.ai MCP-Server: Tools für Versand, Vorlagen und Zustellberichte 3. Telefon des Kunden: SMS-, WhatsApp- oder RCS-Nachricht zugestellt 4. Zustellbericht: Vom Agenten ausgelesen oder an Ihren Webhook gesendet

Fragen

Gibt es eine offizielle OmniChannels.ai-Integration für LlamaIndex?

Nein. LlamaIndex verbindet sich über sein generisches MCP-Tools-Paket, mit unserem öffentlichen Endpunkt und Ihrem API-Token, oder über Tools, die Sie für unsere REST API schreiben.

Wie übergebe ich das API-Token?

Unser Server braucht bei jeder Anfrage einen Authorization: Bearer-Header. Wie llama-index-tools-mcp benutzerdefinierte Header setzt, hängt von der Version ab; folgen Sie daher der aktuellen Dokumentation. Passt das nicht zu Ihrem Setup, rufen Sie stattdessen die REST API aus eigenen Tools auf.

Kann der Agent über diesen Server meine Dokumente oder mein CRM lesen?

Nein. Unser Server deckt nur Messaging, Vorlagen und Zustellberichte ab. Ihre Dokumente stammen aus Ihren eigenen LlamaIndex-Indizes, andere Systeme werden über deren eigene Tools oder MCP-Server angebunden.

Wie verhindere ich, dass der Agent versehentlich sendet?

Geben Sie ihm nur die Tools, die er braucht, lassen Sie Sende-Tools bei Agenten weg, die nur Fragen beantworten, und lassen Sie jeden Versand von einer Person bestätigen. Verwenden Sie beim Testen einen temporären Schlüssel und Ihre eigenen Nummern.

API- und MCP-Zugang erhalten

Nennen Sie uns Kanäle, Länder und Anwendungsfall. Ein Engineer stellt Testzugangsdaten aus und verifiziert Ihre Testnummern.