Zum Inhalt springen

Referenz

Tools

Was ein Agent aufrufen kann. SPREVA bietet 49 Tools, und die für das Studio und KI-Bilder brauchen einen Tarif, der das Studio enthält.

Alle Tools

  • fetch

    Ein Objekt vollständig lesen

    Liest einen Beitrag, eine Datei, eine Kampagne, eine Warteschlange, ein Konto oder ein Studio-Projekt über den Link oder die ID, oder eine Seite der Referenz von SPREVA.

    Risiko
    Niedrig
    Nur lesend
  • overview

    Überblick über den Workspace

    Der erste Aufruf in einer Unterhaltung: Zeitzone und Uhrzeit, was Aufmerksamkeit braucht, was als Nächstes rausgeht, die Konten, Warteschlangen und Kampagnen und was der Tarif erlaubt.

    Risiko
    Niedrig
    Nur lesend
  • list_workspaces

    Deine Workspaces

    Listet die Workspaces auf, in denen diese Verbindung arbeiten kann, mit deiner Rolle und der Zeitzone in jedem, und sagt, in welchem die Aufrufe gerade ausgeführt werden.

    Risiko
    Niedrig
    Nur lesend
  • switch_workspace

    Workspace wechseln

    Setzt die Unterhaltung in einem anderen deiner Workspaces fort, per Name oder Link, wenn die Verbindung in allen erlaubt wurde. Die folgenden Aufrufe nutzen die Konten, Dateien und Agent-Berechtigungen dieses Workspaces.

    Risiko
    Niedrig
  • save_workspace

    Die Einstellungen des Workspaces ändern

    Benennt den Workspace um oder ändert seine Zeitzone, die Sprache, in der Dateibeschreibungen geschrieben werden, und ob neue Uploads automatisch beschrieben werden. Inhaber und Administratoren können das. Eine neue Zeitzone verschiebt keine Beiträge, die schon geplant sind.

    Risiko
    Mittel
  • list_members

    Die Personen im Workspace

    Listet die Mitglieder mit E-Mail und Rolle auf, dazu die noch offenen Einladungen und wann jeder Link abläuft.

    Risiko
    Niedrig
    Nur lesend
  • invite_member

    Jemanden einladen

    Lädt eine Person per E-Mail mit einer Rolle ein, immer nach einer Vorschau, die du bestätigst, weil sie eine E-Mail bekommt und einen Platz im Tarif belegen kann. Wer unter dieser Adresse schon ein SPREVA-Konto hat, ist sofort dabei. Inhaber und Administratoren können das; ein Administrator kann keinen Inhaber einladen.

    Risiko
    Hoch
  • save_post

    Einen Beitrag erstellen oder bearbeiten

    Schreibt einen Beitrag für ein oder mehrere Konten, mit dem, was pro Konto abweicht, und legt fest, wann er rausgeht: zu einer Uhrzeit, im nächsten Slot einer Warteschlange oder als Entwurf. In einem Workspace, der eine Freigabe verlangt, schickt eine Uhrzeit oder eine Warteschlange ihn stattdessen zur Prüfung, und er geht raus, sobald ein Mensch ihn freigibt.

    Risiko
    Mittel, Hoch, wenn er in weniger als einer Stunde rausgeht.
  • publish_post

    Einen Beitrag jetzt veröffentlichen

    Veröffentlicht einen Beitrag auf all seinen Konten oder erneut nur dort, wo es fehlgeschlagen ist. Was schon rausgegangen ist, wird nie doppelt gepostet. In einem Workspace, der eine Freigabe verlangt, wird ein Beitrag abgelehnt, den niemand freigegeben hat: Schick ihn mit save_post und einer Uhrzeit oder einer Warteschlange zur Prüfung.

    Risiko
    Hoch
  • delete_post

    Einen Beitrag löschen

    Entfernt einen Entwurf, einen geplanten oder einen veröffentlichten Beitrag aus SPREVA. Ein veröffentlichter Beitrag bleibt in den Netzwerken online.

    Risiko
    Mittel, Hoch bei einem veröffentlichten Beitrag.
  • import_media

    Eine Datei in die Bibliothek importieren

    Holt ein Bild oder ein Video über einen öffentlichen Link in die Bibliothek, oder aus Bytes, die der Agent hochlädt.

    Risiko
    Mittel
  • update_media

    Eine Datei der Bibliothek umbenennen, verschlagworten, einordnen oder beschreiben

    Ändert Name, Tags, Ordner oder Alternativtext einer Datei und kann den Alternativtext aus dem schreiben, was das Bild zeigt.

    Risiko
    Mittel, Hoch, wenn es den Alternativtext mit KI schreibt.
  • delete_media

    Dateien der Bibliothek löschen

    Löscht eine oder mehrere Dateien (Bilder, Videos, Audio) aus der Bibliothek, nach einer Vorschau und einer Bestätigung, die zeigen, wo jede genutzt wird und wie viel Speicher frei wird. Dateien, die in nicht veröffentlichten Beiträgen oder in Studio-Projekten genutzt werden, werden abgelehnt, es sei denn, der Agent erzwingt das Löschen.

    Risiko
    Hoch
  • share_media

    Eine Datei oder einen Ordner mit anderen Workspaces teilen

    Verleiht eine Datei der Bibliothek oder einen ganzen Ordner als schreibgeschützte Verweise an deine anderen Workspaces: Nichts wird kopiert, sie können die Datei in Videos und Beiträgen verwenden, aber nicht ändern oder löschen. Das Zurücknehmen verlangt eine Bestätigung, wenn dort Videos oder Beiträge sie verwenden.

    Risiko
    Mittel, Hoch beim Zurücknehmen einer Datei, die Videos oder Beiträge in einem anderen Workspace verwenden.
  • save_campaign

    Eine Kampagne erstellen oder bearbeiten

    Erstellt oder ändert eine Kampagne und fügt ihr Beiträge hinzu oder nimmt sie heraus.

    Risiko
    Mittel
  • save_queue

    Eine Warteschlange erstellen oder bearbeiten

    Erstellt oder ändert einen Zeitplan für Beiträge: Name, Zeitzone und wöchentliche Slots.

    Risiko
    Mittel
  • analytics

    Wie Beiträge gelaufen sind

    Summen im Vergleich zum vorherigen Zeitraum, die besten Beiträge, die Aufteilung nach Netzwerk und Vergleiche mit ihren Stichprobengrößen, für den Workspace, eine Kampagne, ein Konto oder einen Beitrag.

    Risiko
    Niedrig
    Nur lesend
  • refresh_metrics

    Zahlen aktualisieren

    Liest die Zahlen eines Beitrags oder die Follower eines Kontos sofort bei den Netzwerken aus, statt auf den üblichen Zeitplan zu warten, und lässt diesen Zeitplan unberührt. Derselbe Beitrag oder dasselbe Konto lässt sich nach fünf Minuten erneut aktualisieren.

    Risiko
    Niedrig
  • list_clippers

    Deine Clipper und ihre Aufrufe

    Die Konten, die mit deinem Clipper-Programm verknüpft sind, sortiert nach Aufrufen in einem Zeitraum, mit Netzwerk, @handle und Link jedes Kontos, und zuerst die, die auf deine Entscheidung warten.

    Risiko
    Niedrig
    Nur lesend
  • clipper_posts

    Die Beiträge eines Clipper-Kontos

    Was ein verknüpftes Konto seit dem Beitritt veröffentlicht hat, die neuesten zuerst, mit Aufrufen, Links und Daten. Nimmt den Namen, den @handle, den Link oder die id des Kontos.

    Risiko
    Niedrig
    Nur lesend
  • clipper_calendar

    Was deine Clipper geplant haben

    Die Beiträge, die deine Clipper für die nächsten Tage in SPREVA geplant haben, und die, die so veröffentlicht wurden, die frühesten zuerst, mit Konto, Netzwerk und Link, sobald sie online sind. Beiträge, die direkt in einem Netzwerk erstellt werden, stehen nicht hier.

    Risiko
    Niedrig
    Nur lesend
  • create_video

    Ein Studio-Video erstellen

    Legt ein leeres Studio-Projekt in einem Format an, das der Agent dann aufbaut. Gibt es schon ein Projekt mit diesem Namen, antwortet es mit diesem, statt eine Kopie anzulegen.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • narrate_video

    Ein Studio-Video vertonen

    Spricht das Skript ein, das der Agent geschrieben hat, und setzt jedes Wort auf die Timeline. Verbraucht KI-Credits, 1 je 100 Zeichen.

    Risiko
    Hoch
    Braucht einen Tarif, der das Studio enthält
  • compose_video

    Ein Studio-Video aus einem Markdown-Skript erstellen

    Baut ein komplettes Erklärvideo aus einem Markdown-Skript: was gesagt wird und was bei welchem Wort im Bild steht. Die Erzählung wird vertont, der Look legt Farben, Einblendungen, Übergänge und Sounds fest, die Kamera fährt auf das, was erscheint, und Untertitel und Musik kommen dazu. Das Ergebnis ist ein normales, bearbeitbares Studio-Projekt. Verbraucht KI-Credits, 1 je 100 Zeichen Erzählung, und antwortet zuerst mit einer Vorschau. Wird ein Projekt aus einem geänderten Skript neu aufgebaut, wird nur dann neu vertont, wenn sich die Erzählung geändert hat.

    Risiko
    Hoch
    Braucht einen Tarif, der das Studio enthält
  • match_media

    Dateien der Bibliothek einem Skript zuordnen

    Listet für jede Zeile eines Skripts die Dateien der Bibliothek, die am besten passen, nach dem, was sie zeigen, den Wörtern darauf, dem, was darin gesagt wird, und ihrer Qualität, mit der passenden Stelle eines Clips. Ändert nichts und verbraucht nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • find_sfx

    Soundeffekt nach seiner Wirkung finden

    Listet die drei besten Soundeffekte der Bibliothek für einen Moment eines Videos, nach Absicht, Emotion und Energie statt nach Dateiname, mit dem Grund für jeden und dem sanftesten zuerst. Passt nichts gut, oder auf Wunsch, erzeugt es mit dem Synthesizer von Spreva einen neuen Sound, speichert ihn in der Bibliothek und führt ihn zuerst auf. Verbraucht keine KI-Credits.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
  • find_music

    Musik nach Stimmung finden, abwechslungsreich

    Listet die drei besten Musikstücke der Bibliothek für ein Video, nach Stimmung, Genre, Energie und danach, wie gut sie unter einer Stimme funktionieren, statt nach Dateiname, mit dem Grund für jedes. Stücke, die die letzten Videos des Workspace verwendet haben, werden niedriger eingestuft, und Stücke, die das Projekt schon hat, werden zurückgehalten, damit nicht alle Videos dieselbe Musik haben. Noch nicht klassifizierte Stücke werden zur Klassifizierung eingereiht. Ändert nichts und kostet nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • find_icon

    Icon nach seiner Bedeutung finden

    Listet die Lucide-Icons, die am besten zu ein paar englischen Wörtern wie phone, security oder growth chart passen, mit ihren Tags und dem besten Treffer zuerst, und sagt, wie man eines in einer Motion Graphic einsetzt: der Block icon, der sich selbst zeichnet, oder Pfadknoten in einer Rohszene. Ändert nichts und kostet nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • create_sfx

    Einen Soundeffekt erstellen

    Erzeugt mit Sprevas eigenem Synthesizer einen neuen Soundeffekt, aus ein paar Wörtern auf Englisch oder Portugiesisch oder aus einem Rezept, das der Agent für volle Kontrolle schreibt. Er wird in der Bibliothek im Ordner „Generated sounds“ gespeichert und wie jeder andere Sound klassifiziert, sodass er gefunden und in ein Video gesetzt werden kann. Verbraucht keine KI-Credits.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • score_video

    Musik für ein Studio-Video komponieren

    Komponiert eine instrumentale Musik, die auf das Video zugeschnitten ist: ein ruhiges Intro, ein Aufbau, der Drop genau auf der Enthüllung und ein Ausklang. Sie landet als Musik in der Bibliothek und liegt als Bett unter dem Projekt, unter der Stimme abgesenkt. Verbraucht KI-Credits, 30 pro angefangene 30 Sekunden Video, und antwortet zuerst mit einer Vorschau.

    Risiko
    Hoch
    Braucht einen Tarif, der das Studio enthält
  • plan_edit

    Den Schnitt eines Studio-Videos planen

    Liest ein Studio-Video (was gesagt wird, die Einstellungen und Schnitte, was schon da ist) und die klassifizierten Sounds der Bibliothek, wählt das Rezept für die Art des Videos (Theorie, Liste, Nachrichten, Tutorial, Werbespot, Podcast, Vlog, Geschichte, Highlights) und wendet einen kompletten Schnitt in einem Schritt an, als eine gespeicherte Version: jeder Schnitt hart oder mit einem Übergang und seinem Sound, der Look, Untertitel, ein Hook, Musik, die unter der Stimme leiser wird, Zooms, Text und B-Roll. Einen Bildhintergrund freizustellen verbraucht KI-Credits, deshalb wird es angeboten und nie von selbst angewendet. Ohne Anwenden ändert es nichts und beschreibt nur den Plan.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
  • find_moments

    Momente in einem langen Video finden

    Zeigt, was ein langes Video sagt, Satz für Satz mit den Zeiten, wo es laut wird, was das Bild zeigt und welche Clips es vorschlagen würde, damit der Agent die Stellen wählt, die sich zum Schneiden lohnen. Ändert nichts und verbraucht nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
  • read_transcript

    Eine Datei Wort für Wort lesen

    Liest das Transkript einer Video- oder Audiodatei wie ein Editor: Sätze mit Zeiten und Sprechern, Füllwörter (äh, ähm) bleiben erhalten und sind markiert, und die Pausen werden aufgelistet. Mehrere Dateien lassen sich zusammen lesen, um Takes zu vergleichen, und ein Bereich kann Wort für Wort mit Anfang und Ende jedes Worts aufgelistet werden. Ändert nichts und kostet nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • make_clips

    Kurze Clips aus einem langen Video machen

    Schneidet die gewählten Stellen eines langen Videos in kurze vertikale Studio-Projekte, eines pro Stelle, mit Untertiteln aus dem Gesprochenen. Jedes ist ein Projekt zum Bearbeiten und Exportieren.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • edit_video

    Ein Studio-Video ändern

    Bearbeitet Text, Timing, Schnitte, Bilder, Clips, Effekte und Ton und fügt neue Elemente hinzu, mit den eigenen Bearbeitungsoperationen des Studios.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • save_video

    Ein Studio-Projekt umbenennen oder ablegen

    Benennt ein Projekt um und/oder legt es in einem Studio-Ordner ab oder holt es aus seinem Ordner; mehrere Projekte lassen sich auf einmal ablegen. Das Umbenennen braucht die Revision des Projekts; das Ablegen verändert das Video nicht. Außerdem kann es ein Projekt in einen deiner anderen Workspaces kopieren: Seine Dateien werden dort schreibgeschützt geteilt, und seine Markenschriften werden dort hinzugefügt.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • delete_video

    Studio-Projekte löschen

    Löscht ein oder mehrere Studio-Projekte, nach einer Vorschau und einer Bestätigung. Daraus exportierte Dateien bleiben in der Bibliothek.

    Risiko
    Hoch
    Braucht einen Tarif, der das Studio enthält
  • preview_video

    Bilder eines Studio-Videos ansehen

    Zeichnet die Bilder an den Stellen, die der Agent nennt, genau so wie der Export, damit er vor dem Export prüfen kann, was was verdeckt. Ändert nichts und verbraucht nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • inspect_media

    Einen Abschnitt einer Originaldatei ansehen

    Zeichnet ein Bild eines Abschnitts einer hochgeladenen Video- oder Audiodatei: gleichmäßig verteilte Bilder, die Wellenform des Tons mit schattierten Pausen und die gesprochenen Wörter an ihrer Stelle. Ändert nichts und verbraucht nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • compare_video

    Zwei Versionen eines Studio-Videos vergleichen

    Listet, was sich zwischen zwei Versionen eines Projekts geändert hat: jedes hinzugefügte, entfernte oder geänderte Element und was sich daran geändert hat. Kann beide Versionen auch an derselben Stelle zeigen. Ändert nichts.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • restore_video

    Eine Version eines Studio-Videos wiederherstellen

    Setzt ein Projekt auf eine seiner Versionen zurück. Das Ergebnis wird als neue Version behalten, also lässt sich auch das Wiederherstellen rückgängig machen.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • review_video

    Ein Studio-Video prüfen

    Prüft ein Projekt so, wie der KI-Editor des Studios seine eigene Arbeit prüft, und listet auf, was zu korrigieren ist, das Wichtigste zuerst. Es markiert, was der Export von selbst behebt.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • render_video

    Ein Studio-Video exportieren

    Exportiert ein Projekt als MP4 oder PNG in die Bibliothek, bereit für einen Beitrag. Vorher bringt es das Projekt von selbst auf die Mindestqualität (Untertitel, ein Hook, die Musik unter der Stimme, Übergänge innerhalb ihrer Grenzen) und speichert das als Version namens Quality pass; es berührt nie, was du von Hand gemacht hast.

    Risiko
    Hoch
    Braucht einen Tarif, der das Studio enthält
  • generate_image

    Ein Bild erzeugen

    Erstellt ein neues Bild aus einer Beschreibung, auf Wunsch in einem der Stile des Workspaces. Verbraucht 10 KI-Credits. Geht es um Bilder, die die Bibliothek schon hat, listet es diese zuerst auf und verbraucht nichts.

    Risiko
    Hoch
    Braucht einen Tarif, der das Studio enthält
  • mascot

    Maskottchen wählen

    Liest oder setzt das Maskottchen des Arbeitsbereichs: ein animierter SVG-Moderator, der spricht, blinzelt und Posen einnimmt. Kostenlos, ohne KI-Credits. Eingebautes wählen, mit den Markenfarben einfärben oder eigene Zeichnung nutzen.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält
  • use_skill

    Die Bearbeitungs-Skills des Workspaces lesen

    Listet die Bearbeitungs-Skills des Workspaces auf (die Anleitungen eines Creators: ein Look, ein Tempo, ein Rezept) oder liest einen ganz, damit der Agent ihm folgt, wenn er ein Video erstellt oder bearbeitet.

    Risiko
    Niedrig
    Braucht einen Tarif, der das Studio enthält
    Nur lesend
  • save_skill

    Einen Bearbeitungs-Skill speichern

    Erstellt, ändert, importiert aus einer SKILL.md oder löscht einen Bearbeitungs-Skill des Workspaces. Seine Beschreibung entscheidet, wann er verwendet wird.

    Risiko
    Mittel
    Braucht einen Tarif, der das Studio enthält

