Für Entwickler
coreAI bietet Entwicklern eine API, mit der sich ein Assistent mit eigenen Daten befüllen und dieselben Daten in Chat und Suche nutzen lassen. Geeignet, wenn ein Produkt, CMS, PIM, ERP oder Fachsystem seine Inhalte in einem coreAI-Assistenten verfügbar machen soll.
Die API-Integration nutzt stabile externe IDs und Upsert-Aufrufe, um die Wissensdatenbank mit Ihrem System synchron zu halten. Wird bei Ihnen ein Objekt angelegt oder geändert, schicken Sie die aktualisierte Entität an coreAI.
Die Produktionsumgebung liegt auf `https://portal.coreai.no/api/v2`, die Testumgebung auf `https://stage.coreai.no/api/v2`. Die Aufrufe nutzen Bearer-Tokens, `assistantId` verweist auf den antwortenden Assistenten, und `contentImporterId` verweist auf die API-Quelle, in der die Daten gespeichert werden.
Upsert per `POST /assistants/{assistantId}/sources/{contentImporterId}` ersetzt die gesamte Entität. `PATCH` lässt sich für kleinere Änderungen nutzen, `DELETE` entfernt Entitäten, die keine Antworten mehr liefern sollen, und `GET` erlaubt der Integration, eine oder mehrere Entitäten über externe IDs auszulesen.
Der MCP-Import in coreAI findet Tools auf einem externen MCP-Server. Die Tools werden dem Assistenten zu Beginn einer Konversation verfügbar gemacht, und der Assistent wählt das passende Tool, um dem Nutzer zu antworten. Ist der Nutzer angemeldet, lassen sich Antworten auf dessen eigene Vorgänge in einem Fachsystem beschränken.
So funktioniert der MCP-ImportcoreAI kann die Wissensdatenbank als MCP-Server bereitstellen, sodass externe KI-Agenten den Inhalt des Assistenten über ein standardisiertes Protokoll abfragen können. Ihr Team kann dieselben kuratierten Quellen in eigenen Agenten-Werkzeugen, IDEs und internen Workflows nutzen.
So funktioniert der MCP-ServercoreAI kann mehrere Datentypen indexieren, sodass der Assistent den Unterschied zwischen Produktdaten, Dokumentation, Veranstaltungen, Schulungen, Stellen und Kontaktpersonen versteht. Das macht Antworten präziser als ein flacher Textimport.
Die Entitätstypen im Detail ansehenSind die Daten im Assistenten, können Nutzer ihnen über das coreAI-Widget, eine selbst entwickelte Chat-Oberfläche oder eine reine Wissensdatenbanksuche begegnen. Sie entscheiden, wie viel der Erfahrung Sie selbst bauen.
Den vollständigen API-Integrationsleitfaden ansehenSetzen Sie eine `callbackUrl` auf dem Assistenten, ruft coreAI Ihre eigene URL beim Laden des Widgets mit dem Token des Nutzers auf. Das Token wird einmal pro Seitenaufruf validiert, und die Anmeldung bleibt bei Ihnen.
So schützen Sie den AssistentenDie beste coreAI-Integration lässt das Quellsystem die Wahrheit besitzen und nutzt die API, um den Assistenten aktuell zu halten. So bekommen Nutzer frische Antworten, und das Entwicklerteam erspart sich manuelle Importe.
Beginnen Sie mit stabilen IDs, klaren Datentypen und Feldern, die sich für Filterung nutzen lassen. Anschließend können Sie entscheiden, ob der Endnutzer dem Assistenten im coreAI-Widget, in einer eigenen Chat-Oberfläche oder als Suche innerhalb Ihres Produkts begegnen soll.