Communitygithub.com

pattern-ai-labs/built-with-agentcall

Eine Sammlung von realen Anwendungsfällen, die mit agentcall.dev erstellt wurden – jeder Ordner enthält ein in sich geschlossenes, funktionierendes Beispiel. Von Pattern AI Labs.

Was ist built-with-agentcall?

Diese Skill-Beschreibung definiert ein AI-gesteuertes Präsentationssystem, das als virtueller Presenter an Online-Meetings teilnimmt. Der Bot kann Dokumente (PDF, PowerPoint, Word) oder ein reines Thema in eine interaktive Diashow umwandeln und diese im Meeting präsentieren – entweder als Bildschirmfreigabe oder im Avatarmodus (Deck im Kamerabild). Die Kernlogik liegt im zweistufigen Prozess: Zuerst wird das Eingabedokument mittels `doc_to_deck.py` konvertiert, wobei zwischen ‚show‘ (originalgetreue Wiedergabe von Folien) und ‚generate‘ (K.I.-gestütztes Erstellen einer neuen Präsentation aus Textdokumenten) unterschieden wird. Im zweiten Schritt wird die Präsentation mit `present.py` live geschaltet. Ein besonderes Merkmal ist, dass der Agent selbst die Sprachausgabe verfasst (‚authoring‘) – Sprechnotizen werden manuell oder aus vorhandenen Notizen übernommen, das System verweigert die Wiedergabe ohne vollständige Notizen. Die Steuerung erfolgt über Sprachbefehle, die an den Agenten weitergeleitet werden, oder über eine Companion-Seite im Browser. Der Skill unterstützt die Plattformen von agentcall.dev und ist für Entwickler gedacht, die AI-gesteuerte Meeting-Teilnehmer bauen möchten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add pattern-ai-labs/built-with-agentcall

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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_key verwendet):
    1. Existiert ~/.agentcall/config.json mit einem api_key? → bereit.
    2. Ist die Umgebungsvariable AGENTCALL_API_KEY gesetzt? → bereit.
    3. Weder noch? → Benutzer nach seinem Schlüssel fragen (kostenlos unter agentcall.dev/api-keys) und in ~/.agentcall/config.json schreiben (siehe Einrichtung) – diese Datei genau so erstellen, wie AgentCall es tun würde – dann fortfahren.
  • 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/.ppt oder eine folienförmige PDF → die echten Folien anzeigen, aber die Erzählung gehört Ihnen:
    • Wenn die Datei Sprechernnotizen auf jeder Folie hat (.pptx nur – Notizen in älteren .ppt können nicht gelesen werden; nach einer .pptx fragen), 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_narration gekennzeichnet, wobei alle notes leer sind (und eine decks/<name>/source.json Datei vorhanden ist). Verfassen Sie eine gesprochene notes-Zeile pro Folie (lesen Sie source.json + werfen Sie einen Blick auf die Folienbilder), bevor Sie präsentieren – present.py weigert sich, ein nicht verfasstes konvertiertes Deck auszuführen, also gibt es keine Abkürzung. Das Verfassen IST das Präsentieren.
  • Eine .docx/.doc, eine berichtsartige PDF oder ein Thema → ein Deck verfassen: Führen Sie doc_to_deck.py --mode generate aus, lesen Sie decks/<name>/source.json (dessen Text + extrahierte Abbildungen) und schreiben Sie decks/<name>/deck.json. Versuchen Sie NICHT, die Datei selbst zu öffnen oder darzustellen (kein pdftoppm, keine Bildtools) – source.json ist 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 verfasste deck.json in decks/<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). --out ist 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):

  1. Nie ein rohes Dokument direkt in present.py geben und weggehen. Konvertieren → needs_narration prüfen → notes verfassen → präsentieren. Der Verweigerungs-Exit-Code (2) ist Ihr Signal zum Verfassen, kein Fehler, der umgangen werden muss.
  2. Nie ein verfasstes deck.json durch 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.
  3. 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.
  4. 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.json einbacken) – alles, was Inhalt oder Vortrag betrifft:
    • „Halte es kurz / ca. 5 min / ein Einzeiler pro Folie“ → kürzere notes schreiben; die Folienhaltezeit basiert auf der Länge, also kürzere Notizen = ein schnellerer Vortrag. „Geh in die Tiefe“ → umfangreichere notes.
    • „Sag ‹X› auf der Preisfolie“, „Beginne mit einem Witz“, „Betonen Sie ‹Y›“ → diese Zeile in die notes dieser bestimmten Folie setzen, damit sie genau dort gesprochen wird, wo beabsichtigt.
    • „Überspringe die Roadmap-Folie“ → beim Verfassen weglassen/zusammenführen.
  • 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.jsonl hereinkommt, 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/present senden. 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.

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)

ModusWas es tutStandard für
showRendert die ECHTEN Seiten/Folien des Dokuments als Bilder und zeigt sie unverändert an.pptx/.ppt und folienförmige PDFs
generateAnalysiert 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_narration markiert (die Folien ohne Notizen würden sonst in völliger Stille angezeigt werden). Verfassen Sie eine gesprochene notes-Zeile für jede Folie, der eine fehlt (aus decks/<name>/source.json + den Folienbildern), dann präsentieren Sie das verfasste deck.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.

  1. 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
    
  2. deck.json aus source.json verfassen – 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 kurze bullets und notes = 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.json listet Bilder auf, die aus dem Dokument extrahiert wurden (in sections[].images und all_images). Setzen Sie das relevante in das image-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).
  3. Vorschau und präsentieren (Abschnitte C & D). Für ein Thema ohne Datei überspringen Sie die Konvertierung und verfassen Sie decks/<name>.json direkt.

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:

  1. 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) und link/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
    
    (&/tail sind POSIX – unter Windows verwenden Sie Ihre Hintergrundausführungsfunktion und Get-Content link/heard.jsonl -Wait.) present.py führt alles aus, was Sie an commands.jsonl anhängen, innerhalb von ~0,3s.
  2. 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.

Verwandte Skills