Eszközreferencia

Ez azoknak az eszközöknek a teljes listája, amelyeket egy API-kulcs láthat. A kliensed csak azokat az eszközöket látja, amelyekhez a kulcsodnak megvan a jogosultsága (lásd: Az MCP áttekintése). Minden eszköz egyetlen szöveges elemet ad vissza, amely egy JSON-dokumentumot tartalmaz; az eredmény szerkezetét eszközönként mutatjuk be.

Így olvasd ezt az oldalt. Az Olvasás jelölésű eszközök csak olvasnak. Az Írás jelölésű eszközök létrehoznak, módosítanak, törölnek vagy elküldenek valamit. Az Aszinkron jelölésű eszközök még a munka befejezése előtt visszatérnek, ezért az állapotukat időnként le kell kérdezned. A number típusú argumentumokat a szerver egész számként olvassa, hacsak másként nem jelezzük. A lapozható eszközök limit és offset argumentumot fogadnak, és total_count, limit és offset mezőt adnak vissza.

Gyors áttekintés

Terület	Eszközök
Chat és beszélgetések	send_message, get_conversation, list_conversations, delete_conversation
Promptok és futtatások	list_prompts, get_prompt, run_prompt, custom_run, list_ai_models
Ügynökök és munkafolyamatok	list_agents, get_agent, list_workflow_tasks, get_workflow_task, run_workflow_task
Tudás és fájlok	list_knowledge_bases, search_knowledge_base, list_files, get_file
Projektek és csapatok	list_projects, get_project, create_project, delete_project, list_workspace_members, list_teams, list_team_members
Médiagenerálás	generate_image, edit_image, generate_video, get_video_generation_status, delete_video_generation, generate_speech, get_tts_generation_status, delete_tts_generation, generate_music, get_music_generation_status, delete_music_generation
Hangátírás	transcribe, get_transcription_status, delete_transcription
Táblázatok	list_spreadsheet_processing_tasks, get_spreadsheet_processing_task, start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing
Integrációk: e-mail	list_email_connections, send_email
Integrációk: CRM	list_crm_connections, search_crm_contacts, list_crm_contacts, add_crm_contact, edit_crm_contact, search_crm_deals, list_crm_deals, create_crm_deal, list_crm_lists, list_crm_tags
Integrációk: adatbázisok	list_database_connections, list_database_tables, describe_database_tables, run_database_query
Integrációk: tárhely	list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry, import_storage_files, export_file_to_storage
Keresés	search
Csak a StickyPrompts munkatársainak	get_usage_statistics

Chat és beszélgetések

send_message

Üzenetet küld egy AI-modellnek, és szinkron módon visszaadja a válaszát. Új beszélgetés indításához hagyd el a conversation_id argumentumot, egy meglévő folytatásához add meg. Az eszköz ugyanazt a beszélgetést hozza létre vagy frissíti, amelyet a StickyPrompts alkalmazásban is látsz.

Írás Jogosultság: conversations_manage

Eredmény: {"conversation_id": <id>, "text": "<assistant reply>"}. Ha az üzenetben a címkéjével megemlíted (@mentions) valamelyik ügynöködet, az üzenetet az az ügynök kapja meg, ahogy az alkalmazásban is. Hibák: conversation not found eszközhiba (tool error); a modell- és szolgáltatói hibák JSON-RPC-hibaként érkeznek.

get_conversation

Lekér egy saját beszélgetést, az üzenetek átiratával együtt.

Olvasás Jogosultság: conversations_get

Eredmény: {"id", "name", "messages": [{"is_user": bool, "text": "..."}]}. Hibák: conversation not found eszközhiba.

list_conversations

Listázza a saját interaktív beszélgetéseidet (a csapattal megosztottakat és az ügynökbeszélgetéseket nem), oldalanként, a legutóbb frissítettel kezdve.

Olvasás Jogosultság: conversations_get

Eredmény: {"conversations": [{"id", "name"}], "total_count", "limit", "offset"}.

