FirstSpirit AI Suite
Dokumentation

KI-natives Arbeiten (API, MCP)

Diese Seite beschreibt die verfügbaren Integrationspunkte: die FirstSpirit AI API für benutzerdefinierte Skripte und Modul-Aktionen sowie den FirstSpirit MCP Connector, mit dem externe Funktionsserver an KI-Operationen angebunden werden.

Die FirstSpirit AI API

Die FirstSpirit AI API bietet die Möglichkeit, generative KI in benutzerdefinierte FirstSpirit-Skripte und Modul-Aktionen zu integrieren. Sie können über den SpecialistBroker und einen GenerativeAIAgent auf die API zugreifen.

Beispiel:

import de.espirit.firstspirit.ai.GenerativeAIAgent; 
import de.espirit.firstspirit.ai.dto.*; 
GenerativeAIAgent ai = context.requireSpecialist(GenerativeAIAgent.TYPE);
Optional<String> idea = ai.request("Generate an idea for a new article");

Die Verbindung zwischen der FirstSpirit AI API und einem externen Anbieter generativer KI wird über das GenerativeAIConnectorPlugin hergestellt. Dieses Plugin ist als Modul implementiert und stellt die Verbindung zu einer externen generativen KI-API dar.

Konfigurieren des MCP Connector

Die Konfiguration des MCP-Connector-Moduls ist nur möglich, wenn Sie einen lokalen FirstSpirit-Server betreiben. Wenn Sie Cloud-Kunde sind und einen MCP-Server anbinden möchten, wenden Sie sich an Ihren FirstSpirit-Ansprechpartner.

MCP (Model Context Protocol) ist ein Protokoll zur Anbindung von KI-Tools und deren Funktionen. Wenn ein MCP-Server angebunden ist, stehen seine Funktionen im ContentCreator in Prompts für Operationen zur Verfügung.

Das FirstSpirit MCP Connector-Modul eröffnet neue Möglichkeiten für eine effiziente, flexible und zukunftsorientierte Erstellung von Inhalten. Durch die Anbindung externer MCP-Server über das FirstSpirit MCP Connector-Modul können nun auch externe Informationen für die Erstellung KI-basierter Inhalte genutzt werden. Diese Anbindung bildet die Grundlage für eine intelligente, automatisierte Inhaltserstellung. So können zum Beispiel zentral verwaltete Tone-of-Voice-Regeln von externen Servern bei der KI-basierten Texterstellung berücksichtigt werden.

Das FirstSpirit MCP Connector-Modul basiert auf dem GenerativeAIFunctionServerPlugin. Dieses Plugin ermöglicht die Entwicklung benutzerdefinierter Module, die gezielt auf Ihre Anwendungsfälle zugeschnitten sind. So können Sie auch Dienste anbinden, die keinen Remote-MCP-Server bereitstellen.

Dies ist eine clientseitige Integration. FirstSpirit stellt eine ausgehende Verbindung zum externen MCP-Server her.

So verbinden Sie einen MCP-Server mit FirstSpirit:

  • Navigieren Sie zu ServerManager > Server > Eigenschaften > Module > FirstSpirit MCP Connector.
  • Wählen Sie den Service MCP Connector Configuration aus.
  • Klicken Sie auf Konfigurieren.
    → Das Fenster Konfiguration wird geöffnet. Alle bisher konfigurierten MCP-Server werden hier aufgelistet.
  • Klicken Sie auf Create.
    → Das Fenster MCP server wird geöffnet.
  • Geben Sie im Feld Name einen Anzeigenamen, die Server-URL und, falls erforderlich, den zugehörigen API-Schlüssel ein.
  • Klicken Sie auf Test, um die Verbindung zu überprüfen.
    → Wenn die Verbindung erfolgreich ist, wird die Meldung „Connection successful“ angezeigt.
  • Klicken Sie auf Create, um die Konfiguration zu speichern.
    → Die Funktionen des konfigurierten Servers stehen jetzt in der Prompt-Konfiguration zur Verfügung.

Wenn ein Remote-MCP-Server erfolgreich angebunden ist, können die vom Server bereitgestellten Funktionen in Operationen verwendet werden. In der Prompt-Konfiguration werden nur diejenigen Funktionen angezeigt, die in den Spezifikationen des MCP-Servers als „read only“ definiert sind. Ist für eine Funktion keine Annotation vorhanden, wird sie ebenfalls angezeigt.

Seiteninhalte