Toolsets und Tools

Der AmICited MCP-Server registriert über 300 Tools, eines für alles, was das Dashboard kann. Alle diese Definitionen bei jeder Anfrage an ein Modell zu übergeben, würde einen großen Teil seines Kontexts verbrauchen, bevor es irgendetwas tut, und Modelle wählen aus einer sehr langen Liste schlechter. Deshalb legt der Server sie schrittweise offen: Ihr Client sieht eine kurze Liste, und der Agent schlägt den Rest nach, wenn er ihn braucht.

Sie müssen davon nichts verwalten. Agenten folgen dem Muster von selbst, geleitet von den Anweisungen des Servers und dem Skill using-amicited. Diese Seite erklärt, was sie tun, damit Sie ein Transkript lesen oder die Oberfläche gezielt eingrenzen können.

Was Ihr Client sieht#

tools/list bewirbt einen kleinen, festen Satz:

Weil sich diese Liste während einer Unterhaltung nie ändert, bleibt der Prompt-Cache des Clients gültig, was lange Sitzungen schnell und günstig hält.

Finden, prüfen, ausführen#

Jedes andere Tool wird in drei Schritten erreicht:

search_tools  {"query": "which prompts cite competitors but not us"}
describe_tool {"name": "seo_get_citation_gap_invisible_winners"}
read_tool     {"name": "seo_get_citation_gap_invisible_winners", "arguments": {...}}

• search_tools rankt Tools nach Name, Beschreibung und Toolset. Es funktioniert am besten mit der Frage in einfachen Worten („ist die Website down“, „Customer Lifetime Value“) statt mit einem halb erinnerten Namen. Übergeben Sie toolset mit leerer Abfrage, um einen Bereich zu durchstöbern, und erhöhen Sie offset, um durch einen großen zu blättern.
• describe_tool liefert das echte Argumentschema und die Art des Tools. Agenten sollten es immer aufrufen, bevor sie ein Tool ausführen, weil manche Tools flache Argumente nehmen und andere ein verschachteltes Objekt query.
• read_tool führt Tools der Art read aus: kostenlose, wiederholbare Lesezugriffe auf Ihre eigenen Daten. Es lehnt alles andere ab, weshalb es als schreibgeschützt markiert ist und vorsichtige Clients (zum Beispiel Codex mit ausgeschalteten Freigaben) es nutzen können, ohne nachzufragen.
• run_tool führt alles aus, einschließlich der anderen drei Arten:

Ein nicht beworbenes Tool ist nicht weniger geschützt. Jedes Tool prüft Berechtigungen, Tariflimits und Credits selbst, und run_tool wendet die eigene Schreibprüfung des Ziel-Tools an, sodass ein schreibgeschütztes Token darüber keinen Schreibzugriff erreicht.

Die zwölf Toolsets#

Jedes Tool gehört zu genau einem Toolset. Agenten nutzen sie, um zu entscheiden, wo sie suchen, und Sie können sie nutzen, um einen Bereich festzulegen (siehe unten).

Tool-Namen tragen ein Präfix nach Bereich (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), was Transkripte leicht überfliegbar macht.

Toolsets mit ?toolsets= festlegen#

Manche Clients kommen mit einem verschachtelten Aufruf von run_tool schlecht zurecht, und manchmal möchten Sie einen engen Agenten, der nur einen Bereich sieht. Hängen Sie einen Query-Parameter an die Verbindungs-URL an:

https://api.flowhunt.io/mcp/amicited?toolsets=eshop,uptime
https://api.flowhunt.io/mcp/amicited?toolsets=all

Die genannten Toolsets werden dann nativ in tools/list beworben, neben dem Kernsatz. all bewirbt alles, was die Kontexteinsparung aufgibt, nutzen Sie es also nur mit Clients, die eine eigene Tool-Suche haben. Unbekannte Namen werden ignoriert statt abgelehnt, prüfen Sie also die Schreibweise, wenn ein Bereich nicht erscheint. Die Auswahl ist für die Lebensdauer der Verbindung fest; kein Tool kann sie mitten in der Unterhaltung erweitern.

Seiten, Felder und Limits#

• Seiten mit 25 Zeilen. Jedes Tool, das eine Liste von Zeilen zurückgibt, liefert standardmäßig 25, höchstens 500 pro Aufruf. Gibt es mehr Zeilen, enthält die Antwort einen Block paging mit has_more und dem Wert, der im nächsten Aufruf zu übergeben ist (ein nativer Offset oder eine Seite oder ein next_cursor).
• fields. Tools, die eine Liste von Zeilen zurückgeben, akzeptieren ein Array fields, um nur die benötigten Spalten zurückzugeben. Eine Spalte, die die Zeilen nicht haben, wird abgelehnt, nicht ignoriert.
• Kein Workspace-Argument. Der Workspace ist durch Ihre Zugangsdaten festgelegt, daher akzeptiert kein Tool eine Workspace-ID. Fast jedes Tool braucht eine domain_id aus list_domains.
• Stündliches Limit. Tool-Aufrufe werden pro Workspace und Stunde gezählt (siehe Verbinden). Das Auflisten von Tools und das Lesen von Skills sind kostenlos; ein verborgenes Tool, das über read_tool oder run_tool erreicht wird, zählt einmal.

Verwandte Themen#