delete_conversation

Töröl egy saját beszélgetést.

Írás Destruktív Jogosultság: conversations_delete

Eredmény: {"deleted": true}. Hibák: conversation not found eszközhiba.

Promptok és futtatások

list_prompts

Listázza a saját promptjaidat (a projekthez kötötteket és a veled megosztottakat nem), oldalanként. A run_prompt hívása előtt a get_prompt eszközzel nézd meg, milyen változókat vár a prompt.

Olvasás Jogosultság: prompts_get

Eredmény: {"prompts": [{"id", "name", "slug", "description", "is_favorite"}], "total_count", "limit", "offset"}.

get_prompt

Lekér egy saját promptot, a jelenlegi verziójának tartalmával és az általa fogadott változókkal együtt.

Olvasás Jogosultság: prompts_get

Eredmény: {"id", "name", "slug", "description", "content", "variables": [{"slug", "name", "description", "required", "default_value"}]}. Hibák: prompt not found eszközhiba, a veled megosztott, de nem a te tulajdonodban lévő promptoknál is.

run_prompt

Kitölti egy prompt változóit, lefuttatja egy modellen, és visszaadja a válasz szövegét. Különálló, egyszeri hívásként fut; nem hoz létre interaktív beszélgetést az alkalmazásban.

Írás Jogosultság: run_prompt

Eredmény: {"text": "<model response>"}. Hibák: prompt not found, prompt has no current version, variable "<slug>" must be a string vagy missing a value for a required variable eszközhiba, illetve az érzékeny adatokra vonatkozó hibaüzenet, ha egy védőkorlát blokkolja a kitöltött promptot. A modell- és szolgáltatói hibák JSON-RPC-hibaként érkeznek.

custom_run

Nyers promptszöveget futtat le egy modellen mentett prompt nélkül, és visszaadja a válasz szövegét. Különálló, egyszeri hívásként fut; nem hoz létre beszélgetést.

Írás Jogosultság: custom_run

Eredmény: {"text": "<model response>"}.

list_ai_models

Listázza a futtatáshoz elérhető modelleket. Kihagyja azokat, amelyeket a munkaterületed korlátoz (az adatrezidencia-szabályokat is beleértve), és alapértelmezés szerint az elavult modelleket is.

Olvasás Jogosultság: ai_models_get

Eredmény: {"models": [{"id", "name", "powered_by", "description", "premium"}]}, a platform saját sorrendjében.

Ügynökök és munkafolyamatok

list_agents

Listázza a saját ügynökeidet (a csapat vagy a munkaterület által veled megosztottakat nem). Nincs lapozás.

Olvasás Jogosultság: agents_get

Eredmény: {"agents": [{"id", "name", "slug", "tag"}]}. A tag az, amivel a send_message üzenetében megemlíted (@mention) az ügynököt.

get_agent

Lekér egy ügynököt, amelyhez hozzáférsz, a rendszerpromptjával és a beállított modelljével együtt.

Olvasás Jogosultság: agents_get

Eredmény: {"id", "name", "slug", "description", "system_prompt", "ai_model_id", "ai_model_name"}. Hibák: agent not found vagy you don't have access to this agent eszközhiba.

list_workflow_tasks

Listázza a saját ütemezett munkafolyamat-feladataidat, oldalanként.

Olvasás Jogosultság: workflow_tasks_get

Eredmény: {"workflow_tasks": [{"id", "name", "slug", "enabled"}], "total_count", "limit", "offset"}.

get_workflow_task

Lekér egy általad kezelt munkafolyamat-feladatot, az utasításaival és a futtatások sikerességi arányával együtt.

Olvasás Jogosultság: workflow_tasks_get

Eredmény: {"id", "name", "slug", "description", "instructions", "enabled", "total_run_count", "success_rate"}. Hibák: workflow task not found or access denied eszközhiba.

run_workflow_task

