Dieser Leitfaden erklärt die KI-Tools und Berechtigungen der Modelle, die Bliros agentische Integrationen antreiben. Er richtet sich an IT-, Sicherheits- und CRM-Verantwortliche, die verstehen möchten, wie Bliros KI-Agenten auf Drittsystemen agieren und wie diese Aktivität kontrolliert wird.
Nicht jede in diesem Artikel beschriebene Funktion ist für jede Integration verfügbar — manche Integrationsziele unterstützen nur einen Teil der unten beschriebenen Tools, Feldkontrollen oder Konfigurationsoptionen. Wenn eine Option für eine bestimmte Integration nicht verfügbar ist, erscheint sie in den Einstellungen dieser Integration einfach nicht.
Überblick
Bliros KI-Agenten agieren auf verbundenen Integrationen (CRM, Kalender, Kommunikationsplattformen und andere) über einen festen Satz von Tools. Jedes Tool repräsentiert eine spezifische Aktion auf einem spezifischen Objekttyp, und jedes Tool hat eine Berechtigungsstufe, die steuert, wann und ob Bliros Agenten es verwenden dürfen. Tools und Berechtigungen werden von Organisationsadministratoren konfiguriert und gelten für die gesamte Bliro-Organisation.
Was ist ein Tool
Ein Tool ist eine einzelne, klar definierte Aktion auf einem bestimmten Objekt in einem verbundenen System. Jedes Tool wird durch drei Felder definiert:
Feld | Beschreibung |
Titel | Automatisch generiert als <Operation> <Objekt>, zum Beispiel „Account lesen", „Kontakt erstellen", „Lead aktualisieren", „Opportunity suchen". |
Beschreibung | Eine natürliche-sprachliche Beschreibung, die Bliros KI-Agent mitteilt, wann das Tool passend einzusetzen ist. |
Berechtigung | Eine der Stufen: Immer erlauben, Um Erlaubnis fragen oder Verweigern. Siehe unten. |
Tools folgen einer strikten Ein-Objekt-pro-Operation-Regel: Ein einzelnes Tool führt immer genau eine Operation (Lesen, Erstellen, Aktualisieren oder Suchen) auf genau einem Objekttyp aus. Mehrstufige Aktionen werden vom KI-Agenten aus mehreren Tool-Aufrufen zusammengesetzt.
Vordefinierte und benutzerdefinierte Tools
Jede agentische Integration wird mit einem vordefinierten Katalog von Tools mit sinnvollen Standardberechtigungen ausgeliefert, sodass die Integration sofort nach dem Verbinden nutzbar ist.
Für CRM-Integrationen können Administratoren zusätzlich benutzerdefinierte Tools erstellen, indem sie ein CRM-Objekt auswählen, das noch nicht abgedeckt ist. Bliro generiert automatisch die entsprechenden Tools zum Lesen, Erstellen, Aktualisieren und Suchen für dieses Objekt. Du kannst einschränken, welche Felder jedes Tool offenlegt (siehe „Welche CRM-Felder der Agent sehen darf" weiter unten), oder für fortgeschrittene Fälle die Ein- und Ausgaben eines Tools mit einem benutzerdefinierten JSON-Schema festlegen (siehe „Erweitert: Tools mit benutzerdefiniertem JSON-Schema" weiter unten). Die Erstellung benutzerdefinierter Tools ist derzeit nur für CRM-Integrationen verfügbar.
Welche CRM-Felder der Agent sehen darf
Standardmäßig legt ein CRM-Tool jedes Feld offen, das Bliro für dieses Objekt lesen oder schreiben kann. Administratoren können dies pro Tool einschränken:
Bei Lese-Tools: einschränken, welche Felder an den Agenten zurückgegeben werden.
Bei Erstellen- und Aktualisieren-Tools: einschränken, welche Felder der Agent senden darf, und welche Felder im Ergebnis zurückgegeben werden.
Felder, die aus der Liste eines Tools entfernt wurden, sind für Bliros KI-Agenten bei diesem Tool unsichtbar — er kann sie weder lesen, empfangen noch setzen, selbst wenn ein anderes Tool dieselben Felder offenlegt.
So konfigurierst du die Feldauswahl:
Öffne in Bliro die Integrationen und wähle die CRM-Integration aus.
Öffne im Bereich Tools & Berechtigungen das Tool, das du einschränken möchtest.
Wähle unter Felder aus, welche Felder für Lesen (zurückgegebene Felder) oder für Erstellen/Aktualisieren (Eingabefelder und zurückgegebene Felder) einbezogen werden sollen.
Speichere deine Änderungen.
Erweitert: Tools mit benutzerdefiniertem JSON-Schema (für erfahrene Nutzer)
Für CRM-Objekte mit ungewöhnlicher Struktur, oder wenn du genaue Kontrolle darüber brauchst, welche Parameter der Agent senden kann und in welcher Form er die Antwort erhält, unterstützt Bliro, die Ein- und Ausgabe eines Tools vollständig über ein handgeschriebenes JSON-Schema zu definieren, anstatt es automatisch aus dem CRM-Objekt zu generieren.
Dies ist eine erweiterte Option für Teams, die mit dem Verfassen von JSON-Schemas vertraut sind und die zugrunde liegenden Feld-/API-Namen ihres CRM-Systems kennen. Ein fehlerhaft konfiguriertes Schema kann dazu führen, dass ein Tool fehlschlägt oder gültige Anfragen des Agenten ablehnt.
So verwendest du es:
Öffne in Bliro die Integrationen und wähle die CRM-Integration aus.
Klicke auf Tool hinzufügen und wähle Erweitert (anstelle der Standardauswahl eines CRM-Objekts).
Füge das JSON-Schema für die Eingaben und optional für die Ausgaben des Tools ein.
Konfiguriere die Berechtigungsstufe wie bei jedem anderen Tool.
Wir empfehlen, den oben beschriebenen Standardweg über ein CRM-Objekt zu verwenden, sofern kein spezifischer Grund für die volle Schema-Kontrolle vorliegt.
Einen dauerhaften Filter auf ein Advanced-Suchtool setzen
Für Suchen-Untertools, die mit einem handgeschriebenen JSON-Schema erstellt wurden (siehe oben "Erweitert: Tools mit benutzerdefiniertem JSON-Schema"), können Administratoren einen dauerhaften Filter festlegen, der bei jeder Suche gilt, die der KI-Agent mit diesem Tool ausführt. Der Filter wird einmal im JSON des Tools gesetzt und kann weder vom KI-Agenten noch vom Nutzer entfernt oder überschrieben werden. Typischer Einsatz ist das Ausschließen deaktivierter oder archivierter Datensätze, damit der Agent nur noch relevante Datensätze zurückgibt. Ohne dauerhaften Filter gibt eine Suche alle Datensätze zurück, die zum Suchbegriff passen - auch archivierte und inaktive - und du musst die veralteten Einträge selbst erkennen.
Diese Option steht nur für Suchen-Tools zur Verfügung, die im Advanced-Modus konfiguriert sind. Das Standard-Suchen-Tool aus der CRM-Objektauswahl unterstützt keinen dauerhaften Filter.
So setzt du einen dauerhaften Filter auf ein Advanced-CRM-Suchtool:
Öffne in Bliro die Integrationen und wähle die CRM-Integration aus.
Öffne im Bereich Tools & Berechtigungen das Advanced-Tool, dessen Suchen-Untertool du einschränken möchtest (oder klicke auf Tool hinzufügen → Erweitert, um eines zu erstellen).
Füge im JSON des Tools unter
searcheinfilter-Array hinzu, mit einem Eintrag pro Bedingung - jeweils mitfield,op(eq,ne,gt,ge,lt,le,in,is_null,is_not_null) undvalue. Beispiel zum Ausschließen deaktivierter Datensätze:"search": { "filter": [{ "field": "statuscode", "op": "ne", "value": 2 }] }
Speichere deine Änderungen. Der Filter gilt ab jetzt für jede Suche, die der KI-Agent mit diesem Tool ausführt.
Ein dauerhafter Filter schränkt Ergebnisse ein, er erweitert keine Zugriffe. Er kann dem KI-Agenten keinen Zugriff auf Datensätze geben, die der verbundene Nutzer ohnehin nicht sehen darf.
Den KI-Agenten Advanced-Suchen selbst einschränken lassen
Zusätzlich zum dauerhaften Filter können Administratoren im JSON eines Suchen-Untertools eine filterableFields-Liste hinzufügen, die Felder benennt, nach denen der KI-Agent selbst filtern darf. Der Agent setzt dann einen Filter, wenn es zur Anfrage passt - zum Beispiel nur offene Opportunities abzufragen - und trifft so in einem Schritt den richtigen Datensatz, anstatt eine lange Ergebnisliste abzuarbeiten. Der Agent kann ausschließlich nach den Feldern in dieser Liste filtern; alle anderen Felder bleiben für ihn nicht verfügbar.
Diese Option steht nur für Suchen-Tools zur Verfügung, die im Advanced-Modus konfiguriert sind.
So veröffentlichst du filterbare Felder für ein Advanced-CRM-Suchtool:
Öffne in Bliro die Integrationen und wähle die CRM-Integration aus.
Öffne im Bereich Tools & Berechtigungen das Advanced-Tool mit dem Suchen-Untertool.
Füge im JSON des Tools unter
searcheinfilterableFields-Array hinzu, mit einem Eintrag pro Feld, jeweils mitfield,typeund den erlaubtenops(Standardeq), optional einem geschlossenenenuman Werten und einerdescription. Beispiel:"search": { "filterableFields": [ { "field": "industrycode", "type": "string", "ops": ["eq"], "description": "Branche" } ] }
Speichere deine Änderungen.
Halte diese Liste kurz. Zwei bis vier Felder, die klar abbilden, wie dein Team Datensätze qualifiziert, funktionieren am besten; jedes zusätzliche Feld gibt dem KI-Agenten eine weitere Option und macht seine Entscheidung weniger vorhersehbar. Der dauerhafte Filter gilt immer zusätzlich: Ein Filter, den der Agent wählt, schränkt das Ergebnis weiter ein, er überschreibt den gesetzten Filter nie.
Berechtigungsstufen
Jedes Tool - ob vordefiniert oder benutzerdefiniert - muss genau eine von drei Berechtigungsstufen haben.
Stufe | Verhalten | Standardmäßig angewendet auf |
Immer erlauben | Bliros KI-Agent darf das Tool ohne Rückfrage beim Benutzer aufrufen. Am besten geeignet für risikoarme Leseoperationen. | Lese- und Suche-Tools |
Um Erlaubnis fragen | Jeder Aufruf wird pausiert, bis der Benutzer ihn genehmigt. Am besten geeignet für jede Aktion mit Seiteneffekten. | Erstellen- und Aktualisieren-Tools |
Verweigern | Das Tool ist deaktiviert. Bliros KI-Agenten können es unter keinen Umständen aufrufen. | Keines. Vom Admin ausgewählt, wenn strengere Kontrolle erforderlich ist. |
Wie „Um Erlaubnis fragen" funktioniert
Wenn ein Tool auf „Um Erlaubnis fragen" gesetzt ist, führt Bliros KI-Agent das Tool niemals ohne die ausdrückliche Zustimmung des Benutzers für genau diesen Aufruf aus. Die Genehmigungsanfrage wird kontextabhängig zugestellt, je nachdem, wie der Benutzer mit dem Agenten interagiert:
Im Agenten-Chat: Ein Overlay erscheint über dem Chat-Eingabefeld und zeigt die angeforderte Aktion und ihre Parameter an. Der Benutzer genehmigt oder lehnt ab, bevor die Aktion ausgeführt wird.
In einer Telefon-Session mit dem Agenten: Der Agent bittet den Benutzer explizit um mündliche Erlaubnis, die Aktion auszuführen, bevor er sie durchführt.
Wenn der Benutzer nicht antwortet, wird die Aktion nicht ausgeführt. Die Genehmigung gilt pro Aufruf: Ein vorheriges „Ja" autorisiert keine zukünftigen Aufrufe desselben Tools.
Durchsetzung
Berechtigungsentscheidungen werden von Bliros Infrastruktur durchgesetzt - nicht durch die Befolgung von Anweisungen durch das Sprachmodell. Zwei Schichten arbeiten zusammen:
Tool-Gating an der Modellgrenze. Tools, die verweigert sind oder die der Konfiguration gar nicht hinzugefügt wurden, werden der Tool-Liste des KI-Agenten niemals bereitgestellt. Das Modell kann sie buchstäblich nicht „sehen" und kann sie daher nicht aufrufen.
Serverseitige Autorisierung bei jedem Aufruf. Jeder Tool-Aufruf, den das Modell absetzt, wird von Bliros Backend unabhängig gegen die aktuelle Berechtigungskonfiguration autorisiert, bevor er an das Drittsystem weitergeleitet wird. Ein Aufruf, der diese Schicht irgendwie für ein verweigertes Tool erreichen würde, würde abgelehnt.
Beide Schichten greifen gleichzeitig, sodass ein verweigertes Tool unter keinen Umständen ausgeführt werden kann - selbst wenn der KI-Agent es „wollte" oder eine Prompt Injection versuchen würde, ihn davon zu überzeugen.
Wo konfigurieren
Tools und Berechtigungen werden pro Integration verwaltet:
Öffne in Bliro die Integrationen und wähle die gewünschte Integration aus (zum Beispiel Microsoft Dynamics oder HubSpot).
Verwende den Bereich Tools & Berechtigungen, um Tools hinzuzufügen, zu entfernen oder neu zu konfigurieren und um Berechtigungsstufen zu ändern.
(Nur CRM) Klicke auf Tool hinzufügen, um neue Tools zu erstellen, indem du ein CRM-Objekt auswählst. Bliro generiert automatisch die Tools zum Lesen, Erstellen, Aktualisieren und Suchen für dieses Objekt. Verwende die Option Felder, um einzuschränken, welche Felder ein Tool sehen oder setzen darf, oder wähle Erweitert, um ein Tool mit einem benutzerdefinierten JSON-Schema zu definieren.
Nur Organisationsadministratoren können diese Einstellungen ändern. Änderungen gelten für die gesamte Bliro-Organisation.
Skills: Tools zu Workflows zusammensetzen
Tools definieren einzelne Aktionen. Skills setzen diese Aktionen zu wiederholbaren, mehrstufigen Workflows zusammen. Ein Skill beschreibt dem KI-Agenten, wie er eine vollständige Aufgabe erledigen soll (zum Beispiel „erstelle einen Besuchsbericht aus diesem Meeting"), indem er festlegt, welche Tools in welcher Reihenfolge aufgerufen werden, welche Daten gesammelt werden und welche Geschäftsregeln gelten.
Skills werden getrennt von Tools konfiguriert unter Einstellungen > Organisation > Skills. Ein Skill kann Tool-Berechtigungen nicht umgehen: Wenn ein Tool die Genehmigung des Nutzers erfordert, wird der Agent trotzdem nachfragen, auch wenn er innerhalb eines Skills agiert.
Eine ausführliche Erklärung, wie Skills funktionieren und wie sie konfiguriert werden, findest du unter KI-Skills.
Kontakt und Hilfe
Fragen dazu, wie ein bestimmtes Tool funktioniert, oder wie du die Standardeinstellungen für deine Organisation absichern kannst? Kontaktiere [email protected].
