Zum Inhalt springen

Werkzeuge · Pakete

MCP-Tools für das Modul Pakete (Coworking): Briefe und Pakete mit Foto erfassen, die Warteschlange, Abholung, Rücksendung, Entsorgung, Wiedereröffnung, Löschen und das „Habe ich ein Paket?“ des Mitglieds.

Das Modul Pakete über den Assistenten: das Paket mit Foto erfassen und das Mitglied benachrichtigen, die Warteschlange verfolgen, Fotos ändern, die Abholung markieren, zurücksenden, entsorgen, wieder öffnen und löschen, und das Mitglied fragen lassen, ob etwas auf es wartet. Es sind 16 Tools.

Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.

Kurz gesagt

ToolWas es tutMindestrolleTyp
get_parcels_overviewDer Bereich auf einen Blick: die Konfiguration und wie viele wartenAlle, die den Bereich sehenNur lesen
get_parcelEin Paket, mit den FotosAlle (deines); Team (jedes)Nur lesen
do_i_have_parcelsDeine Pakete, offen und Verlauf, mit Ort und CodeAlleNur lesen
mark_parcel_picked_upMarkiert die AbholungAlle (deine); Moderator oder Finanzen (andere)Ändert
search_parcel_recipientsFindet den Empfänger über den NamenModerator oder FinanzenNur lesen
register_parcelErfasst das Paket und benachrichtigt den Empfänger per E-MailModerator oder FinanzenÄndert
list_pending_parcelsDie Warteschlange der Pakete, die auf Abholung wartenModerator oder FinanzenNur lesen
list_parcelsDer Verlauf, mit jedem ZustandModerator oder FinanzenNur lesen
update_parcelKorrigiert die Daten und den Abholcode des FachsModerator oder Finanzen (wartend); Administrator (abgeschlossen)Ändert
add_parcel_photoFügt ein Foto hinzuModerator oder FinanzenÄndert
replace_parcel_photoErsetzt ein FotoModerator oder FinanzenÄndert
return_parcelSendet an den Absender zurückModerator oder FinanzenÄndert
remove_parcel_photoEntfernt ein Foto endgültigModerator oder FinanzenMit Bestätigung
discard_parcelEntsorgt ein nicht abgeholtes PaketAdministratorÄndert
reopen_parcelMacht einen Abschluss rückgängigAdministratorÄndert
delete_parcelLöscht einen versehentlich angelegten EintragAdministratorMit Bestätigung

Der Bereich wird mit create_space und module: "parcels" angelegt, mit dem Argument parcels für die Konfiguration; update_space ändert nur, was du schickst, und behält den Rest.

Das Team ist hier Eigentümer, Administrator, Moderator und Finanzen. Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die verbundene Person in der Oberfläche tun würde. Eigentümer und Administrator sehen die 16 Tools; Moderator und Finanzen 13 (ohne Entsorgen, Wiedereröffnen und Löschen); das Mitglied 4 (get_parcels_overview, get_parcel, do_i_have_parcels und mark_parcel_picked_up, bei den eigenen Paketen).

Der Abholcode des Fachs ist ein Geheimnis. Keine Antwort für das Team enthält ihn, und im Audit-Protokoll des MCP ist er verborgen; nur do_i_have_parcels und get_parcel zeigen ihn, dem Empfänger selbst. Wer erfasst oder korrigiert, kann den Code festlegen, aber nie lesen, und der Assistent wiederholt ihn nicht.

Die Konfiguration des Bereichs

Das Argument parcels von create_space und update_space akzeptiert:

FeldTypBeschreibung
locker_modenone oder freenone: alles liegt am Empfang; free: das Team notiert, wo es jedes Paket abgelegt hat
locker_pickup_codewahr oder falschDas Team kann einen Abholcode pro Paket festlegen; nur der Empfänger sieht ihn
email_includes_photowahr oder falschDie Benachrichtigungs-E-Mail enthält eine Vorschau des Fotos (Voreinstellung: ja)
require_staff_confirmationwahr oder falschWahr: Nur das Team markiert die Abholung. Falsch (Voreinstellung): auch das Mitglied
reminder_after_days, reminder_max_countZahlen oder nullFrist bis „überfällig“ und Höchstzahl der Erinnerungen. Werden schon akzeptiert, aber die Erinnerung läuft noch nicht

get_parcels_overview

Nur lesen

Der Bereich auf einen Blick. Die Konfiguration (Fach-Modus und ob das Mitglied die eigene Abholung bestätigt), wie viele Pakete auf dich warten (mine.pendingCount) und, für das Team, wie viele offen und überfällig sind. Mindestrolle: alle, die den Bereich sehen.

ParameterTypPflichtBeschreibung
spaceID oder LinkJaDer Pakete-Bereich

Frag so: „Wie viele Pakete liegen im Standort Mitte zu lange?“