Azonnal elindítja egy munkafolyamat-feladat egy futtatását, az ütemezésén kívül. Rögtön visszatér az új végrehajtás azonosítójával és állapotával; nem várja meg, hogy a futtatás befejeződjön.

Írás Aszinkron Jogosultság: workflow_tasks_manage

Eredmény: {"execution_id": <id>, "status": "running"}. Egy végrehajtás kimenetelét egyetlen MCP-eszköz sem olvassa ki: amikor befejeződik, a get_workflow_task eredményében a total_run_count és a success_rate már tükrözi. Ha a tulajdonos kvótája elfogyott, a végrehajtás quota exceeded hibával meghiúsul. Hibák: workflow task not found or access denied eszközhiba.

Tudás és fájlok

list_knowledge_bases

Listázza a saját tudásbázisaidat és azokat, amelyekhez hozzáférést kaptál.

Olvasás Jogosultság: knowledge_bases_get

Nincs argumentuma. Eredmény: {"knowledge_bases": [{"id", "name", "description"}]}.

search_knowledge_base

Egy lekérdezéshez illeszkedő szövegrészleteket keres egy tudásbázisban, és visszaadja a részleteket a forrásfájlokkal együtt. Ugyanaz a szemantikus keresés, amelyet egy beszélgetés is használ; REST-es megfelelője nincs.

Olvasás Jogosultság: knowledge_bases_get

Eredmény: {"context": "<retrieved passages as text>", "files": [{"id", "name"}]}. A rendszer tudásbázis-felhasználásként rögzíti. Hibák: knowledge base not found or access denied eszközhiba, vagy a visszakeresés hibaüzenete.

list_files

Listázza a saját feltöltött és generált fájljaidat, a legújabbal kezdve, oldalanként. Fájlfeltöltésre nincs MCP-eszköz.

Olvasás Jogosultság: files_get

Eredmény: {"files": [{"id", "name", "file_type"}], "total_count", "limit", "offset"}.

get_file

Lekéri egy saját fájlod metaadatait, például azért, hogy az azonosítóját átadhasd az edit_image eszköznek.

Olvasás Jogosultság: files_get

Eredmény: {"id", "name", "file_type"}, URL és tartalom nélkül. Hibák: file not found or access denied eszközhiba.

Projektek és csapatok

list_projects

Listázza a saját projektjeidet és a veled megosztottakat, oldalanként.

Olvasás Jogosultság: projects_get

Eredmény: {"projects": [{"id", "name", "slug", "description"}], "total_count", "limit", "offset"}.

get_project

Lekér egy projektet, amelyhez hozzáférsz.

Olvasás Jogosultság: projects_get

Eredmény: {"id", "name", "slug", "description", "instructions"}. Hibák: project not found vagy you don't have access to this project eszközhiba.

create_project

Új projektet hoz létre, amelynek te leszel a tulajdonosa.

Írás Jogosultság: projects_manage

Eredmény: {"id", "slug", "name"}.

delete_project

Töröl egy saját projektet. Csak a tulajdonos törölhet.

Írás Destruktív Jogosultság: projects_delete

Eredmény: {"deleted": true}. Hibák: project not found vagy you don't have access to this project eszközhiba.

list_workspace_members

Listázza a munkaterületed tagjait, oldalanként.

Olvasás Jogosultság: organization_get

Eredmény: {"members": [{"id", "email", "first_name", "last_name", "is_owner", "permissions": [...]}], "total_count", "limit", "offset"}. A munkaterület tulajdonosa mindig permissions: ["admin"] értékkel szerepel.

list_teams

Listázza a munkaterületed összes csapatát. Nincs lapozás.

Olvasás Jogosultság: teams_get

Eredmény: {"teams": [{"id", "name", "description", "color", "member_count"}]}.

list_team_members

Listázza egy csapat tagjait, oldalanként. Ehhez a munkaterület adminjának vagy a csapat tagjának kell lenned.

Olvasás Jogosultság: teams_get

