Vai al contenuto

Strumenti · Community e struttura

Strumenti MCP per la struttura della community: il contesto del collegamento, le sezioni e gli spazi, aprire un link copiato dall'app, creare, modificare, riordinare ed eliminare sezioni e spazi, chi vede ciascuno, spostare uno spazio di sezione, le impostazioni della community (lingua compresa) e l'e-mail degli avvisi di vendita.

Il punto di partenza di ogni conversazione e la forma della community: in quale community e con quale ruolo si trova l'assistente, quali sezioni e spazi esistono, e creare, riordinare, sistemare o eliminare questa struttura, compreso chi vede ogni spazio. È qui che l'assistente capisce anche un link che incolli nella conversazione, e che vede e cambia le impostazioni della community (nome, colori, logo, SEO, lingua e regole di accesso) e l'e-mail che riceve gli avvisi di vendita.

Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.

In sintesi

StrumentoCosa faRuolo minimoTipo
get_community_contextCommunity, ruolo, sezioni e spazi con gli id: il punto di partenzaQualsiasiSolo lettura
get_connection_diagnosticsSe l'elenco di strumenti dell'assistente è aggiornatoAmministratoreSolo lettura
list_spacesSezioni e spazi, con filtro per moduloQualsiasiSolo lettura
open_linkDice cos'è un link copiato dall'app (o un id)QualsiasiSolo lettura
create_sectionCrea una sezione del menuAdminModifica
create_spaceCrea uno spazio in una sezione, con iconaAdminModifica
update_spaceCambia nome, descrizione, icona o visibilità di uno spazio, o lo sposta in un'altra sezioneAdminModifica
update_sectionCambia nome, descrizione, icona di una sezione, o la rende quella inizialeAdminModifica
reorder_sectionsMette le sezioni del menu in un nuovo ordineAdminModifica
reorder_spacesMette gli spazi di una sezione in un nuovo ordineAdminModifica
update_space_accessChi vede uno spazio o una sezione, e chi pubblica nello spazioAdminModifica
delete_sectionElimina una sezione e i suoi spaziAdminChiede conferma
delete_spaceElimina uno spazioAdminChiede conferma
get_community_settingsLe impostazioni della community: nome, colori, immagini, SEO, lingua, accessoAdminSolo lettura
update_community_settingsCambia nome, colori, logo, favicon, SEO, lingua e regole di accessoAdminModifica
get_notification_settingsL'e-mail che riceve gli avvisi di venditaAdminSolo lettura
update_notification_settingsCambia o disattiva l'e-mail degli avvisi di venditaAdminModifica

get_community_context

Solo lettura

Contesto della community. Il punto di partenza: dice a quale community è legato il collegamento, con quale ruolo, ed elenca le sezioni e gli spazi con gli id. Ruolo minimo: qualsiasi.

Parametri: nessuno.

Restituisce: la community (id, nome, indirizzo), te (ruolo e nome), gli scope del collegamento (read, write), le sezioni (id, titolo, se è quella iniziale, visibilità) con gli spazi di ciascuna (id, titolo, modulo, visibilità), l'ordine in cui le cose vanno create, e le icone disponibili per gli spazi (available_icons, con l'uso di ciascuna).

Chiedi così: "A quale community sei collegato, e con quale ruolo?" · "Quali spazi ha la community?"

Note: gli assistenti di solito chiamano questo strumento da soli all'inizio di ogni conversazione. L'ordine di creazione che restituisce è lo stesso di Ordine di creazione.

list_spaces

Solo lettura

Elencare sezioni e spaces. Le sezioni e gli spazi, con id, modulo e visibilità, con filtro per modulo. Ruolo minimo: qualsiasi; ognuno vede ciò che può vedere.

ParametroTipoObbligatorioDescrizione
moduletestoNofeed, content, courses, events, storefront, gallery… Restituisce solo le sezioni che hanno spazi di quel modulo

Restituisce: le sezioni con gli spazi, come in get_community_context.

