KI-Serveraktionen

|KI|-Serveraktionen erweitern das Automatisierungsframework von Odoo, indem sie es künstlicher Intelligenz ermöglichen, während eines Workflows Entscheidungen zu treffen.

Sie sind für Fälle konzipiert, in denen Logik nicht vollständig durch feste Bedingungen ausgedrückt werden kann, aber dennoch eine kontrollierte Ausführung durch Standardserveraktionen erfordert.

Wie KI-Serveraktionen funktionieren

KI-gesteuerte Arbeitsabläufe in Odoo basieren auf einer klaren Aufgabenteilung zwischen der |KI|-Serveraktion oder dem Manager und dem Tool oder dem Worker.

KI-Serveraktion: der Manager

Eine |KI|-Serveraktion fungiert als Entscheidungsträger oder Manager. Sie liest den Datensatz und seinen Kontext. Sie interpretiert die |KI|-Eingabeaufforderung. Und sie entscheidet, welches Tool aufgerufen und welche Argumente verwendet werden sollen.

Die Serveraktion erzwingt keine Geschäftsregeln, ändert keine Datensätze direkt und garantiert auch nicht die Korrektheit des Vorgangs. Ihre Rolle beschränkt sich auf die Entscheidungsfindung.

KI-Tool: der Arbeiter

Ein Tool ist eine Standardaerveraktion mit der Option In KI verwenden, die im Reiter Verwendung aktiviert ist. Tools enthalten die gesamte Ausführungslogik und führen Datensatzaktualisierungen, -verschiebungen oder -schreibvorgänge durch. Tools müssen Geschäftsregeln explizit in Python-Code durchsetzen.

Wenn ein Tool von der |KI|-Serveraktion aufgerufen wird, wird es bedingungslos ausgeführt, sofern der Code selbst dies nicht verhindert.

KI-Serveraktionsablauf

Der Arbeitsablauf der |KI|-Serveraktion folgt dieser Reihenfolge:

  1. Ein Datensatz löst eine |KI|-Serveraktion aus.

  2. Die |KI|-Eingabeaufforderung wird mithilfe des Datensatzes als Kontext ausgewertet.

  3. Die |KI| wählt eines der verfügbaren Tools aus.

  4. Die |KI| liefert die vom Tool erwarteten Argumente.

  5. Das ausgewählte Tool führt seinen Python-Code aus.

Wichtig

|KI|-Serveraktionen funktionieren ohne benutzerdefinierte Logik nur dann, wenn das zugrunde liegende Verhalten bereits in Odoo vorhanden ist, z. B. das Verschieben eines Dokuments in einen Ordner. In diesen Fällen wählt die |KI| die Parameter aus und Odoo führt die Aktion aus.

Erläuterung eines Anwendungsfalls

Das Beispiel Dokumente im Posteingang automatisch sortieren veranschaulicht das gesamte Muster der |KI|-Serveraktion. Navigieren Sie zum Menü Serveraktionen, indem Sie Einstellungen ‣ Technisch ‣ Serveraktionen aufrufen.

Bemerkung

Diese Serveraktion dient dazu, Dokumente auf ihren Inhalt zu überprüfen und Stichwörter hinzuzufügen. Die Aktion selbst führt keine Verschiebung von Dokumenten oder Hinzufügung von Stichwörtern durch, sondern entscheidet lediglich anhand des Inhalts der Dokumente, welches Tool verwendet werden soll.

Das Model für die Aktion lautet Dokument, und der Typ lautet KI.

Der Datensatz für die Serveraktion „Dokumente im Posteingang automatisch sortieren“.

Die Einagbeaufforderung zu dieser Aktion liefert Kontextinformationen zum Dokument sowie zur Absicht der Aktion.

Das Feld Tool enthält mehrere Aktionen, die basierend auf dieser Eingabeaufforderung ausgeführt werden können, darunter das Verschieben eines Dokuments, das Hinzufügen von Stichwörtern oder das Erstellen von Rechnungen.

Bemerkung

KI: Stichwörter hinzufügen, KI: In Ordner verschieben und KI: Dokument umbenennen sind allesamt Serveraktion vom Typ Code ausführen, d. h. sie lösen Python-Code aus.

Wenn die Aktion beispielsweise anhand des Inhalts des Dokuments feststellt, dass das am besten geeignete Tool KI: In Ordner verschieben ist, führt der Python-Code die folgende Operation aus:

ai['result'] = record._ai_action_move_in_folder(folder_id)

Dieser Code wird beim Aufruf bedingungslos ausgeführt und führt die Verschiebung mithilfe einer vorhandenen Methode durch.

Bemerkung

Die |KI| leitet Argumente nicht aus dem Python-Code oder der Methodensignatur ab. Stattdessen werden die an ein Tool übergebenen Argumente vollständig durch die Konfiguration des Tools bestimmt.

Für das Tool KI: In Ordner verschieben erwartet der Python-Code die Variable folder_id. Die |KI| weiß, dass sie folder_id bereitstellen muss, da diese Variable in der Konfiguration explizit als Argument deklariert ist. Diese Angabe finden Sie im Reiter Verwendung der Serveraktion im Feld KI-Schema. Die Spalte Name unter KI-Schema muss genau mit dem im Python-Code verwendeten Variablennamen übereinstimmen.

Die |KI| verwendet die Argumentbeschreibung, um zu verstehen, was der Parameter darstellt, welche Art von Wert erwartet wird und wann es angebracht ist, ihn anzugeben.

Wenn ein Argument nicht im Reiter „Verwendung“ definiert ist, kann die KI es nicht bereitstellen, selbst wenn der Python-Code darauf verweist.

Der Reiter „Verwendung“ der Serveraktion „KI: In Ordner verschieben“.

Benutzerdefinierte KI-Tools erstellen

Das gleiche Muster wie im obigen Beispiel Dokumente im Posteingang automatisch sortieren kann mit der Standardlogik von Odoo implementiert werden. Um beispielsweise eine Aktion zu erstellen, mit der eine Aufgabenbeschreibung aktualisiert werden kann, könnte eine Aktion vom Typ Code ausführen mit dem folgenden Code erstellt werden:

record.write({'description': content})

Damit es ordnungsgemäß funktioniert, muss content als Argument im Reiter Verwendung des Tools definiert werden.

Siehe auch

Serveraktionen

Häufige Probleme

Warum ist das Feld „Tools“ leer?

  • Stellen Sie sicher, dass für mindestens eine Serveraktion die Option In KI verwenden aktiviert ist.

  • Stellen Sie sicher, dass mindestens ein Tool dem gleichen Modell zugewiesen ist wie die Serveraktion.

Warum wurde das Tool ausgeführt, aber es ist nichts passiert?

  • Der Python-Code wurde ohne Änderungen beendet.

  • Erforderliche Argumente fehlten oder waren leer.

  • Die Geschäftsbedingungen wurden nicht in die Tool-Logik implementiert.

Warum hat die KI ein unerwartetes Tool ausgewählt?

  • Die Eingabeaufforderung enthielt nicht genügend Kontext.

  • Mehrere Tools entsprachen derselben Absicht.

  • Auf Tool-Ebene wurden keine Einschränkungen durchgesetzt.