Eredmény: {"members": [{"id", "email", "first_name", "last_name", "role"}], "total_count", "limit", "offset"}. Hibák: team not found vagy not authorized to view the members of this team JSON-RPC-hiba.

Médiagenerálás

A médiaeszközök nem fogadnak modellargumentumot: a StickyPrompts minden médiatípushoz a beállított modellt használja. Az eredményben szerepel a path, vagyis a tárolt fájl közvetlen URL-je (nem aláírt és nem lejáró link), valamint az _attachments, egy {"type": "file", "id": <file id>} elemekből álló lista, amelynek azonosítóit más eszközöknek is átadhatod.

generate_image

Képet generál egy promptból.

Írás Jogosultság: image_generation_manage

Eredmény (szinkron): {"path": "<storage URL>", "_attachments": [{"type": "file", "id": <file id>}]}.

edit_image

Utasítások alapján szerkeszt egy meglévő képet. Új fájlt ad vissza.

Írás Jogosultság: image_generation_manage

Eredmény: ugyanolyan szerkezetű, mint a generate_image eredménye, új fájlazonosítóval. Hibák: file not found or access denied JSON-RPC-hiba.

generate_video

Elindítja egy videó generálását egy promptból, igény szerint egy kezdőkép animálásával. Azonnal visszatér a generálás azonosítójával és állapotával; ezután a get_video_generation_status eszközzel kérdezd le az állapotot, amíg done vagy error nem lesz. A generálás több percig is tarthat.

Írás Aszinkron Jogosultság: video_generation_manage

Eredmény: {"id": <video generation id>, "status": "queued"}. Hibák: JSON-RPC-hiba, ha a képarány, a felbontás vagy az időtartam nem támogatott, ha a képek kombinációja érvénytelen, vagy ha a munkaterületed nem használhatja a modellt.

get_video_generation_status

Ellenőrzi egy generate_video által indított videógenerálás állapotát. Az állapot queued, processing, done vagy error. Amíg queued vagy processing, várj (például 15-60 másodpercet), majd hívd meg újra.

Olvasás Jogosultság: video_generation_get

Eredmény: {"id", "status"}, error állapotnál az error mezővel, done állapotnál a path és az _attachments mezővel kiegészítve. Hibák: ha a generálás nem található, JSON-RPC-hibát kapsz.

delete_video_generation

Töröl egy saját videógenerálást.

Írás Destruktív Jogosultság: video_generation_delete

Eredmény: {"deleted": true}.

generate_speech

Szöveget alakít beszéddé. Akkor tér vissza, amikor a hanganyag elkészült.

Írás Jogosultság: tts_generation_manage

Eredmény (szinkron): {"path": "<storage URL>", "_attachments": [{"type": "file", "id": <file id>}]}. Generálási azonosítót nem ad vissza.

get_tts_generation_status

Ellenőrzi egy korábbi szövegfelolvasási generálás állapotát. Az állapot queued, processing, done vagy error. Mivel a generate_speech nem ad vissza generálási azonosítót, ehhez az alkalmazásból vagy a REST API-ból származó azonosítót kell használnod.

Olvasás Jogosultság: tts_generation_get

Eredmény: {"id", "status"}, kiegészítve az error mezővel, vagy elkészült generálásnál a path és az _attachments mezővel. Hibák: tts generation not found eszközhiba.

delete_tts_generation

Töröl egy saját szövegfelolvasási generálást.

Írás Destruktív Jogosultság: tts_generation_delete

Eredmény: {"deleted": true}.

generate_music

Zenét generál egy szöveges promptból. Akkor tér vissza, amikor a hanganyag elkészült.

Írás Jogosultság: music_generation_manage

Eredmény (szinkron): {"path", "duration_seconds", "_attachments"}, és ha a modell dalszöveget is készített, a lyrics mező. Generálási azonosítót nem ad vissza.

get_music_generation_status