Chiedi così: "Qual è lo spazio dei corsi?" · "Elenca gli spazi di eventi."

Solo lettura

Aprire un link dell'app. Riceve un link della tua community (oppure un id o uno slug) e dice cos'è, con id, titolo, spazio e un riepilogo. Ruolo minimo: qualsiasi.

ParametroTipoObbligatorioDescrizione
linktestoSìL'indirizzo dell'app, un percorso come /aprender/cursos/excel, un id o uno slug

Riconosce gli indirizzi dell'app: spazio (/sezione/spazio), post, evento, corso, certificato (dall'interno dello spazio o dalla pagina pubblica di verifica), call for papers e proposta (?proposal=), piano (/pricing/…) e abbonamento (/billing?subscription=…), compresi i vecchi indirizzi che l'app reindirizza.

Chiedi così: "Cos'è questo link? https://latuacommunity.com.br/aprender/cursos/excel-do-zero"

Note: funziona solo con i link della community collegata. Un link di un'altra community restituisce "Questo link è di un'altra community", anche se le amministri entrambe: collega l'altra separatamente.

create_section

Modifica

Creare una sezione. Crea una sezione del menu, come Imparare o Community. Gli spazi stanno dentro le sezioni. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
titletesto, fino a 255SìIl nome nel menu
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
visibilitypublic, members, plan, privateNoChi vede la sezione. Vedi Visibilità e accesso

Restituisce: la sezione creata, con l'id che chiede create_space.

Chiedi così: "Crea una sezione chiamata Imparare, visibile solo ai membri."

create_space

Modifica

Creare uno space. Crea uno spazio in una sezione, con il modulo che definisce cos'è. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
section_ididSìDa get_community_context o create_section
titletesto, fino a 255Sì
modulefeed, content, courses, events, storefront, gallery, ranking, url, certificates, call4papersSìFeed, Contenuto, Corsi, Eventi, Negozio, Galleria, Classifica, Link, Certificati o Call for papers. Vedi Moduli
external_urlindirizzo webNoSolo nel modulo url: l'indirizzo che lo spazio apre
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
visibilitypublic, members, plan, privateNo
iconuna delle icone dell'elencoNoL'icona dello spazio. Vedi Icone. Senza, Memberfy ne sceglie una in base al titolo e al modulo

Restituisce: lo spazio creato, con l'id e l'icona.

Chiedi così: "Crea uno spazio Feed chiamato Avvisi nella sezione Community, con l'icona del megafono."

Note: per un corso o un evento completo, create_course e create_event creano anche lo spazio. In uno spazio Call for papers, il passo successivo suggerito è aprire la prima call (create_call_for_papers). Gli spazi non hanno un'immagine di copertina.

update_space

Modifica

Modifica space. Cambia il nome, la descrizione, l'icona o la visibilità di uno spazio esistente, oppure lo sposta in un'altra sezione. Cambia solo ciò che viene inviato. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
space_ididSìDa list_spaces
titletesto, fino a 255No
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
iconuna delle icone dell'elencoNoL'icona dello spazio. Vedi Icone. Senza, Memberfy ne sceglie una in base al titolo e al modulo
visibilitypublic, members, plan, privateNoPer lo spazio privato con gruppi, prodotti o piani, usa update_space_access
section_ididNoSposta lo spazio in questa sezione

Restituisce: lo spazio aggiornato.

Chiedi così: "Cambia l'icona dello spazio Offerte di lavoro con una valigetta." · "Dai un'icona diversa a ogni spazio della sezione Imparare, in base al tema."

update_section

Modifica

Modifica sezione. Rinomina una sezione del menu, ne cambia la descrizione o l'icona, oppure la rende la sezione iniziale. Cambia solo ciò che viene inviato. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
sectionid, indirizzo o nomeSìDa get_community_context
titletesto, fino a 255No
descriptiontesto sempliceNoSenza formattazione: i segni di Markdown vengono tolti
icontestoNo
is_homesì o noNoLa sezione che si apre per prima

