KI-gestützte Imkerei-Automatisierung

b.tree Agent API — KI für Ihre Imkerei

Die b.tree Agent API ist ein dedizierter Endpunkt, der externen KI-Agenten und LLM-Assistenten (Claude, ChatGPT, eigene Bots, ClawBot, MCP-kompatible Agenten) den programmatischen Zugriff auf Ihre Imkereidaten ermöglicht. Stellen Sie es sich so vor, als würden Sie Ihrem KI-Assistenten ein eigenes Set an Imkerei-Werkzeugen geben.

Ob Claude Desktop, ChatGPT mit Custom Actions, ein Zapier KI-Workflow oder ein selbst gebauter Agent — b.tree bietet vollen Lese- und Schreibzugriff auf Ihren Imkereibetrieb über die sichere Agent API (OpenAPI), mit MCP als Alternative.

Warum die Agent API nutzen?

  • Imkerei in natürlicher Sprache — Bitten Sie Ihre KI „erstelle einen Fütterungseintrag für alle Völker am Waldstand” und es funktioniert einfach
  • Automatisierung — Erstellen Sie Workflows, die automatisch Kontrollen protokollieren, Behandlungen planen oder Erntedaten analysieren
  • Zugriff auf 25+ Werkzeuge — Ihr KI-Agent kann erstellen, lesen, aktualisieren und löschen: Fütterungen, Behandlungen, Ernten, Kontrollen, Todos, Kosten, Statistiken, Wetter und mehr
  • OpenAPI Discovery — Ihr Agent kann alle verfügbaren Endpunkte und deren Schemas automatisch erkennen
  • Sicher — API-Schlüssel werden mit SHA-256 gehasht, pro Benutzer, mit optionalem Ablaufdatum

Erste Schritte

1. Agent Key generieren

Navigieren Sie zu Einstellungen → Profil → Agent Keys in Ihrem b.tree Konto.

Klicken Sie auf “Agent Key erstellen” und setzen Sie optional:

  • Eine Bezeichnung (z.B. “Claude Desktop”, “Meine Automatisierung”)
  • Ein Ablaufdatum (leer lassen für permanenten Zugang)

⚠️ Wichtig: Der API-Schlüssel wird nur einmal nach der Erstellung angezeigt. Kopieren Sie ihn sofort und speichern Sie ihn sicher. Er kann später nicht mehr abgerufen werden.

Ihr Schlüssel sieht so aus: btree_ak_a1B2c3D4e5F6g7H8i9J0...

2. Authentifizierung

Fügen Sie Ihren Schlüssel in den Authorization-Header jeder Anfrage ein:

Authorization: Bearer btree_ak_ihr_schluessel

3. Verfügbare Tools entdecken

Rufen Sie die vollständige OpenAPI-Spezifikation ab, um alle verfügbaren Endpunkte und deren Parameter zu sehen:

GET https://api.btree.at/api/v1/agent/openapi.json
Authorization: Bearer btree_ak_ihr_schluessel

Dies gibt eine OpenAPI 3.1 Spezifikation zurück, die jeder kompatible Agent oder jedes Tool automatisch parsen kann.

4. Tools aufrufen

Jedes Tool ist als POST-Endpunkt verfügbar:

POST https://api.btree.at/api/v1/agent/tools/{toolName}
Authorization: Bearer btree_ak_ihr_schluessel
Content-Type: application/json

{ ... Parameter als JSON ... }

Beispiel — Stände und Völker auflisten:

POST /api/v1/agent/tools/listApiariesHives
{ "includeInactive": false }

Rate-Limits

Die Agent API ist auf 60 Anfragen pro Minute pro API-Schlüssel limitiert. Das ist großzügig für interaktive KI-Nutzung und Automatisierung, verhindert aber Missbrauch.

Bei Überschreitung erhalten Sie einen 429 Too Many Requests-Status mit einem Retry-After-Header, der angibt, wann Sie fortfahren können.

Sicherheits-Best-Practices

  • Schlüssel regelmäßig rotieren — Erstellen Sie neue Schlüssel und löschen Sie alte periodisch
  • Ablaufdaten verwenden — Setzen Sie valid_to, wenn der Schlüssel nur temporär aktiv sein soll
  • Schlüssel beschriften — Benennen Sie sie nach dem Agenten oder Dienst, der sie verwendet
  • Letzte Nutzung prüfen — Kontrollieren Sie den „Zuletzt verwendet”-Zeitstempel, um ungenutzte Schlüssel zu identifizieren
  • Ungenutzte Schlüssel löschen — Wenn ein Agent nicht mehr verwendet wird, widerrufen Sie den Schlüssel sofort