Ellenőrzi egy korábbi zenegenerálás állapotát. Az állapot queued, processing, done vagy error. Mivel a generate_music nem ad vissza generálási azonosítót, ehhez az alkalmazásból vagy a REST API-ból származó azonosítót kell használnod.

Olvasás Jogosultság: music_generation_get

Eredmény: {"id", "status"}, kiegészítve az error mezővel, vagy elkészült generálásnál a path, a duration_seconds és az _attachments mezővel (és ha van, a lyrics mezővel). Hibák: music generation not found eszközhiba.

delete_music_generation

Töröl egy saját zenegenerálást.

Írás Destruktív Jogosultság: music_generation_delete

Eredmény: {"deleted": true}.

Hangátírás

transcribe

Hang- vagy videófájlt ír át szöveggé egy nyilvános URL-ről. Akkor tér vissza, amikor az átirat elkészült, ezért hosszú felvételekhez állíts be bőkezű időkorlátot a kliensedben.

Írás Jogosultság: transcription_manage

Eredmény (szinkron): {"text": "<transcript>", "_attachments": [{"type": "transcription", "id": <transcription id>}]}. Az átirat azonosítója csak az _attachments mezőben szerepel.

get_transcription_status

Ellenőrzi egy korábbi hangátírás állapotát. Az állapot queued, fetching, preparing, processing, done vagy error.

Olvasás Jogosultság: transcription_get

Eredmény: {"id", "status"}, kiegészítve az error mezővel, vagy elkészült átiratnál a text és az _attachments mezővel. Hibák: transcription not found eszközhiba.

delete_transcription

Töröl egy saját átiratot.

Írás Destruktív Jogosultság: transcription_delete

Eredmény: {"deleted": true}.

Táblázatok

A táblázatfeldolgozás egy promptsablont futtat le egy xlsx-munkalap minden során, és a választ egy kimeneti oszlopba írja. Mind az öt eszköz egy feladatobjektumot ad vissza: {"task_id", "status", "processed_rows", "total_rows", "original_file_id", "created_at", "credit_cost"}, kiegészítve az error, a result_preview, az eta és a generated_file_id mezővel, ha vannak. Az állapot lehetséges értékei: queued, initializing, processing, paused, done, error.

list_spreadsheet_processing_tasks

Listázza a saját táblázatfeldolgozási feladataidat, oldalanként.

Olvasás Jogosultság: spreadsheet_processing_get

Eredmény: {"tasks": [task], "total_count", "limit", "offset"}.

get_spreadsheet_processing_task

Lekéri egy saját feladatod állapotát és előrehaladását.

Olvasás Jogosultság: spreadsheet_processing_get

Eredmény: egy feladatobjektum. Hibák: task not found eszközhiba. Közvetlenül az indítás után lekérdezve rövid ideig ezt is kaphatod, amíg a feladat létrejön.

start_spreadsheet_processing

Elindítja egy olyan xlsx-fájl feldolgozását, amely már megvan a StickyPromptsban. A háttérben fut, és azonnal visszaad egy task_id azonosítót; ezután a get_spreadsheet_processing_task eszközzel kérdezd le az állapotot, amíg done vagy error nem lesz.

Írás Aszinkron Jogosultság: spreadsheet_processing_manage

Eredmény: {"task_id": "<32-character id>"}. Hibák: file not found eszközhiba.

pause_spreadsheet_processing

Szünetelteti egy saját, futó feladatodat. Csak a queued, initializing vagy processing állapotú feladatok szüneteltethetők.

Írás Jogosultság: spreadsheet_processing_manage

Eredmény: a feladatobjektum. Hibák: task not found, file processing cannot be paused currently, file processing is already paused, file processing is already finished vagy file processing is not running eszközhiba.

resume_spreadsheet_processing

Folytatja egy saját, szüneteltetett feladatodat. A feladat újra sorba kerül, az esetleges részleges kimeneti fájlt pedig a rendszer elveti és újragenerálja.

