Übersicht · Aiqbee Hive

Aiqbee Hive ist ein selbst gehosteter Wissensgraph, der von KI-Agenten gelesen und beschrieben werden soll. Er läuft als einzelner Container mit PostgreSQL dahinter und bietet zwei Zugänge:

MCP (Model Context Protocol) – 34 Tools, die ein LLM direkt aufrufen kann. Dies ist die primäre Schnittstelle und die richtige Wahl beim Bau eines Agenten oder Assistenten.
REST (/api/v1) – eine kleine Verwaltungs-API für Bereitstellung und Automatisierung: Brains erstellen, auflisten, Einstellungen patchen. Nicht für Agentenverkehr gedacht.

Das Vokabular

Begriff	Was es ist
Brain	Ein Wissensgraph. Der Zugriff wird pro Brain erteilt, und eine MCP-Verbindung ist auf genau eines beschränkt.
Neuron	Eine Wissenseinheit – ein Titel plus Inhalt, optional datiert. Wird beim Schreiben eingebettet und ist dadurch semantisch durchsuchbar.
Neuronentyp	Eine Kategorie (Entscheidung, Besprechungsnotiz, Standard). Typen können unter „Erweiterte Sicherheit“ eigene Zugriffsregeln erhalten.
Synapse	Eine beschriebene Verbindung zwischen zwei Neuronen. Die Beschreibung ist wichtig – sie ermöglicht es einem Agenten zu erklären, warum zwei Dinge zusammenhängen.
Dienstkonto	Eine nicht menschliche Identität mit eigenen Client-Anmeldedaten. Als diese sollte sich Ihre Integration authentifizieren.

Wie ein Brain seine Form erhält

Neuronentypen sind das Schema, und sie gelten pro Brain. Vor dem Schreiben sollte ein Agent aiqbee_get_neuron_types aufrufen und eine echte Typ-ID verwenden – sie sind nicht erratbar, und eine falsche ID wird abgelehnt. Typen können mit aiqbee_add_neuron_type spontan angelegt werden, doch ein Brain mit vierzig nahezu doppelten Typen ist schlechter als eines mit acht guten. Verwenden Sie daher bevorzugt Vorhandenes wieder.

Wie es weitergeht

Integrationsmuster – lesen Sie dies, bevor Sie Code schreiben.
Verbindung über MCP – Einrichtung des Dienstkontos und ein funktionierender Aufruf.
Tool-Referenz – alle 34 Tools.
OKF-Export & -Import – ein Brain als portables Markdown-Bundle verschieben.