Schlüssel werden vor der Speicherung mit SHA-256 + individuellem Salt gehasht. Selbst im unwahrscheinlichen Fall eines Datenbankeinbruchs können Ihre Klartext-Schlüssel nicht wiederhergestellt werden.

Wenn Ihr Konto oder Ihre Imkerei gelöscht wird, werden alle zugehörigen Agent Keys automatisch entfernt.

Ihren KI-Agenten oder Skill einrichten

Auf der Agent Keys Seite in b.tree finden Sie einen gebrauchsfertigen Skill-Installations-Prompt. Kopieren Sie ihn und fügen Sie ihn in Ihren KI-Agenten oder Skill-Editor ein. Der Prompt erklärt:

  • Wie man sich bei der b.tree API authentifiziert
  • Wie man verfügbare Tools über OpenAPI entdeckt
  • Die b.tree Datenmodell-Konventionen
  • Best Practices für das Erstellen und Aktualisieren von Einträgen

b.tree als Custom Skill installieren

Anstatt einen Custom GPT oder einen eigenen Agenten zu erstellen, können Sie den Installations-Prompt auf einer unterstützten KI-Plattform in einen wiederverwendbaren Skill umwandeln:

Öffnen Sie den gewünschten Skill-Editor. Kopieren Sie danach den Skill-Installations-Prompt von der b.tree Agent Keys Seite und fügen Sie ihn in den Editor ein. Folgen Sie den Anweisungen der Plattform, um den Skill zu erstellen.

Alternative: Wenn Sie ChatGPT nutzen, können Sie auch den fertigen b.tree Custom GPT mit OAuth-Login verwenden: b.tree Imkerei Manager DE oder b.tree Beekeeping Manager EN.

Anwendungsfälle

  • Sprachgesteuerte Imkerei — „Hey Claude, protokolliere eine Fütterung mit 3:2 Zuckerwasser für alle Völker am Wiesenstand”
  • Automatische Berichte — Lassen Sie Ihren Agenten wöchentliche Zusammenfassungen von Behandlungen und Kontrollen erstellen
  • Wiederkehrende Aufgaben — Richten Sie Agenten ein, die saisonale Fütterungs- oder Behandlungspläne erstellen
  • Wetterbasierte Verwaltung — Agenten können das Standwetter prüfen, bevor sie Maßnahmen vorschlagen
  • Plattformübergreifend — Funktioniert mit jedem KI-Agenten, der HTTP-Tool-Aufrufe unterstützt

Alternative: MCP

Für ChatGPT, Claude, VS Code und andere Clients, die entfernte Model Context Protocol (MCP)-Server unterstützen, ist MCP eine alternative Verbindungsmöglichkeit. Dabei stehen dieselben Werkzeuge wie in WizBee über Streamable HTTP bereit. Die Anmeldung erfolgt über OAuth—ein API-Schlüssel muss nicht in den KI-Client kopiert werden.

MCP-Client verbinden

  1. Öffnen Sie in b.tree Einstellungen → Profil → MCP.
  2. Kopieren Sie die MCP-Server-URL für Ihre ausgewählte b.tree-Region.
  3. Fügen Sie die URL in Ihrem KI-Client als Remote-MCP-Server hinzu.
  4. Ihr Browser öffnet b.tree. Melden Sie sich an, prüfen Sie den angeforderten Zugriff und stimmen Sie zu.
  5. Kehren Sie zu Ihrem KI-Client zurück und verwenden Sie die b.tree-Werkzeuge.

Für die EU-Region lautet die Server-URL:

https://api.btree.at/api/v1/mcp

Die MCP-Verbindung verwendet die Imkerei und die Rolle, die bei Ihrer Zustimmung aktiv sind. Benutzer mit Lesezugriff können keine schreibenden Werkzeuge verwenden. MCP ist ein Premium-Feature und kann jederzeit unter Einstellungen → Profil → MCP widerrufen werden.

Beispiel: Mistral AI

Wenn Sie einen europäischen KI-Anbieter bevorzugen, können Sie mit Mistral AI Ihre Imkerei über b.tree MCP verwalten. Öffnen Sie Verbindungen in Le Chat, fügen Sie die oben angegebene b.tree-MCP-Server-URL hinzu und bestätigen Sie den Zugriff über die b.tree-OAuth-Anmeldung.

Nach der Verbindung können Sie Mistral beispielsweise bitten, Ihre Bienenstände aufzulisten, eine Fütterung zu erfassen oder Ihre letzten Durchsichten auszuwerten.

Die oben beschriebene Agent API ist der empfohlene Einstieg für Automatisierungen mit OpenAPI oder direkten HTTP-Aufrufen. Die Agent API nutzt einen manuell erstellten Schlüssel.

Die Agent API ist ein Premium-Feature. Upgraden Sie Ihr Konto um zu starten.

© 2014-2026 - b.tree by Hannes Oberreiter