Írás Aszinkron Jogosultság: spreadsheet_processing_manage

Eredmény: a feladatobjektum status: "queued" értékkel. Hibák: task not found, file processing is already running, file processing is already finished vagy file processing is not paused eszközhiba.

Integrációk: e-mail

A StickyPromptsban csatlakoztatott e-mail-fiókkal (Postmark, Resend, SendGrid vagy SMTP) működik. A kapcsolatokat az alkalmazásban állíthatod be; lásd: E-mail-küldés.

list_email_connections

Listázza a csatlakoztatott e-mail-fiókjaidat, a személyeseket és a munkaterülettel megosztottakat is. Ha egy sincs csatlakoztatva, üres listát ad vissza.

Olvasás Jogosultság: integration_email_get

Nincs argumentuma. Eredmény: {"connections": [{"connection_id", "provider", "name", "description", "sends_from"}]}.

send_email

E-mailt küld valamelyik csatlakoztatott e-mail-fiókodon keresztül. A levél ténylegesen kimegy, és ez nem vonható vissza, ezért a hívás előtt ellenőrizd a címzetteket és a tartalmat. A html_body vagy a text_body megadása kötelező.

Írás Jogosultság: integration_email_manage

Eredmény: {"message_id": "...", "provider": "..."}.

Integrációk: CRM

A StickyPromptsban csatlakoztatott ActiveCampaign-, Brevo- vagy Pipedrive-fiókkal működik; lásd: CRM. Az író eszközökhöz (add_crm_contact, edit_crm_contact, create_crm_deal) az is kell, hogy maga a kapcsolat engedélyezze az írást. A kapcsolatok alapértelmezés szerint csak olvashatók.

list_crm_connections

Listázza a csatlakoztatott CRM-fiókjaidat, a személyeseket és a munkaterülettel megosztottakat is. Ha egy sincs csatlakoztatva, üres listát ad vissza.

Olvasás Jogosultság: integration_crm_get

Nincs argumentuma. Eredmény: {"connections": [{"connection_id", "provider", "name", "description"}]}.

search_crm_contacts

Kontaktokat keres egy csatlakoztatott CRM-ben. Használd az edit_crm_contact előtt a kontakt megtalálásához, vagy az add_crm_contact előtt a duplikátumok elkerüléséhez.

Olvasás Jogosultság: integration_crm_get

Eredmény: {"contacts": [{"remote_id", "provider", "contact"}]}.

list_crm_contacts

Kontaktok böngészése oldalanként, a szolgáltató saját sorrendjében, keresőkifejezés nélkül.

Olvasás Jogosultság: integration_crm_get

Eredmény: {"contacts": [...], "has_more": bool, "next_cursor": "..."} (a next_cursor elmarad, ha üres).

add_crm_contact

Új kontaktot ad hozzá. Mindig újat hoz létre, meglévőt sosem frissít.

Írás Jogosultság: integration_crm_manage

Eredmény: {"remote_id", "provider", "contact": {...}}.

edit_crm_contact

Szerkeszt egy meglévő kontaktot, amelyet az e-mail-címe alapján keres meg. Ha nincs ilyen e-mail-című kontakt, a hívás meghiúsul; újat sosem hoz létre.

Írás Jogosultság: integration_crm_manage

A kihagyott mezők nem változnak; a kifejezetten elküldött üres karakterlánc törli a mező értékét. Eredmény: {"remote_id", "provider", "contact": {...}}.

search_crm_deals

Üzleteket (deal) keres a cím vagy a hozzájuk kapcsolt kontakt e-mail-címe alapján. A create_crm_deal előtt ezzel ellenőrizd, van-e már ilyen üzlet.

Olvasás Jogosultság: integration_crm_get

Eredmény: {"deals": [{"remote_id", "provider", "deal"}]}.

list_crm_deals

Üzletek böngészése oldalanként, a szolgáltató saját sorrendjében. Nem minden CRM-szolgáltató kezel üzleteket, ezért előbb ellenőrizd a kapcsolat szolgáltatóját.

