User Manual
awaBerry | Projekt bearbeiten
Bearbeiten Sie ein Smart Automation Framework-Projekt – aktualisieren Sie Anweisungen, generieren Sie die Automatisierungslogik neu, passen Sie den...
Projekt bearbeiten
Zusammenfassung
Die Seite 'Projekt bearbeiten' ist Ihr zentraler Knotenpunkt für die Konfiguration von Smart Automization-Projekten. Hier können Sie neue Projekte erstellen oder bestehende modifizieren, indem Sie Einstellungen wie den Projektnamen, die Beschreibung, die Ausführungshäufigkeit, die Kommunikationspräferenzen, Umgebungsvariablen und die Funktionsweise Ihres intelligenten Agenten anpassen. Sie ist so konzipiert, dass Sie die volle Kontrolle über Ihre Automatisierungsroutinen haben, von einfachen Aufgaben bis hin zu komplexen Orchestrierungen.
awaBerry Anywhere Markdown Editor
Der awaBerry Anywhere Markdown Editor ist ein vielseitiges Werkzeug zur Verwaltung von Markdown-Inhalten. Er bietet drei verschiedene Ansichtsmodi: Editor, Split und Vorschau, die es den Benutzern ermöglichen, sich auf das Schreiben zu konzentrieren, sowohl Code als auch Live-Ausgabe anzuzeigen oder ausschließlich das formatierte Ergebnis zu sehen. Der Editor speichert den Inhalt periodisch automatisch, wenn der Benutzer aktiv ist, und kann auch manuell gespeichert werden. Er enthält auch integrierte Sitzungsverwaltungsfunktionen, die Benutzer benachrichtigen, wenn ihre Sitzung abläuft oder bereits abgelaufen ist, und notwendige Maßnahmen zur Aufrechterhaltung des Zugriffs auffordern.
Projektlogik generieren
Die Seite 'Projektlogik generieren' ist ein zentraler Knotenpunkt für die Verwaltung der automatisierten Aufgaben Ihres Projekts. Sie bietet ein Echtzeit-Terminal zur Anzeige laufender Prozesse, dynamische Screenshots zur Visualisierung des Fortschritts und ein detailliertes Protokoll aller Aktivitäten. Dies stellt sicher, dass Sie einen vollständigen Überblick über die Einrichtung und Ausführung Ihres Projekts haben. Das System hält Sie auch über den Status Ihrer Benutzersitzung auf dem Laufenden und gibt rechtzeitige Warnungen vor dem Ablauf Ihrer Sitzung und klare Benachrichtigungen, falls diese abläuft.
Projektlogik ausführen
Diese Seite bietet eine umfassende Benutzeroberfläche zur Überwachung der Einrichtung und der laufenden Aktivitäten Ihres Projekts. Sie sehen Echtzeit-Ausgaben in einem Terminal, Aktualisierungen des Projektstatus und Live-Screenshots während des Fortschritts der Aufgaben. Das System benachrichtigt Sie auch über den Status Ihrer Sitzung, z. B. wann sie abläuft oder abgelaufen ist, um sicherzustellen, dass Sie Ihre Arbeit ohne Unterbrechung verwalten können.
Seitenzugriff
Sie können auf diese Seite zugreifen, indem Sie zu: /automization navigieren.
Seitenfunktionen
Diese Seite bietet umfassende Werkzeuge zur Verwaltung Ihrer Automatisierungsprojekte:
- Projektname & Beschreibung: Einfaches Festlegen oder Ändern des Namens und einer detaillierten Beschreibung für Ihr Projekt.
- Umgebungsvariablen: Definieren und Verwalten von Schlüssel-Wert-Paaren für projektspezifische Umgebungseinstellungen. Sie können Variablen hinzufügen, bearbeiten oder entfernen, deren Sichtbarkeit aus Sicherheitsgründen umschalten und sogar auf andere Projekte als Referenzen verweisen.
- Agententyp: Wählen Sie zwischen zwei Agententypen:
- Einzelagent: Für direkte Ausführungsaufgaben, bei denen Sie eine primäre Aufforderung für den Agenten definieren.
- Executor Agent: Für die Orchestrierung mehrerer Projekte. Sie definieren die Reihenfolge, in der referenzierte Projekte ausgeführt werden. Projekte können hinzugefügt, entfernt und neu geordnet werden.
- Projektaktivierung: Ein Schalter zum Aktivieren oder Deaktivieren Ihres Projekts. Inaktive Projekte werden nicht gemäß ihrem Zeitplan ausgeführt.
- Anzeige im Portal: Eine Checkbox (verfügbar für 'Single'-Agententypen), um zu steuern, ob Ihr Projekt auf der Hauptportal-Seite sichtbar ist.
- Projekt-JSON herunterladen: Exportieren Sie die Konfiguration Ihres Projekts als JSON-Datei, einschließlich Platzhaltern für sensible Umgebungsvariablenwerte.
- Ausführungszeitplan: Legen Sie fest, wann Ihr Projekt ausgeführt wird:
- Niemals: Keine automatische Ausführung.
- Täglich: Wählen Sie spezifische Tage und Stunden für die tägliche Ausführung.
- Wöchentlich: Wählen Sie einen bestimmten Wochentag für die Ausführung.
- Nachrichtenpräferenz: Wählen Sie aus, wie Sie Nachrichten nach der Projektausführung erhalten oder senden möchten (z. B. E-Mail, Slack, X.com/Twitter). Wenn Sie Slack oder X.com wählen, fügt das System automatisch die notwendigen Umgebungsvariablen hinzu, die Sie ausfüllen müssen.
- Status der Ausführungseinrichtung: Überwachen Sie den Status der Ausführungsumgebung Ihres Projekts.
- Ausführungseinrichtung erstellen: Initialisieren Sie die Ausführungsumgebung für ein neues Projekt.
- Ausführung neu erstellen: Bauen Sie die Ausführungsumgebung neu auf (empfohlen nach wesentlichen Prompt-Änderungen).
- Ergebnis aktualisieren: Lösen Sie eine sofortige Aktualisierung des Ausführungsergebnisses des Projekts aus.
- Letztes Ergebnis anzeigen (HTML): Sehen Sie die aktuellste HTML-Ausgabe der Projektausführung.
- Letztes Ergebnis anzeigen (JSON): Greifen Sie auf die rohen JSON-Daten des letzten Projektdurchlaufs zu.
- Neuestes Gemini-Protokoll anzeigen: Überprüfen Sie das detaillierte Protokoll der neuesten Gemini-Ausführung zur Fehlerbehebung oder Überprüfung.
- Projekt speichern: Übernehmen Sie alle Ihre Änderungen an der Projektkonfiguration.
- Zurück-Schaltfläche: Navigieren Sie zurück zum vorherigen Bildschirm. Wenn Sie ungespeicherte Änderungen haben, werden Sie aufgefordert, zu speichern, zu verwerfen oder die Bearbeitung fortzusetzen.
Szenarioausführungen
Mögliche Nutzungsschritte auf dieser Seite
Szenario: Erfolgreiche Erstellung und Konfiguration eines neuen Einzelagenten-Projekts
Dieses Szenario führt Sie durch die Erstellung eines neuen Projekts, die Festlegung seiner grundlegenden Details, das Hinzufügen einer Umgebungsvariablen und die Konfiguration seiner Ausführung und Nachrichtenübermittlung.
- Projektname:
Meine neue Automatisierung - Projektbeschreibung:
Automatisiert die tägliche Berichterstellung. - Haupt-Prompt:
Bericht generieren, in /output speichern. - Umgebungsvariablen-Schlüssel:
API_KEY - Umgebungsvariablen-Wert:
Ihr_API_Schlüssel_hier
- Klicken Sie auf die Schaltfläche 'Neues Projekt erstellen' (oder navigieren Sie zur Erstellung eines neuen Projekts).
- Geben Sie "Meine neue Automatisierung" in das Feld 'Projektname' ein.
- Geben Sie "Automatisiert die tägliche Berichterstellung." in das Feld 'Projektbeschreibung' ein.
- Geben Sie "Bericht generieren, in /output speichern." in das Textfeld 'Prompt' ein.
- Scrollen Sie zum Abschnitt 'Variablen' und klicken Sie auf die Schaltfläche '+' (Hinzufügen).
- Geben Sie "API_KEY" in das Feld 'Schlüssel' der neuen Umgebungsvariable ein.
- Geben Sie "Ihr_API_Schlüssel_hier" in das Feld 'Wert' der neuen Umgebungsvariable ein.
- Stellen Sie im Abschnitt 'Ausführung' sicher, dass 'Täglich' ausgewählt ist, und wählen Sie bei Bedarf spezifische Tage und Stunden aus (z. B. 'Mo-Fr' um '9 Uhr').
- Wählen Sie im Abschnitt 'Nachrichten' 'E-Mail' aus.
- Klicken Sie auf die Schaltfläche 'Speichern'.
Ziel: Das Projekt wird erfolgreich mit einer neuen Projekt-ID gespeichert, und Sie erhalten eine Benachrichtigung "Projekt erfolgreich gespeichert".
Szenario: Aktualisierung des Ausführungszeitplans eines bestehenden Projekts
Dieses Szenario zeigt, wie die Ausführungshäufigkeit eines bereits erstellten Projekts geändert wird.
- Bestehende Projekt-ID:
projekt_12345(angenommen, dieses Projekt ist geladen) - Neuer Ausführungsmodus:
Wöchentlich - Neuer Tag:
Montag
- Laden Sie ein bestehendes Projekt (z. B. indem Sie es aus der Projektübersicht auswählen).
- Navigieren Sie zum Abschnitt 'Ausführung'.
- Wählen Sie im Dropdown-Menü für den Ausführungsmodus 'Wöchentlich' aus.
- Stellen Sie im Tag-Selektor sicher, dass nur 'Mo' ausgewählt ist.
- Klicken Sie auf die Schaltfläche 'Speichern'.
Ziel: Der Ausführungszeitplan des Projekts wird auf wöchentliche Ausführung am Montag aktualisiert, und Sie erhalten eine Benachrichtigung "Projekt erfolgreich gespeichert".
Szenario: Konfiguration von Slack-Nachrichten und Überprüfung der Hinzufügung von Umgebungsvariablen
Dieses Szenario zeigt, wie die Auswahl von Slack-Nachrichten automatisch zur Eingabe der erforderlichen Webhook-Umgebungsvariable auffordert.
- Bestehende Projekt-ID:
projekt_67890(angenommen, dieses Projekt ist geladen und hat noch KEIN SLACK_WEBHOOK)
- Laden Sie ein bestehendes Projekt.
- Navigieren Sie zum Abschnitt 'Nachrichten'.
- Wählen Sie im Dropdown-Menü für Nachrichten 'Slack-Nachricht' aus.
- Beobachten Sie den Abschnitt Umgebungsvariablen.
- Sie sehen eine Snackbar-Benachrichtigung: "Setzen Sie die Variable SLACK_WEBHOOK, um Nachrichten über Slack zu erhalten".
Ziel: Der Umgebungsvariablen-Schlüssel 'SLACK_WEBHOOK' wird automatisch zur Liste der Umgebungsvariablen hinzugefügt und wartet auf seinen Wert.
Szenario: Anzeige des letzten HTML-Ausführungsergebnisses
Dieses Szenario beschreibt, wie die HTML-Ausgabe der letzten Projektausführung abgerufen und angezeigt wird.
- Bestehende Projekt-ID:
projekt_abcde(angenommen, dieses Projekt ist geladen und hat mindestens ein Ausführungsergebnis)
- Laden Sie ein bestehendes Projekt, das mindestens einmal ausgeführt wurde.
- Scrollen Sie zum Abschnitt 'Ausführungseinrichtung'.
- Klicken Sie auf die Schaltfläche 'Letztes Ergebnis' (sieht aus wie ein Verlaufssymbol).
- Ein Ladedialog wird angezeigt, gefolgt von einer Vollbildansicht des HTML-Ergebnisses.
Ziel: Ein neues Vollbildfenster öffnet sich und zeigt den HTML-Inhalt des letzten Ausführungsergebnisses an.
Mögliche Fehler, die auf dieser Seite auftreten können
Fehler: Versuch, zum Executor-Agententyp zu wechseln, ohne verfügbare Projekte
Beschreibung: Wenn versucht wird, den 'Agententyp' auf 'Executor' zu ändern, ohne dass andere Projekte erstellt wurden, auf die verwiesen werden kann, verhindert das System den Wechsel und informiert den Benutzer.
Schritte zur Reproduktion:
- Laden Sie ein beliebiges Projekt (oder erstellen Sie ein neues). Stellen Sie sicher, dass neben dem aktuellen Projekt keine anderen Projekte im System vorhanden sind (d. h. die Liste 'Projekte' im
SmartAutomizationEditProject-Widget ist leer oder enthält nur das aktuelle Projekt). - Navigieren Sie zum Abschnitt 'Agententyp'.
- Versuchen Sie, im Dropdown-Menü 'Executor' auszuwählen.
Erwartetes Ergebnis: Eine Snackbar-Benachrichtigung erscheint mit der Meldung: "Zum Erstellen eines Orchestrators ist mindestens ein Projekt erforderlich, das er ausführen kann – erstellen Sie zuerst ein Ausführungsprojekt." Der Dropdown für den Agententyp bleibt unverändert.
Fehler: Speichern eines Projekts mit fehlenden Werten für Umgebungsvariablen
Beschreibung: Wenn Sie versuchen, ein Projekt zu speichern, das definierte Umgebungsvariablen hat, aber einige ihrer 'Wert'-Felder leer sind oder den Platzhalter "Wert hier einfügen" enthalten, wird der Speicher-Vorgang für die Ausführungseinrichtung nicht erfolgreich abgeschlossen, und Sie sehen eine Warnung.
Schritte zur Reproduktion:
- Laden Sie ein beliebiges bestehendes Projekt oder erstellen Sie ein neues.
- Fügen Sie im Abschnitt 'Umgebungsvariablen' eine neue Variable hinzu oder stellen Sie sicher, dass eine vorhandene Variable ein leeres 'Wert'-Feld hat (oder "Wert hier einfügen").
- Versuchen Sie, auf die Schaltfläche 'Speichern' zu klicken.
Erwartetes Ergebnis: Ein Warnfeld erscheint im Abschnitt 'Ausführungseinrichtung' mit der Meldung: "Mindestens ein Wert für eine Umgebungsvariable fehlt – fügen Sie diese hinzu und speichern Sie das Projekt, um die Ausführung für dieses Projekt hinzuzufügen / neu zu erstellen". Der Speicher-Vorgang wird für die grundlegenden Projektdetails weiterhin abgeschlossen, aber alle ausführungsspezifischen Aktionen werden deaktiviert, bis alle Umgebungsvariablen ausgefüllt sind.