get_parcel

Nur lesen

Ein Paket. Mit den Fotos, in signierten Links, die 1 Stunde gelten. Das Team liest jedes Paket der Community, ohne den Code; der Empfänger liest seines, mit Ort und Code, solange es wartet. Jede andere Person erhält „nicht gefunden“. Mindestrolle: alle.

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)

Frag so: „Zeig mir das Paket von Maria.“

do_i_have_parcels

Nur lesen

„Habe ich ein Paket?“ Nur deine: die offenen (alle) und der Verlauf (die letzten), mit dem Abholort, dem Code des Fachs, solange es wartet, und den Fotos (Links für 1 Stunde). Zeige den Code nur der Person selbst. Mindestrolle: alle.

ParameterTypPflichtBeschreibung
spaceID oder LinkNeinEin bestimmter Bereich; ohne ihn alle
history_limitZahlNeinWie viele aus dem Verlauf (1 bis 100)

Frag so: „Wartet ein Paket auf mich?“

mark_parcel_picked_up

Ändert

Die Abholung markieren. Das Team markiert als STAFF (Voreinstellung, mit dem Namen der gekommenen Person in picked_up_by_name, der standardmäßig der Empfänger ist) oder THIRD_PARTY (der Name ist Pflicht). Der Empfänger selbst markiert als SELF, nur wenn der Bereich die Bestätigung durch das Team nicht verlangt (sonst abgewiesen). Der Abholcode des Fachs wird gelöscht. Es ist idempotent: Bei einem bereits abgeschlossenen Paket liefert es already_closed: true. Mindestrolle: alle (deine); Moderator oder Finanzen (andere).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
methodSTAFF, SELF oder THIRD_PARTYNeinWie es abgeholt wurde
picked_up_by_nameTextNeinWer gekommen ist (Pflicht bei THIRD_PARTY)

Frag so: „Markiere das Paket von Maria als abgeholt.“ · „Ich habe mein Paket schon abgeholt.“

search_parcel_recipients

Nur lesen

Wer empfängt. Die Mitglieder des Bereichs, deren Name mit q beginnt (mindestens 3 Buchstaben, bis zu 8 Ergebnisse), nur mit ID, Namen und Initialen. Die id ist das recipient_profile_id von register_parcel. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
spaceID oder LinkJaDer Pakete-Bereich
qTextJaDer Namensanfang

Frag so: „Such Maria Souza, um ein Paket zu erfassen.“

register_parcel

Ändert

Das Paket erfassen. Für ein Mitglied mit Zugriff auf den Bereich. Sendet dem Empfänger die Benachrichtigungs-E-Mail (mit der Vorschau, wenn der Bereich so eingestellt ist), in der Zeitzone der Community: Der Assistent sagt das. kind ist LETTER, PACKAGE oder OTHER (dieses verlangt kind_label). locker_label und locker_pickup_code (4 bis 12 Zeichen, ein Geheimnis) gelten nur, wenn der Bereich es erlaubt. Mit client_request_id liefert ein wiederholter Aufruf dasselbe Paket, ohne zweite E-Mail. Derselbe Empfänger, dieselbe Art und Sendungsnummer innerhalb von 24 Stunden wird abgewiesen (409), außer force ist wahr. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
spaceID oder LinkJaDer Pakete-Bereich
recipient_profile_idIDJaAus search_parcel_recipients
kindLETTER, PACKAGE oder OTHERJaDie Art
kind_labelTextMit OTHERBis zu 60 Zeichen
sender_name, carrier, tracking_codeTextNeinAbsender, Transportunternehmen und Sendungsnummer
notesTextNeinBis zu 200 Zeichen
locker_label, locker_pickup_codeTextNeinWo es liegt und der Code
photosListeNeinBis zu 5, jedes mit image_url oder image_base64
client_request_id, forceText, wahr/falschNeinIdempotenz und Erfassung trotz Duplikat

Frag so: „Ein Amazon-Paket für Maria Souza ist angekommen, in Fach 12. Foto: [Link].“

list_pending_parcels

Nur lesen

Die Warteschlange. Die Pakete, die auf Abholung warten, vom neuesten zum ältesten, mit Empfänger, Art, Absender, Ort, wie lange sie warten und stalled_days, wenn sie die Frist überschritten haben. Filter: kind, q (Empfänger, Absender, Transportunternehmen oder Sendungsnummer), stalled, recipient_profile_id, from und to (JJJJ-MM-TT, in der Zeitzone der Community). Nie der Code (nur has_locker_code). Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
spaceID oder LinkJaDer Pakete-Bereich
kind, q, stalled, recipient_profile_id, from, toverschiedeneNeinDie Filter
page, limitZahlenNeinPaginierung (bis 100)

Frag so: „Was liegt seit mehr als 3 Tagen am Empfang?“