Der übliche Weg

Ein Agent beginnt mit overview für Zeitzone, Uhrzeit und Konten, findet Dinge mit search, liest eines vollständig mit fetch und ändert es mit save_post oder einem anderen Tool. Jede Antwort sagt, was als Nächstes möglich ist.

Namen statt IDs

Tools nehmen, was ein Mensch sagen würde: einen exakten Dateinamen, ein @Handle, den Namen einer Kampagne oder einen Link zu irgendetwas in SPREVA, aus dem Browser oder aus einer früheren Antwort eingefügt. Die Suche ist nachsichtig, das Ändern nicht: Ein Name, der auf mehreres passt, kommt als Auswahl zurück, und nichts wird gespeichert, bis eines gewählt ist.

Referenz für Agenten

Ein Agent liest die Referenz von SPREVA mit fetch, wenn er sie braucht, statt sie bei jedem Aufruf mitzuführen:

  • spreva://docs/platforms/tiktok und eine Seite pro Netzwerk: was es akzeptiert, Längen und Optionen.
  • spreva://docs/queues: Uhrzeiten, Zeitzonen und Warteschlangen.
  • spreva://docs/agent-permissions: Risikostufen, Bestätigungen, Revisionen und Anfrage-IDs.
  • spreva://docs/studio/making und spreva://docs/studio/editing: ein Video bauen, nur bei SPREVA.