Zum Inhalt springen
Dokumentationsmenü

Was ein Agent tun kann

Die Tools, die der TileSet-MCP-Server einem Agenten bereitstellt, nach Aufgaben gruppiert.

Ein Agent installiert TileSet über diese Tools. Sie müssen sie selten nennen: Beschreiben Sie das gewünschte Ergebnis.

Einrichten

  • setup_widget: der, mit dem man anfängt. Stellt eine Quelle bereit oder verwendet eine vorhandene, erstellt oder verwendet ein Widget darauf und gibt den Snippet zurück. Kann wiederholt werden. Nimmt eine Quelle (google, youtube, testimonials, pinterest, x, twitch, kick) und, für die Quellen, die eine benötigen, eine Abfrage: ein Maps-Link, ein @-Handle, ein Pinterest-Profil- oder Board-Link oder @name (connect_source nimmt den Link als pinterestUrl), ein X-@handle- oder Profil-Link (connect_source nimmt ihn als xHandle), ein Twitch-Kanalname oder Twitch.tv-Link (connect_source nimmt ihn als twitchChannel), ein Kick-Kanalname oder Kick.com-Link (connect_source nimmt ihn als kickChannel). Testimonials nimmt keine Abfrage. Wenn Sie nur einen Link haben, lassen Sie source weg: setup_widget { "query": "https://www.youtube.com/@name" } ermittelt die Plattform aus der Adresse (connect_source macht dasselbe ohne type). Ein Google Maps-Link führt zu Google, und YouTube, Twitch, Kick, Pinterest, X-Links verbinden ihre eigene Quelle. Ein Link, den es nicht zuordnen kann, wird als Fehler zurückgegeben, der nach source fragt; nichts wird abgerufen oder berechnet, um ihn zu platzieren. Für einen gemischten Feed nimmt er stattdessen sourceIds, bereits verbundene Quellen.
  • verify_install: verify_install { "url": "<the page's URL>", "widgetId": "w_..." } ruft eine öffentliche Seite ab und meldet, ob das Skript und das div vorhanden sind und ob das Widget Elemente liefert. Ein erkannter Fehler (eine erfundene ID, ein von einem Seitenersteller gestripptes Skript, eine Login- oder Bot-Wall, eine zwischengespeicherte alte Seite) wird mit einer Fix-Zeile zurückgegeben, und ein fehlendes Skript-Tag oder div kommt mit der genauen Zeile, die hinzugefügt werden soll. Die „Check my page“ (Meine Seite prüfen) des Dashboards ist die gleiche Prüfung. Eine Seite, die sich im Browser selbst aufbaut (Lovable, React) oder eine Wix-Seite, deren Embed HTML-Box ein Frame ist, den unser Server nicht lesen kann, wird erst bestätigt, wenn die widgetId angegeben ist und das Widget einmal auf dieser Seite geladen wurde. Ein Erfolg wird auf der Dashboard-Karte des Widgets als „Installed“ (Installiert) angezeigt.
  • get_embed_code, list_sources, connect_source, list_widgets, create_widget, update_widget, describe_widget_options.
  • describe_source_content: beschreibt, was eine verbundene Quelle enthält, als Zählungen für die Auswahl eines Designs: wie viele Elemente, ihre Daten und wie oft neue eintreffen, die Sternebewertungen, wie viele Fotos, Videos oder mehrere Bilder enthalten, Bildformen, Textlängen, Schriftsysteme und Antworten des Eigentümers. Es gibt niemals die Elemente selbst zurück.
  • Der Vorschau-Link. Die Widget-Tools antworten mit einem Vorschau-Link, https://app.tileset.com/preview/<widgetId>: das Widget, wie Besucher es sehen, zum Öffnen in einem Browser.

Was ein Agent niemals liest