list_parcels

Nur lesen

Der Verlauf. Wie list_pending_parcels, aber mit jedem Zustand (RECEIVED, PICKED_UP, RETURNED, DISCARDED), filterbar über status. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
spaceID oder LinkJaDer Pakete-Bereich
statusZustandNeinFiltert nach dem Zustand
die Filter von list_pending_parcelsverschiedeneNein

Frag so: „Welche Pakete wurden diesen Monat zurückgesendet?“

update_parcel

Ändert

Korrigieren. Art, Absender, Transportunternehmen, Sendungsnummer, Hinweis, Ort und Abholcode des Fachs (der neu festgelegt, nie gelesen wird) eines wartenden Pakets. Ein abgeschlossenes Paket korrigieren nur Eigentümer oder Administrator, und nie den Code. Jede Korrektur kommt ins Protokoll. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
kind, kind_label, sender_name, carrier, tracking_code, notes, locker_label, locker_pickup_codeverschiedeneNeinNur, was sich ändert

Frag so: „Korrigiere die Sendungsnummer des Pakets von Maria auf BR123456789.“

add_parcel_photo

Ändert

Ein Foto hinzufügen. Bis zu 5 pro Paket, in privatem Speicher. Das Team; bei einem abgeschlossenen Paket nur Eigentümer und Administrator. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
image_url oder image_base64 (+ image_type)TextJaDas Foto: ein öffentlicher Link oder die Datei in Base64. Es liegt in privatem Speicher

Frag so: „Hänge dieses Foto an das Paket von Maria.“

replace_parcel_photo

Ändert

Ein Foto ersetzen. Ersetzt ein Foto durch die neue Datei; die alte wird gelöscht. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
photo_idIDJaDas Foto (aus get_parcel)
image_url oder image_base64 (+ image_type)TextJaDas Foto: ein öffentlicher Link oder die Datei in Base64. Es liegt in privatem Speicher

Frag so: „Ersetze das erste Foto des Pakets durch dieses.“

return_parcel

Ändert

An den Absender zurücksenden. Verlangt den Grund. Nichts wird gelöscht: Das Paket bleibt als RETURNED im Verlauf, und der Abholcode des Fachs wird gelöscht. Ein bereits abgeschlossenes Paket antwortet 409. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
reasonTextJaDer Grund, bis zu 200 Zeichen; er kommt ins Protokoll

Frag so: „Sende das Paket von Maria an den Absender zurück: abgelehnt.“

remove_parcel_photo

Mit Bestätigung

Ein Foto entfernen. Die Datei wird endgültig gelöscht. Beim ersten Aufruf liefert es die Zusammenfassung und den Bestätigungscode. Mindestrolle: Moderator (oder Finanzen).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
photo_idIDJaDas Foto (aus get_parcel)

Frag so: „Entferne das zweite Foto des Pakets; es zeigt die Adresse.“

discard_parcel

Ändert

Entsorgen. Für ein Paket, das niemand abgeholt hat. Verlangt den Grund. Nichts wird gelöscht: Es bleibt als DISCARDED im Verlauf, und reopen_parcel macht es rückgängig. Verlangt keine Bestätigung, weil es umkehrbar ist. Mindestrolle: Administrator (Eigentümer oder Administrator).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
reasonTextJaDer Grund, bis zu 200 Zeichen; er kommt ins Protokoll

Frag so: „Entsorge das Paket von Maria: abgelaufen, nicht abgeholt.“

reopen_parcel

Ändert

Wieder öffnen. Macht eine versehentliche Abholung, Rücksendung oder Entsorgung rückgängig: Es geht zurück auf RECEIVED, mit dem Grund. Der gelöschte Code kommt nicht zurück; lege mit update_parcel einen neuen fest. Mindestrolle: Administrator (Eigentümer oder Administrator).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
reasonTextJaDer Grund, bis zu 200 Zeichen; er kommt ins Protokoll

Frag so: „Öffne das Paket von Maria wieder: Die Abholung wurde versehentlich markiert.“

delete_parcel

Mit Bestätigung

Einen versehentlich angelegten Eintrag löschen. Er verschwindet aus den Listen, und die Fotos werden gelöscht; das Protokoll hält fest, wer und warum. Um ein Paket wirklich abzuschließen, nutze mark_parcel_picked_up, return_parcel oder discard_parcel. Beim ersten Aufruf liefert es die Zusammenfassung und den Bestätigungscode. Mindestrolle: Administrator (Eigentümer oder Administrator).

ParameterTypPflichtBeschreibung
parcel_idIDJaDas Paket (aus list_pending_parcels)
reasonTextJaDer Grund, bis zu 200 Zeichen; er kommt ins Protokoll

Frag so: „Lösche den Eintrag des Pakets von João: Ich habe ihn für die falsche Person erfasst.“

Verwandte Artikel