Zestawy narzędzi i narzędzia

Serwer MCP AmICited rejestruje ponad 300 narzędzi, po jednym na wszystko, co potrafi pulpit. Przekazywanie modelowi wszystkich tych definicji przy każdym żądaniu zużywałoby dużą część jego kontekstu, zanim wykona jakąkolwiek pracę, a modele gorzej wybierają narzędzia z bardzo długiej listy. Dlatego serwer ujawnia je stopniowo: Twój klient widzi krótką listę, a agent wyszukuje resztę, gdy jej potrzebuje.

Nie musisz tym zarządzać. Agenci stosują ten wzorzec sami, kierowani instrukcjami serwera i skillem using-amicited. Ta strona wyjaśnia, co robią, abyś mógł czytać transkrypt lub świadomie zawęzić powierzchnię.

Co widzi Twój klient#

tools/list ogłasza niewielki, stały zestaw:

Ponieważ ta lista nie zmienia się w trakcie rozmowy, pamięć podręczna promptów klienta pozostaje ważna, co utrzymuje długie sesje szybkie i tanie.

Znajdź, sprawdź, uruchom#

Do każdego innego narzędzia docierasz w trzech krokach:

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 szereguje narzędzia według nazwy, opisu i zestawu narzędzi. Działa najlepiej z pytaniem zwykłymi słowami („is the site down”, „customer lifetime value”), a nie półzapamiętaną nazwą. Przekaż toolset z pustym zapytaniem, aby przeglądać jeden obszar, i zwiększaj offset, aby przeglądać duży.
• describe_tool zwraca prawdziwy schemat argumentów i rodzaj narzędzia. Agenci powinni zawsze wywoływać go przed uruchomieniem narzędzia, ponieważ niektóre narzędzia przyjmują płaskie argumenty, a inne zagnieżdżony obiekt query.
• read_tool uruchamia narzędzia, których rodzaj to read: darmowe, powtarzalne odczyty Twoich własnych danych. Odmawia wszystkiego innego, dlatego jest oznaczone jako tylko do odczytu i dlatego ostrożni klienci (na przykład Codex z wyłączonymi zatwierdzeniami) mogą go używać bez zatrzymywania się na pytanie.
• run_tool uruchamia wszystko, w tym pozostałe trzy rodzaje:

Narzędzie, które nie jest ogłaszane, nie jest przez to mniej chronione. Każde narzędzie samo sprawdza uprawnienia, limity planu i kredyty, a run_tool stosuje własną kontrolę zapisu narzędzia docelowego, więc token tylko do odczytu nie dotrze przez niego do zapisu.

Dwanaście zestawów narzędzi#

Każde narzędzie należy do dokładnie jednego zestawu narzędzi. Agenci używają ich, by zdecydować, gdzie szukać, a Ty możesz ich użyć, by przypiąć obszar (zobacz niżej).

Nazwy narzędzi mają prefiks obszaru (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), co ułatwia przeglądanie transkryptów.

Przypinanie zestawów narzędzi przez ?toolsets=#

Niektórzy klienci słabo obsługują zagnieżdżone wywołanie run_tool, a czasem chcesz wąskiego agenta, który widzi tylko jeden obszar. Dodaj parametr zapytania do adresu URL połączenia:

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

Nazwane zestawy narzędzi są wtedy ogłaszane natywnie w tools/list, obok zestawu podstawowego. all ogłasza wszystko, co rezygnuje z oszczędności kontekstu, więc używaj go tylko z klientami, którzy sami wyszukują narzędzia. Nieznane nazwy są ignorowane, a nie odrzucane, więc sprawdź pisownię, jeśli obszar się nie pojawia. Wybór jest stały przez cały czas życia połączenia; żadne narzędzie nie może go rozszerzyć w trakcie rozmowy.

Strony, pola i limity#

• Strony po 25 wierszy. Każde narzędzie zwracające listę wierszy domyślnie zwraca 25, maksymalnie 500 na wywołanie. Gdy istnieje więcej wierszy, odpowiedź zawiera blok paging z has_more i wartością do przekazania w następnym wywołaniu (natywny offset lub strona albo next_cursor).
• fields. Narzędzia zwracające jedną listę wierszy przyjmują tablicę fields, aby zwrócić tylko potrzebne kolumny. Kolumna, której wiersze nie mają, jest odrzucana, a nie ignorowana.
• Brak argumentu przestrzeni roboczej. Przestrzeń robocza jest ustalona przez Twoje poświadczenie, więc żadne narzędzie nie przyjmuje identyfikatora przestrzeni roboczej. Prawie każde narzędzie potrzebuje domain_id z list_domains.
• Limit godzinowy. Wywołania narzędzi są liczone na przestrzeń roboczą na godzinę (zobacz połącz). Wypisywanie narzędzi i czytanie skilli są darmowe; ukryte narzędzie osiągnięte przez read_tool lub run_tool liczy się raz.

Powiązane#