Ein Agent richtet Ihre Widgets ein und führt sie aus. Er liest niemals Ihre Inhalte: Kein Tool gibt einen Beitrag oder eine Bewertung, seine Worte, Namen, Bilder oder Links zurück. Er wählt ein Layout anhand der Zählungen aus und betrachtet die Vorschau. Wenn eine Quelle fehlschlägt, erhält der Agent einen festen Satz, nicht die eigene Antwort der Plattform. Sie sehen Ihre Inhalte im Dashboard, und Ihre Besucher sehen sie im Widget.

  • create_bio_page: erstellt eine „Link in bio“-Seite mit einem Namen, einer kurzen Biografie, einem Bild, einem Aussehen und Blöcken: Link-Buttons, Social-Icons und Blöcke aus den Quellen des Kontos (neueste Beiträge, das neueste Element als Feature-Karte, Bewertungen). Beantwortet die Adresse der Seite, um sie in eine Profil-Bio einzufügen. Eine Seite im kostenlosen Plan. Lassen Sie slug weg und die Seite erhält eine eigene kurze Adresse; die Auswahl des Slugs ist ab Starter inklusive, und der kostenlose Plan erhält eine klare Ablehnung, die den Plan nennt.
  • update_bio_page: ändert jedes Feld einer Seite, auch ihr Aussehen (theme, mode und style: Schriftarten, Hintergrund, Schaltflächen, Ecken, Form und Größe des Bildes, Abstände, Kopfzeile und ab Starter Ihre eigene Farbe und ein Bildhintergrund) und searchable; ein Link-Block nimmt ein icon (ein Emoji) oder ein thumb-Bild (ein https-Link oder ein JPEG als Data-URI, das als uploaded zurückkommt), eine thumbAlt-Beschreibung und eine Schaltflächen-color (ein Vorgabename wie forest oder ein beliebiger Hex-Wert); senden Sie blocks in neuer Reihenfolge zurück, um sie umzuordnen. Eine neue Adresse (ab Starter) leitet die alte 30 Tage lang weiter, eine zugewiesene für immer. add_bio_blocks fügt Blöcke am Ende hinzu, und list_bio_pages listet die Seiten mit ihren Adressen und allen Einstellungen auf. delete_bio_page löscht eine Seite, und get_bio_analytics liest ihre Aufrufe und Linkklicks. Keines davon gibt je den Inhalt zurück, den eine Seite zeigt.

Testimonials

  • add_testimonials: fügt einer Testimonials-Quelle bis zu 20 Testimonials hinzu, jeweils mit Name und Text sowie, falls vorhanden, Rolle oder Firma, einer Bewertung von 1 bis 5, einem Datum und einem https-Foto-Link. Was ein Agent hinzufügt, wartet im Dashboard auf Ihre Freigabe. Der Agent ist angewiesen, nur Worte hinzuzufügen, die ein echter Kunde gesagt hat, und nie selbst Testimonials zu schreiben.
  • list_testimonials: zählt die Einträge einer Testimonial-Quelle: wie viele auf Ihre Freigabe warten, wie viele im Widget sind und wie viele die automatische Prüfung als wahrscheinlichen Spam gefiltert hat (nur Testimonials, die über den Link gesendet werden, werden jemals geprüft, niemals das, was ein Agent hinzufügt). Das Tool gibt niemals die Einträge selbst zurück. Lesen, Freigeben, Ablehnen, Bearbeiten, Löschen, die Reihenfolge und der „Share a testimonial“-Link bleiben im Dashboard für eine Person. list_sources gibt an, wann der Link einer Quelle von selbst pausiert hat, weil ihre Warteschlange voll ist.

Aktualisierungen steuern

  • update_source: benennen Sie eine Quelle um (label), legen Sie ihre Geschwindigkeit oder ihren Kalenderplan fest. Eine Quelle wird nach ihrem Konto benannt, es sei denn, connect_source erhält einen label.
  • update_source_now und get_update_status: „Update now“ (ab Starter) und das Verfolgen einer langsameren Aktualisierung.
  • get_source_schedule, create_source_webhook, delete_source_webhook.

Credits

  • get_credits: Guthaben, Kontingent, Datum der Gutschrift, Kosten jeder Geschwindigkeit und für jede Live-Quelle, welche Geschwindigkeiten Ihre Credits abdecken, welche nicht und welche über Ihrem Plan liegen.
  • set_credit_limits: die monatliche Obergrenze und die Zeitzone des Kontos.

Ihr Agent kauft niemals etwas. Wenn die Credits knapp werden, informiert er Sie, und Sie fügen Credits unter „Credits“ hinzu oder ändern den Plan unter „Plans“ (Tarife) im Dashboard.

Destruktiv

delete_source entfernt eine Quelle und jedes Widget, das allein auf ihr basiert; ein gemischtes Widget verliert die Quelle und behält seine anderen. delete_widget entfernt ein Widget; Seiten, die es noch einbetten, zeigen nichts an. Beides ist endgültig. Wenn Ihr Agent vorher nachfragen soll, schreiben Sie das in Ihre Projektanweisungen.

Für Agenten, die dies lesen

Die maßgebliche, maschinenlesbare Version ist llms.txt.

Der Server hat nur Werkzeuge, keine Ressourcen.