Olvasás Jogosultság: integration_crm_get

Eredmény: {"deals": [...], "has_more", "next_cursor"}.

create_crm_deal

Egy meglévő kontakthoz kapcsolt üzletet hoz létre. Nem minden CRM-szolgáltató kezel üzleteket, ezért előbb ellenőrizd a kapcsolat szolgáltatóját.

Írás Jogosultság: integration_crm_manage

Eredmény: {"remote_id", "provider", "deal": {"title", "value", "currency", "contact_email", "stage"}}.

list_crm_lists

Listázza egy csatlakoztatott CRM kontaktlistáit vagy szegmenseit (csak Brevo és ActiveCampaign, Pipedrive nem). Az azonosítókat list_id szűrőként vagy a list_ids mezőben használhatod.

Olvasás Jogosultság: integration_crm_get

Eredmény: {"lists": [{"id", "name"}]}.

list_crm_tags

Listázza egy csatlakoztatott CRM kontaktcímkéit (csak ActiveCampaign). Az azonosítókat tag_id szűrőként vagy a tag_ids mezőben használhatod.

Olvasás Jogosultság: integration_crm_get

Eredmény: {"tags": [{"id", "name"}]}.

Integrációk: adatbázisok

A StickyPromptsban csatlakoztatott MySQL-, MariaDB-, PostgreSQL- és SQL Server-adatbázisokkal működik; lásd: Adatbázisok. Minden kapcsolatnak saját jogosultsági szintje van, és valójában ez szabja meg, mit tehet egy lekérdezés: a read_only csak egyetlen SELECT vagy WITH utasítást fogad el, a create_update egyetlen INSERT vagy UPDATE utasítást is enged, a full_access pedig semmit sem szűr.

list_database_connections

Listázza a csatlakoztatott adatbázisaidat, a személyeseket és a munkaterülettel megosztottakat is, mindegyik kapcsolat database_permission értékével együtt. Ha egy sincs csatlakoztatva, üres listát ad vissza.

Olvasás Jogosultság: integration_database_get

Nincs argumentuma. Eredmény: {"connections": [{"connection_id", "provider", "name", "description", "database_permission"}]}.

list_database_tables

Listázza egy csatlakoztatott adatbázis tábláit és nézeteit, oszlopadatok nélkül.

Olvasás Jogosultság: integration_database_get

Eredmény: {"tables": ["schema.name", ...]}.

describe_database_tables

Oszlopadatokat ad vissza a megadott táblákhoz: név, adattípus, és hogy az oszlop lehet-e NULL.

Olvasás Jogosultság: integration_database_get

Eredmény: {"tables": [{"schema", "name", "columns": [{"name", "data_type", "nullable"}]}]}. Hibák: JSON-RPC-hiba, ha egy táblahivatkozásban nincs pont.

run_database_query

Egyetlen utasítást futtat egy csatlakoztatott adatbázison, a kapcsolat jogosultsági szintjén belül. A sorok számát és az időkorlátot a szerver a megengedett határok közé szorítja.

Írás Destruktív Jogosultság: integration_database_manage

Eredmény: {"columns": [...], "rows": [[...]], "row_count": n, "truncated": bool}. Az API-kulcs jogosultsága csak azt dönti el, hogy az eszköz meghívható-e; ha egy kulcs soha nem módosíthat adatot, az adatbázist Read only szinten csatlakoztasd.

Integrációk: tárhely

A Google Drive-val működik. Minden tárhelyeszköz provider argumentuma egyetlen értéket fogad el: google_drive. A tárhelykapcsolatok személyesek, a munkaterülettel nincsenek megosztva.

Több eszköz RemoteEntry objektumot ad vissza: {"id", "name", "kind", "mime_type", "size", "modified_at", "icon_url", "web_url", "parent_id", "shared", "owned_by_me", "can_add_children", "importable", "import_name"}.

list_storage_connections

