Presenter – Ein Dokument (oder ein Thema) in einem Meeting präsentieren
Ein AI-Bot nimmt an einem Meeting teil und präsentiert: Standardmäßig wird das Deck groß auf der Hauptbühne des Meetings als Bildschirmfreigabe angezeigt, mit Erzählung in der Stimme des Bots, die automatisch weiterblättert. Das Gesicht des Bots wird in einer kleinen Kamerakachel eingeblendet. (Mit --avatar-mode – oder wenn der Benutzer „Im Avatarmodus teilnehmen“ sagt – wird das Deck auf der Kamerakachel angezeigt, das ursprüngliche Ein-Kachel-Layout. Kein Klicker in beiden Fällen.)
Anzeigemodi: Bildschirmfreigabe ist der Standard (lesbare Vollbild-Folien + ein Präsentator-Gesicht); Avatarmodus (--avatar-mode) platziert das Deck nur auf der Kamerakachel. Alles andere – Sprachsteuerung, die begleitende Fernbedienung, Erzählung, Fragen & Antworten – funktioniert in beiden Modi identisch.
Der Hauptanwendungsfall: Der Benutzer gibt einen Meeting-Link und ein Dokument – PDF, PowerPoint oder Word – und der Bot präsentiert es. Sie können auch nur mit einem Thema beginnen.
Gehen Sie in dieser Reihenfolge vor (der gesamte Ablauf – jedes Mal gleich, keine Umwege)
0 · Vorab-Check (einmalig).
- API-Schlüssel – in dieser Reihenfolge prüfen und NICHT fragen, wenn er bereits vorhanden ist (eine Konfiguration, die GLEICHE Datei, die AgentCall verwendet; dies ist die genaue Reihenfolge, die
load_api_keyverwendet):- Existiert
~/.agentcall/config.jsonmit einemapi_key? → bereit. - Ist die Umgebungsvariable
AGENTCALL_API_KEYgesetzt? → bereit. - Weder noch? → Benutzer nach seinem Schlüssel fragen (kostenlos unter agentcall.dev/api-keys) und in
~/.agentcall/config.jsonschreiben (siehe Einrichtung) – diese Datei genau so erstellen, wie AgentCall es tun würde – dann fortfahren.
- Existiert
- Abhängigkeiten –
pip install -r requirements.txt(schnell; reine Python-Räder, keine Systemtools).
1 · Die Eingabe in ein Deck verwandeln. Sie (der Agent) besitzen immer die Erzählung – lassen Sie den Bot niemals die Folie vom Bildschirm ablesen. Führen Sie zuerst doc_to_deck.py aus, dann schauen Sie sich an, was produziert wurde:
- Eine
.pptx/.pptoder eine folienförmige PDF → die echten Folien anzeigen, aber die Erzählung gehört Ihnen:- Wenn die Datei Sprechernnotizen auf jeder Folie hat (
.pptxnur – Notizen in älteren.pptkönnen nicht gelesen werden; nach einer.pptxfragen), werden diese zur Erzählung – Sie sind fertig, präsentieren Sie einfach. Notizen auf nur EINIGEN Folien → das Deck wird markiert; die fehlenden müssen verfasst werden. - Wenn es keine Notizen hat, wird das Deck mit
needs_narrationgekennzeichnet, wobei allenotesleer sind (und einedecks/<name>/source.jsonDatei vorhanden ist). Verfassen Sie eine gesprochenenotes-Zeile pro Folie (lesen Siesource.json+ werfen Sie einen Blick auf die Folienbilder), bevor Sie präsentieren –present.pyweigert sich, ein nicht verfasstes konvertiertes Deck auszuführen, also gibt es keine Abkürzung. Das Verfassen IST das Präsentieren.
- Wenn die Datei Sprechernnotizen auf jeder Folie hat (
- Eine
.docx/.doc, eine berichtsartige PDF oder ein Thema → ein Deck verfassen: Führen Siedoc_to_deck.py --mode generateaus, lesen Siedecks/<name>/source.json(dessen Text + extrahierte Abbildungen) und schreiben Siedecks/<name>/deck.json. Versuchen Sie NICHT, die Datei selbst zu öffnen oder darzustellen (keinpdftoppm, keine Bildtools) –source.jsonist Ihre Eingabe. Halten Sie das Verfassen prägnant: eine Idee pro Folie, kurze Aufzählungspunkte, natürliche Erzählung – nicht zu sehr verfeinern. - Verfasste Arbeit ist geschützt – aber NUR im STANDARD-Deck-Ordner. Die erneute Ausführung der Konvertierung (oder
present.py --deck <gleiches Dokument>) bei unveränderter Quelle verwendet das bereits verfasstedeck.jsonindecks/<name>/wieder – sofort, nichts wird neu gerendert, Ihre Erzählung bleibt erhalten. Es wird nur neu konvertiert, wenn sich das Dokument selbst geändert hat (dann neu verfassen – die Markierung kommt zurück). Übergeben Sie NICHT--out <einen anderen Ordner>für ein Dokument, das Sie verfassen und präsentieren werden – ein frischer Ordner hat kein Deck zur Wiederverwendung, also erhalten Sie einen Entwurf mit leeren Notizen (und das echte verfasste Deck wird veraltet).--outist nur für temporäre/Inspektion-Konvertierungen gedacht. Verfassen, präsentieren und erneut präsentieren Sie alle aus dem Standard-decks/<name>/deck.json. - Vollständige Details + Deck-Schema: Abschnitte A und B unten.
Harte Regeln (jede davon hat bereits eine echte Sitzung zunichte gemacht – der Code erzwingt die meisten davon, versuchen Sie nicht, sie zu umgehen):
- Nie ein rohes Dokument direkt in
present.pygeben und weggehen. Konvertieren →needs_narrationprüfen →notesverfassen → präsentieren. Der Verweigerungs-Exit-Code (2) ist Ihr Signal zum Verfassen, kein Fehler, der umgangen werden muss. - Nie ein verfasstes
deck.jsondurch erneutes Konvertieren überschreiben. Unveränderte Quelle → es wird automatisch wiederverwendet; löschen Sie den Deck-Ordner nur, wenn der Benutzer explizit eine frische Konvertierung wünscht. - Nie einen Platzhalter-Deck erfinden oder sich vor der Kamera entschuldigen. Wenn die Konvertierung fehlschlägt, beendet sich present.py – korrigieren Sie die Eingabe (oder installieren Sie LibreOffice) und starten Sie neu. Ein Bot, der nie beitritt, ist besser als einer, der kaputt aussieht.
- Nie einen laufenden Anruf zurücklassen. present.py beendet die Abrechnung selbst auf jedem Exit-Pfad – aber wenn SIE es gestartet haben, bestätigen Sie, dass der Prozess tatsächlich beendet ist, wenn die Präsentation endet.
1b · Die Vorgaben des Benutzers berücksichtigen – seine Anweisungen formen das Deck UND wie Sie es steuern. Wenn der Benutzer etwas sagt, das über „präsentiere dies“ hinausgeht, erfassen Sie es und wenden Sie es an. Es landet an einem von zwei Orten:
- Zum Zeitpunkt des Verfassens (in
deck.jsoneinbacken) – alles, was Inhalt oder Vortrag betrifft:- „Halte es kurz / ca. 5 min / ein Einzeiler pro Folie“ → kürzere
notesschreiben; die Folienhaltezeit basiert auf der Länge, also kürzere Notizen = ein schnellerer Vortrag. „Geh in die Tiefe“ → umfangreicherenotes. - „Sag ‹X› auf der Preisfolie“, „Beginne mit einem Witz“, „Betonen Sie ‹Y›“ → diese Zeile in die
notesdieser bestimmten Folie setzen, damit sie genau dort gesprochen wird, wo beabsichtigt. - „Überspringe die Roadmap-Folie“ → beim Verfassen weglassen/zusammenführen.
- „Halte es kurz / ca. 5 min / ein Einzeiler pro Folie“ → kürzere
- Live-Steuerungsrichtlinie (Sie setzen sie während der Ausführung durch) – alles, was Reaktion im Raum betrifft:
- „Beantworte keine Fragen zu ‹Z› / Preisen / Personalzahl“ → wenn eine solche Frage über
heard.jsonlhereinkommt, beantworten Sie sie NICHT: antworten Sie mit einer kurzen Ausweichreaktion ({"cmd":"say","text":"Gute Frage – lass uns das offline besprechen."}) anstatt einer echten Antwort. „Verschiebe alle Q&A ans Ende“ → bestätigen Sie und präsentieren Sie weiter, anstatt mitten im Deck zu antworten. - „Halte auf Folie 3 für eine Diskussion an“, „Gehe nur weiter, wenn ich es sage“ → passen Sie an, wie eifrig Sie
next/presentsenden. Behalten Sie eine kurze mentale Notiz dieser Regeln für die gesamte Sitzung – sie gelten für den gesamten Anruf, nicht nur für die erste Folie. Wenn eine Anfrage mehrdeutig ist, fragen Sie den Benutzer vor dem Start.
- „Beantworte keine Fragen zu ‹Z› / Preisen / Personalzahl“ → wenn eine solche Frage über
2 · (optional) Vorschau – present.py --local --deck <deck> gibt eine Localhost-URL aus, um sie vor dem Live-Gang anzusehen.
3 · Live starten, im Hintergrund – python scripts/present.py "<url>" --deck <deck> &
(Name/Stimme stammen aus ~/.agentcall/config.json; --name/--voice überschreiben pro Durchlauf).
Der Bot erscheint in 30–90 Sekunden, begrüßt und wartet.
4 · Steuern Sie es – beginnen Sie sofort mit dem Beobachten. Verfolgen Sie link/heard.jsonl und antworten Sie in link/commands.jsonl (vollständiges Protokoll unter Sprachsteuerung). Es beginnt erst, wenn Sie auf ein „Los geht's“ mit present antworten.
5 · Beenden – es verlässt den Raum automatisch und beendet die Abrechnung, wenn alle gehen, bei Zeitüberschreitung oder bei einem leave-Befehl. Wenn Sie es gestartet haben, stellen Sie sicher, dass der Prozess beendet wird.
Zwei Modi (dies ist die Kernidee)
| Modus | Was es tut | Standard für |
|---|---|---|
| show | Rendert die ECHTEN Seiten/Folien des Dokuments als Bilder und zeigt sie unverändert an | .pptx/.ppt und folienförmige PDFs |
| generate | Analysiert das Dokument, dann VERFASSEN SIE ein aussagekräftiges Deck (Titel, Aufzählungspunkte, gesprochene Erzählung) und fügen die eigenen Abbildungen der Quelle hinzu | .docx/.doc, dichte/Bericht-PDFs und Themen |
Faustregel: Eine Datei, die bereits eine Diashow ist → anzeigen. Ein Dokument (Prosa) → ein Deck daraus generieren. auto (der Standard) entscheidet anhand des Dateityps und bei PDFs anhand der Seitenform (Querformat + spärlicher Text = ein Deck → anzeigen; Hochformat + dicht = ein Dokument → generieren). Mit --mode show|generate überschreiben. Die Absicht des Benutzers gewinnt immer („meine Folien genau so präsentieren“ → zeigen; „dies in ein Deck zusammenfassen“ → generieren).
A) Ein Deck unverändert anzeigen (PowerPoint oder eine folienförmige PDF)
Der Anzeigemodus behält das tatsächliche Design jeder Folie bei (ein randloses Bild der tatsächlichen Folie). Was es sagt, hängt davon ab, ob die Datei Sprechernotizen enthält:
python scripts/doc_to_deck.py "/pfad/deck.pptx" # Folien rendern + Notizen erkennen
- Hat Sprechernotizen auf jeder Folie (
.pptx) → sie sind die Erzählung. Einfach präsentieren:python scripts/present.py "<MEETING_URL>" --deck decks/deck/deck.json - Keine Notizen – oder Notizen auf nur EINIGEN Folien → das Deck wird als
needs_narrationmarkiert (die Folien ohne Notizen würden sonst in völliger Stille angezeigt werden). Verfassen Sie eine gesprochenenotes-Zeile für jede Folie, der eine fehlt (ausdecks/<name>/source.json+ den Folienbildern), dann präsentieren Sie das verfasstedeck.json. Dadurch wird es zu einem Präsentator und nicht zu einem Bildschirmvorleser.
present.py WEIGERT SICH, ein needs_narration-Deck zu präsentieren, bis jede Folie notes hat (es wird mit einem Fehler beendet, der auf source.json verweist). Es gibt keinen Fallback „Folientext laut vorlesen“ – absichtlich. Geben Sie also niemals eine rohe Datei ohne Notizen an present.py in der Erwartung, dass es spricht: konvertieren, die notes verfassen, dann das verfasste deck.json präsentieren. Die Weigerung ist das Sicherheitsnetz; das Verfassen ist die Aufgabe.
B) Ein aussagekräftiges Deck generieren (Word, dichte PDF oder ein Thema)
Ein Dokument ist keine Diashow – das Anzeigen seiner Seiten ergibt einen schlechten Vortrag. Also bauen Sie das Deck.
- Konvertieren, um den Quellinhalt + Abbildungen zu erhalten:
python scripts/doc_to_deck.py "/pfad/datei.docx" --mode generate # schreibt decks/<name>/deck.json – einen mechanischen Entwurf mit LEEREN Notizen, markiert als needs_narration; # present.py WEIGERT SICH, bis Sie die Notizen verfassen (das ist der nächste Schritt, nicht optional) # und decks/<name>/source.json ← die analysierten Abschnitte + extrahierten Bilder, die Sie als Grundlage für das Verfassen verwenden # und decks/<name>/img/ ← die eigenen Abbildungen des Dokuments, bereits extrahiert deck.jsonaussource.jsonverfassen – das ist der wichtige Teil. Machen Sie es gut:- Zuerst eine Gliederung, dann ausfüllen. Erstellen Sie eine Folie pro Hauptidee. Bauen Sie eine mentale Checkliste der Abschnitte/Überschriften des Dokuments auf und stellen Sie sicher, dass jeder wichtige Punkt auf einer Folie landet – lassen Sie nichts weg.
- Jede Folie: ein kurzer
title, ≤6 kurzebulletsundnotes= natürliche gesprochene Erzählung (1–4 Sätze; Akronyme phonetisch buchstabieren wie „A.P.I.“, damit TTS sie richtig ausspricht). - Verwenden Sie die Abbildungen der Quelle wieder.
source.jsonlistet Bilder auf, die aus dem Dokument extrahiert wurden (insections[].imagesundall_images). Setzen Sie das relevante in dasimage-Feld einer Folie – die Folie zeigt dann Ihre Aufzählungspunkte neben dieser realen Abbildung (ein geteiltes Layout). Erfinden Sie keine Bilder. - Beginnen Sie mit einer einzeiligen Einführungsfolie; schließen Sie mit einer Zusammenfassung ab (der Bot verlässt den Raum nach der letzten Folie).
- Vorschau und präsentieren (Abschnitte C & D). Für ein Thema ohne Datei überspringen Sie die Konvertierung und verfassen Sie
decks/<name>.jsondirekt.
Deck-JSON-Schema (Textfolie, Bildfolie oder beides zusammen):
{
"title": "Mein Vortrag",
"slides": [
{ "title": "Einführung", "notes": "Gesprochene Einführung." },
{ "title": "Ein Punkt", "bullets": ["kurzer Satz", "ein anderer"], "notes": "Erzählung." },
{ "title": "Mit einer Abbildung", "bullets": ["was es zeigt"], "image": "fig1.png", "notes": "Erzählung." },
{ "image": "slide3.png", "notes": "Eine randlose echte Folie (Anzeigemodus)." }
]
}
(bullets/notes/image alle optional; Aliase points→bullets, say→notes; eine reine Titelfolie ist eine Titelseite.)
C) Vorschau (empfohlen)
python scripts/present.py --local --deck decks/<name>/deck.json # oder decks/<name>.json, oder eine Rohdatei
Gibt eine http://localhost:PORT/?ws=local URL aus – öffnen Sie sie, um die Folien rendern und automatisch weiterblättern zu sehen, ohne Meeting.
D) Live präsentieren
python scripts/present.py "<MEETING_URL>" --deck <datei-oder-deck> [--mode show|generate]
Live-Meetings sind standardmäßig interaktiv (zustimmungsgesteuert): Der Bot tritt bei, stellt sich vor und wartet, bis ihm jemand sagt, er solle beginnen. Zwei Möglichkeiten, es zu steuern:
- Per Sprache → an SIE (das Gehirn) weitergeleitet. Es gibt keine Schlüsselwort-Übereinstimmung im Code. Was auch immer ein Teilnehmer sagt – sobald er den Bot beim Namen nennt oder während eines kurzen Nachfragefensters – wird an Sie zur Interpretation weitergegeben, und Sie antworten mit einem Befehl. Protokoll unten.
- Über die begleitende Steuerungsseite (direkt). Eine Telefon-/Browserseite (Zurück / Pause / Weiter / auf eine Folie tippen / Neustart / Schließen), deren Link der Bot in den Meeting-Chat wirft und AUCH auf der Konsole ausgibt (
▸ Steuerungsseite: …) – leiten Sie die Konsolen-URL direkt an den Benutzer weiter; die Chat-Zustellung bei Meet kann unzuverlässig sein. Schaltflächen sind eindeutig und wirken im Prozess, sofort (sie gehen nicht durch Sie), daher sind sie die zuverlässige Alternative und die Möglichkeit, ohne angeschlossenen Agenten zu steuern.
Der Bot verlässt den Raum automatisch und beendet die Abrechnung, wenn alle anderen gehen, bei einer harten Begrenzung oder bei einem sauberen Exit – ein verwaister Bot kann keine Kosten verursachen. Fügen Sie --auto hinzu, um sofort ohne Nachfrage zu präsentieren; --pace <s> legt die Lücke zwischen den Folien fest.
Sprachsteuerung – SIE sind das Gehirn (der wichtige Teil)
Im interaktiven Modus leitet der Bot das Gehörte an eine Dateiverknüpfung weiter und führt den Befehl aus, den Sie zurückschreiben. Keine fest codierten Phrasen: Sie verstehen die Anfrage und entscheiden die Aktion. Führen Sie es im Hintergrund aus und loopen Sie:
- Starten Sie es (interaktiv ist der Standard für Live):
python scripts/present.py "<url>" --deck <datei> &Es gibt zwei Pfade aus:link/heard.jsonl(Bot → Sie) undlink/commands.jsonl(Sie → Bot). Beginnen Sie sofort mit dem Beobachten – die Begrüßung wird automatisch abgespielt, aber die Präsentation wird erst starten, wenn Sie auf das erste „Los geht's“ antworten. Lesen Sie nur NEUE Zeilen (verfolgen Sie einen Byte/Zeilen-Offset oder blockieren Sie auf der Datei – verarbeiten Sie keine alten Zeilen erneut) und antworten Sie innerhalb von ~45s (danach wird das Deck automatisch fortgesetzt). Die effiziente, ereignisähnliche Methode zum Beobachten, ohne ständiges Abfragen:(tail -n +1 -f link/heard.jsonl # streamt jede neue Äußerung als Zeile; verarbeiten Sie sie, dann hängen Sie Ihre Antwort an link/commands.jsonl an&/tailsind POSIX – unter Windows verwenden Sie Ihre Hintergrundausführungsfunktion undGet-Content link/heard.jsonl -Wait.) present.py führt alles aus, was Sie ancommands.jsonlanhängen, innerhalb von ~0,3s. - Wenn der Bot beim Namen genannt wird („Presenter, …“) – oder während des
[fortgesetzt...]
Autoren & Lizenz
Erstellt von Pattern AI Labs. Siehe LICENSE-Datei für Details.