Chiedi così: "Rinomina la sezione Imparare in Corsi e rendila la sezione iniziale."

Note: chi vede la sezione si cambia con update_space_access.

reorder_sections

Modifica

Riordina sezioni. Mette le sezioni del menu in un nuovo ordine, dall'alto verso il basso. Quelle non indicate mantengono il loro ordine, dopo queste. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
section_idselenco di idSìDa get_community_context, nel nuovo ordine

Chiedi così: "Metti la sezione Eventi subito dopo Community."

reorder_spaces

Modifica

Riordina spazi. Mette gli spazi di una sezione in un nuovo ordine. Quelli non indicati mantengono il loro ordine, dopo questi. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
sectionid, indirizzo o nomeSìLa sezione
space_idselenco di idSìDa list_spaces, nel nuovo ordine

Chiedi così: "Nella sezione Imparare, metti per primo lo spazio Excel da Zero."

Note: per portare uno spazio in un'altra sezione, usa update_space con section_id.

update_space_access

Modifica

Cambia chi vede lo spazio. Stabilisce chi vede uno spazio o un'intera sezione e, in uno spazio, chi può pubblicare. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
space o sectionid, link, indirizzo o nomeUno dei dueLo spazio o la sezione
visibilitypublic, members, plan, privateNoPubblico, membri, qualsiasi abbonamento attivo, o privato
group_idselenco di idNoNel privato: i gruppi che entrano (da list_groups)
product_idselenco di idNoNel privato: i prodotti il cui acquisto dà accesso (da list_products)
plan_idselenco di idNoNel privato: i piani il cui abbonamento dà accesso (da list_plans)
can_createanyone, staff, adminsNoSolo spazio: Chiunque, Team o Admin possono pubblicare

Restituisce: lo spazio o la sezione aggiornati.

Chiedi così: "Rendi lo spazio Excel da Zero visibile solo a chi ha comprato il prodotto del corso o è abbonato al piano Studente."

Note: i gruppi, prodotti e piani inviati sostituiscono quelli che c'erano; ne basta uno perché la persona entri. Uno spazio non è mai più aperto della sua sezione. Cambia subito chi vede cosa: chiedi all'assistente di mostrarti prima cosa cambierà, se vuoi controllare. Vedi Visibilità e accesso.

delete_section

Chiede conferma

Elimina sezione. Elimina una sezione del menu e gli spazi che contiene. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
sectionid, indirizzo o nomeSì

Restituisce: alla prima chiamata, la sezione e l'elenco degli spazi che vengono eliminati con lei, più il codice di conferma.

delete_space

Chiede conferma

Elimina spazio. Elimina uno spazio, e ciò che contiene, dal menu. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
spaceid, link, indirizzo o nomeSì

Restituisce: alla prima chiamata, lo spazio, il modulo e la sezione, più il codice di conferma.

get_community_settings

Solo lettura

Vedere le impostazioni della community. Le impostazioni della community così come sono. Ruolo minimo: admin.

Parametri: nessuno.

Restituisce: il nome, la descrizione, i colori (primario e secondario in hex, e la scala completa), il logo, la favicon, l'immagine di condivisione, il SEO, le regole di accesso (registrazione aperta, modello di registrazione, visitatori), la moderazione e la classifica. Nessun segreto, come integrazioni o DNS.

Chiedi così: "Quali sono oggi i colori e il SEO della community?"

update_community_settings

Modifica

Modificare le impostazioni della community. Cambia le impostazioni; cambia solo ciò che viene inviato. Ruolo minimo: admin.