Listázza a személyesen csatlakoztatott felhőtárhelyeidet. Ha egy sincs csatlakoztatva, üres listát ad vissza.

Olvasás Jogosultság: integration_storage_get

Nincs argumentuma. Eredmény: {"connections": [{"provider", "name", "description", "account_name"}]}.

browse_storage_folder

Listázza a közvetlenül egy mappában lévő mappákat és fájlokat. A gyökér böngészéséhez hagyd el a folder_id argumentumot.

Olvasás Jogosultság: integration_storage_get

Eredmény: {"entries": [RemoteEntry], "next_page_token", "breadcrumbs": [RemoteEntry]}. A morzsamenü (breadcrumbs) a gyökértől indul, ha a szolgáltató fel tudja oldani.

search_storage_files

Név vagy tartalom alapján keres egy csatlakoztatott tárhelyen, igény szerint egyetlen mappán belül.

Olvasás Jogosultság: integration_storage_get

Eredmény: {"entries": [...], "next_page_token", "breadcrumbs": null}.

get_storage_entry

Lekéri egyetlen fájl vagy mappa metaadatait egy böngészési vagy keresési eredményben kapott azonosító alapján.

Olvasás Jogosultság: integration_storage_get

Eredmény: egyetlen RemoteEntry.

import_storage_files

Letölti a fájlokat egy csatlakoztatott tárhelyről, és StickyPrompts-fájlként menti őket. A Google Docs, Sheets és Slides fájlokat PDF, XLSX és PPTX formátumra alakítja; a Google Forms-, Sites- és Apps Script-projektek nem importálhatók. Az elemek egymástól függetlenül sikerülnek vagy hiúsulnak meg. MCP-n keresztül csak így lehet új fájlt bevinni a StickyPromptsba.

Írás Jogosultság: integration_storage_manage

Eredmény: {"files": [{"id", "name", "file_type"}], "failed": [{"entry_id", "error"}], "_attachments": [...]}. A failed mezőt akkor is ellenőrizd, ha néhány fájl importálása sikerült. A fájlazonosítókat az edit_image, a generate_video és a start_spreadsheet_processing eszköz is elfogadja.

export_file_to_storage

Feltölti egy StickyPrompts-fájlodat egy csatlakoztatott tárhely egyik mappájába. A mappának már léteznie kell, és a csatlakoztatott fióknak írási joggal kell rendelkeznie hozzá.

Írás Jogosultság: integration_storage_manage

Eredmény: {"entry": RemoteEntry} a feltöltött fájlról.

Keresés

search

Név és szöveg alapján keres a saját promptjaid és beszélgetéseid között. Az alkalmazásbeli kereséssel ellentétben ez nem terjed ki a veled megosztott promptokra és a nyilvános promptkatalógusra.

Olvasás Jogosultság: search

Eredmény: {"prompts": [{"id", "name", "description"}], "conversations": [{"id", "name", "relevant_message": {"id", "text"}}]}, mindkettőből legfeljebb 5. Az egyező szöveget a szerver az első találat körül nagyjából 50 karakterre vágja, a találatot pedig <span class="search-highlight">...</span> közé teszi.

Csak a StickyPrompts munkatársainak

get_usage_statistics

Visszaadja a hívó kreditfelhasználását és futtatásainak számát egy dátumtartományban, kategóriánként. A statistics_get jogosultság kell hozzá, amelyet a StickyPrompts munkatársai számára tartanak fenn, és amelyet ügyfelek nem adhatnak hozzá kulcshoz, ezért ez az eszköz ügyfélkulcsoknál sosem jelenik meg. A munkaterület adminjai az alkalmazásban követhetik a felhasználást; erről a Felhasználás, kreditek és számlázás oldal szól.

Olvasás Jogosultság: statistics_get (csak munkatársaknak)

Eredmény: {"from_date", "to_date", "total_credits", "total_runs", "by_category": [{"category", "credits", "runs"}]}.