# Beeuni als Agent-Backend für Ihr Produkt nutzen Verbinden Sie Ihr Produkt mit einem Agenten, der Lieferantenseiten durchsucht, auf autorisierte Quellen zugreift, Vergleiche erstellt und die Ergebnisse über das Beeuni SDK zurückgibt. Canonical page: https://beeuni.ai/blog/de/use-beeuni-as-your-agent-backend Nutzen Sie die Beeuni API oder das TypeScript SDK, um in Ihrer Anwendung Agentensitzungen zu erstellen. Ihr Produkt stellt die Benutzeroberfläche bereit und verwaltet die Nutzer; Beeuni führt die Tools des Agenten aus und gibt Nachrichten und Dateien zurück. Stellen Sie sich ein Einkaufstool vor, das Lieferanten vergleicht. Ein Nutzer wählt Produkte und zugelassene Lieferanten aus. Der Agent besucht deren öffentlich zugängliche Katalogseiten, liest Preislisten aus einem verbundenen Dokumentendienst und erstellt eine Vergleichstabelle. Ihre Anwendung übernimmt Anmeldung und Prüfung, während die Beeuni-Sitzung die Informationen zusammenträgt und den Vergleich erstellt. ## Definieren Sie die Aufgabe, die Ihre Benutzeroberfläche übermittelt Listen Sie die Eingaben, erlaubten Aktionen, das Ausgabeformat und mögliche Fehlerfälle auf. Geben Sie für das Katalogbeispiel zugelassene Lieferantenseiten, Verweise auf verbundene Katalogdokumente und die zu vergleichenden Felder an. Verlangen Sie eine Zeile pro Produkt mit Preisangabe, Währung und Quellenverweis. Fehlende Abmessungen sollen als unbekannt gekennzeichnet werden. Die Aufgabe darf keine Bestellungen auslösen. - **Aufgaben der Anwendung:** Personen authentifizieren, festlegen, wer auf welche Aufgabe zugreifen darf, Eingaben validieren und das Ergebnis anzeigen. - **Projektkonfiguration:** Agent, Modell, Skills und autorisierte Tools für diese Art von Arbeit auswählen. - **Sitzungsaufgabe:** Anfrage übermitteln, Fortschritt verfolgen und zurückgegebene Nachrichten und Ausgabedateien prüfen. ## Geben Sie der Sitzung Zugriff auf die benötigten Quellen Konfigurieren Sie das Projekt mit den Browser- und Verbindungstools, die für die Aufgabe erforderlich sind. Bei einem privaten Dokumentendienst verbinden Sie ein Konto und gewähren dem Agenten Zugriff auf die entsprechende Verbindung. Ein Link in einer Anfrage gewährt für sich genommen keinen Zugriff. Achten Sie darauf, dass das ausgewählte Konto und die freigegebenen Quellen zum Kunden passen, der die Aufgabe eingereicht hat; der [Leitfaden zu Verbindungen](/docs/de/connect/connectors) erläutert den Kontozugriff. Der Agent kann die ausgewählten Dokumente anschließend über diese Tools lesen, öffentliche Produktseiten besuchen und ein Skript schreiben, um Produktcodes und Packungsgrößen abzugleichen. Bitten Sie ihn, die abgerufenen Werte, Quellen und Abrufzeiten zusammen mit dem Ergebnis zu speichern. Kann ein Katalog nicht gelesen werden oder erfordert eine Seite eine weitere Anmeldung, soll der Agent diese Lücke an die Benutzeroberfläche zurückgeben, statt einen Preis zu erfinden. ## Bewahren Sie Zugangsdaten auf Ihrem Server auf Der [SDK-Leitfaden](/docs/de/sdk) zeigt, wie Sie `@beeuni/sdk` installieren, einen Client erstellen und Anfragen authentifizieren. Bewahren Sie den API-Schlüssel auf Ihrem Server und außerhalb des Browsercodes auf. Legen Sie fest, auf welche Beeuni-Projekte die einzelnen Kunden zugreifen dürfen. Trennen Sie bei Bedarf ihre Dateien und verbundenen Konten und prüfen Sie den Zugriff auf Ihrem Server, bevor Sie Anfragen weiterleiten. Der [Authentifizierungsleitfaden](/docs/de/sdk/auth) beschreibt die verfügbaren Anmeldemethoden. ## Fortschritt anzeigen und Verbindungen wiederherstellen Das SDK unterstützt das Erstellen von Sitzungen, das Warten auf ihre Bereitschaft und das Senden einer Anfrage. Das [vollständige Beispiel](/docs/de/sdk/example) zeigt, wie Sie Ereignisse empfangen und die Antwort auslesen. Nutzen Sie diese Ereignisse, um den tatsächlichen Fortschritt anzuzeigen. „Lieferantenseiten werden geöffnet“, „Produkte werden verglichen“ und „Ergebnis bereit“ sollten jeweils einem beobachtbaren Arbeitsschritt oder Status entsprechen. Legen Sie für jeden Vergleich einen Aufgabeneintrag in Ihrer Anwendung an. Speichern Sie die ausgewählten Quellenverweise, angeforderten Spalten, Beeuni-Projekt- und Sitzungs-IDs sowie den Speicherort der Ausgabe, sobald er verfügbar ist. Dieser Eintrag verbindet Ihre Prüfseite mit der bereits laufenden Arbeit. ``` Application task record — illustrative fields, not an SDK payload app_task_id approved_source_references requested_columns beeuni_project_id beeuni_session_id output_reference review_status ``` Nehmen wir an, ein Nutzer wählt drei Lieferantenkataloge aus und aktualisiert dann die Seite. Die neu geladene Benutzeroberfläche sucht die Anwendungsaufgabe und die zugehörige Beeuni-Sitzung. Sie liest den gespeicherten Fortschritt aus und verfolgt die laufende Arbeit weiter. Bei jedem Laden der Seite eine neue Sitzung zu erstellen, würde die Aufgabe duplizieren. Die Verbindung kann auch abbrechen, bevor Ihr Server die Bestätigung für die Übermittlung erhält. Das ist ein ungewisser Ausgang und kein Beweis dafür, dass nichts geschehen ist. Prüfen Sie die Sitzung, bevor Sie die Anfrage erneut senden. Lässt sich weiterhin nicht feststellen, ob sie angenommen wurde, zeigen Sie diese Unsicherheit an, statt automatisch einen weiteren Vergleich zu starten. ## Ergebnis in Ihrer Anwendung prüfen Prüfen Sie beim Katalogvergleich die erforderlichen Spalten, lesbaren Dateien, Quellenverweise und Produkte, die nicht zugeordnet werden konnten. Unterschiedliche Packungsgrößen sind eine häufige Fehlerquelle: Ein Preis pro Karton mit zwölf Stück lässt sich nicht direkt mit einem Stückpreis vergleichen. Bewahren Sie den angegebenen Betrag und die Einheit auf und ergänzen Sie einen normalisierten Preis nur, wenn die Quelle die Umrechnung belegt. Auf der Prüfseite sollte sich die Quelle eines Preises öffnen lassen und sollten ungeklärte Zuordnungen sichtbar sein. Die Datei kann bereitstehen, obwohl einige Zeilen noch geprüft werden müssen. Halten Sie diese Statusangaben in Ihrer Anwendung getrennt. ## Korrekturen ermöglichen, ohne den Kontext zu verlieren Angenommen, zwei Lieferanten verwenden unterschiedliche Bezeichnungen für denselben Stuhl. Der Agent führt sie als separate Produkte auf, und der Prüfer erkennt, dass sie übereinstimmen. Eine hilfreiche Korrektur nennt die beiden Quellzeilen und die gewünschte Beziehung: „Diese Einträge als dasselbe Produkt vergleichen, aber die angegebene Ausführung und Packungsgröße getrennt beibehalten.“ Nur „noch einmal versuchen“ zu senden, lässt den Agenten raten, was nicht stimmte. Speichern Sie die Korrektur bei der Aufgabe und halten Sie die vorherige Ausgabe verfügbar. Das nächste Ergebnis kann die Produktzuordnung verbessern und zugleich eine andere Zeile ändern. Zeigen Sie den überarbeiteten Vergleich und seine vorherige Version an, damit der Prüfer beide kontrollieren kann. Legen Sie fest, welche Version über die Download-Schaltfläche bereitgestellt wird, und dokumentieren Sie, welche Version genehmigt wurde. Eine Genehmigung könnte den Vergleich in einer internen Einkaufsoberfläche veröffentlichen. Eine Bestellung an einen Lieferanten zu senden, ist eine separate Aktion mit eigenen Berechtigungen und Bestätigungsschritten. Legen Sie diese Grenze in der Anwendung fest, bevor Sie dem Agenten Zugriff auf Einkaufstools gewähren. Eine fertige Tabelle sollte nicht automatisch eine Bestellung auslösen. ## Begrenzen Sie den Umfang einer Anfrage Legen Sie praktische Einreichungsgrenzen fest, etwa die Zahl der Kataloge und den Umfang der Arbeit pro Anfrage. Drei kurze Preislisten zu vergleichen ist etwas anderes, als ein ganzes Produktarchiv abzugleichen. Zeigen Sie den akzeptierten Umfang vor dem Start an, damit eine Person die Anfrage verkleinern oder einen Hintergrundauftrag wählen kann. Rufen Sie Informationen zu Nutzung und Kosten nach Möglichkeit von der Plattform ab, statt die Endabrechnung anhand der Nachrichtenlänge zu berechnen. Wenn Ihr Produkt eine feste Ausgabenobergrenze braucht oder laufende Aufgaben zuverlässig abbrechen können muss, prüfen Sie, wie Ihre Integration das sicherstellt. Ein Countdown oder eine Stopp-Schaltfläche allein belegt nicht, dass die Arbeit und die Kosten beendet sind. ## Testen Sie die Integration mit Fällen, die Sie selbst überprüfen können Halten Sie eine kleine Auswahl von Katalogen mit erwartbaren Ergebnissen bereit: eine übersichtliche Preisliste, einen unleserlichen Scan, zwei Währungen, widersprüchliche Packungsgrößen und ein Produkt ohne eindeutige Entsprechung. Nutzen Sie diese Fälle, wenn Sie das Modell, die Anweisungen oder die Projektkonfiguration ändern. Vergleichen Sie die erstellten Zeilen und Quellenverweise, einschließlich der Punkte, die der Agent offenlässt. Verlassen Sie außerdem während eines Durchlaufs die Seite, kehren Sie zurück und senden Sie nach Anzeige des Ergebnisses eine Korrektur. Prüfen Sie, welche Ausgabe heruntergeladen wird und ob eine andere angemeldete Person auf die Aufgabe zugreifen kann. Der Katalog kann richtig ausgewertet worden sein, während Ihre Anwendung die falsche Version anzeigt oder sie dem falschen Konto zugänglich macht. Testen Sie das Ergebnis des Agenten und die zugehörige Benutzeroberfläche gemeinsam.