ParametroTipoObbligatorioDescrizione
name, descriptiontestoNoIl nome e la descrizione della community
primary_color, secondary_colorcolore in hex (#RRGGBB)NoL'intera scala, da 50 a 950, viene generata a partire da questi. Vedi Colori
reset_colorssì o noNoTorna ai colori predefiniti del prodotto
mobile_bar_colorcolore in hexNoIl colore della barra del browser sul telefono
seo_title, seo_descriptiontestoNoVedi Immagini e SEO
signup_opensì o noNoChiunque può registrarsi
signup_modelFREE, PAIDNo
guest_accesssì o noNoI visitatori vedono ciò che è pubblico
content_moderationsì o noNo
global_rankingsì o noNo
languagept-BR, pt-PT, en-US, es-ES, es-MX, es-AR, it-IT, de-DE, de-AT, de-CHNoLa lingua della community: quella delle e-mail e di chi non ha ancora scelto una lingua. Vedi Lingue
linkedin_idnumeroNoL'ID della pagina LinkedIn della community, per i certificati
logo_url o logo_base64link o fileNoIl logo
favicon_url o favicon_base64link o fileNoLa favicon
share_image_url o share_image_base64link o fileNoL'immagine che compare quando qualcuno condivide il link

Restituisce: le impostazioni applicate, con il prima → dopo di ogni campo.

Chiedi così: "Cambia il colore primario in #4F46E5 e usa questo logo: https://…"

Note: tutto questo è visibile all'intera community appena la chiamata viene eseguita; per annullare, chiedi di nuovo con il valore precedente, che trovi nel prima → dopo. Dominio e integrazioni non si cambiano da qui. Vedi Impostazioni generali.

get_notification_settings

Solo lettura

Vedi avvisi di vendita. Dove vanno gli avvisi della community: l'e-mail che riceve un avviso a ogni vendita. Ruolo minimo: Admin.

Parametri: nessuno.

Chiedi così: "Chi riceve l'avviso quando c'è una vendita?"

update_notification_settings

Modifica

Cambia e-mail degli avvisi di vendita. Stabilisce l'e-mail che riceve un avviso a ogni vendita. Ruolo minimo: Admin.

ParametroTipoObbligatorioDescrizione
sales_notification_emaile-mailSìVuoto ("") disattiva gli avvisi

Chiedi così: "Manda gli avvisi di vendita a amministrazione@memberfy.net."

Vedi Avvisi di vendita.

Icone

Gli spazi usano le stesse icone del selettore del pannello. L'assistente riceve l'elenco con l'uso di ciascuna (in get_community_context, campo available_icons, e nella descrizione degli strumenti) ed è istruito a scegliere in base al tema, senza ripetere sempre la stessa. Se non sceglie, Memberfy ne sceglie una in base al titolo (Agenda delle dirette ottiene calendar, Offerte di lavoro ottiene briefcase) o, senza indizi nel titolo, in base al modulo (Corsi ottiene book-open, Galleria ottiene image).

Alcuni esempi: calendar (eventi, agenda), book-open (corsi, lezioni), graduation-cap (formazione, mentoring), megaphone (avvisi, annunci), message-square (forum, domande), briefcase (carriera, offerte di lavoro), image (galleria, foto), trophy (classifica, sfide), shopping-bag (negozio), crown (premium, VIP), lock (privato).

get_connection_diagnostics

Solo lettura

Diagnostica della connessione. Dice se l'elenco di strumenti che l'assistente sta usando è aggiornato. Ruolo minimo: amministratore (proprietario o amministratore).

ParametroTipoObbligatorioDescrizione
connection_ididNoSenza, la connessione di questa conversazione

Restituisce: l'assistente, chi ha autorizzato e quando, la versione del server e l'elenco che la connessione riceverebbe adesso (il codice dell'elenco e quanti strumenti), cosa ha ricevuto l'ultima volta, l'ultima chiamata e l'ultimo tentativo di usare uno strumento che non ha, e listUpToDate. Con listUpToDate falso, l'assistente usa l'elenco vecchio: apri una nuova conversazione o ricollega il connettore.

Chiedi così: "Una tua chiamata è fallita. Il tuo elenco di strumenti di Memberfy è aggiornato?"

Correlati