Nicholas: Connettore MCP: collegamento e strumenti

2026-11-07T00:37:43Z

Connettore MCP: collegamento e strumenti

Nuova pagina

{{Riepilogo|L'elenco degli strumenti che il [[Connettore MCP]] mette a disposizione dell'intelligenza artificiale, divisi per area, con i flussi tipici (allegati e OCR, interrogazione dei dati, previsioni, anonimizzazione). Gli strumenti effettivamente visibili dipendono dai prodotti attivi e dai permessi dell'utente.}}
{{Si applica a|[[Connettore MCP]]}}

== Come funzionano ==
L'utente scrive la richiesta in linguaggio naturale; l'AI sceglie lo strumento e lo usa per suo conto. Gli strumenti che leggono funzionano subito; quelli che '''modificano dati''' mostrano un'anteprima e chiedono conferma.

== Gli strumenti per area ==
{| class="wikitable"
! Area !! Strumenti (nome tecnico) !! A cosa servono
|-
| '''Logistica''' ([[Assistant Evolution]]) || <code>logistica_create_transport_services</code> e gli altri strumenti di Evolution || Inserire servizi di trasporto in blocco (anche da allegati letti con OCR), consultare servizi e viaggi.
|-
| '''Ticket CRM''' || <code>crm_list_tickets</code>, <code>crm_get_ticket</code>, <code>crm_get_ticket_brief</code>, <code>crm_create_ticket</code>, <code>crm_update_ticket</code>, <code>crm_patch_ticket</code>, <code>crm_add_ticket_comment</code>, <code>crm_add_ticket_worklog</code>, <code>crm_update_ticket_worklog</code>, <code>crm_move_ticket_phase</code>, <code>crm_resolve_ticket</code>, <code>crm_close_ticket</code>, <code>crm_send_ticket_email</code>, <code>crm_read_ticket_attachment</code>, <code>crm_list_ticket_statuses</code>, <code>crm_list_ticket_phases</code>, <code>crm_list_ticket_assignees</code> || Cercare, aprire e lavorare i [[Assistant CRM/Ticket|ticket]]: commenti, ore, fasi, chiusura, email al cliente.
|-
| '''Richieste di assistenza''' || <code>crm_list_assistance_requests</code>, <code>crm_get_assistance_request</code>, <code>crm_convert_assistance_request</code>, <code>crm_list_portal_tokens</code>, <code>crm_revoke_portal_token</code> || Gestire le richieste in attesa e convertirle in ticket.
|-
| '''Email''' || <code>crm_list_mailboxes</code>, <code>crm_list_inbox_threads</code>, <code>crm_read_email_thread</code>, <code>crm_search_emails</code>, <code>crm_read_email_attachment</code>, <code>crm_send_email</code>, <code>send_email</code>, <code>open_email_app</code> || Leggere e cercare la posta collegata al CRM, preparare e inviare email.
|-
| '''Offerte''' || <code>crm_list_offers</code>, <code>crm_get_offer</code>, <code>crm_create_offer</code>, <code>crm_upsert_offer</code> || Preparare e aggiornare le [[Assistant CRM/Opportunità e offerte|offerte]].
|-
| '''Marketing''' || <code>crm_list_marketing_lists</code>, <code>crm_create_marketing_list</code>, <code>crm_add_marketing_list_members</code>, <code>crm_add_marketing_list_members_by_filter</code>, <code>crm_search_campaign_recipients</code>, <code>crm_create_campaign</code>, <code>crm_update_campaign</code>, <code>crm_list_campaigns</code>, <code>crm_get_campaign_stats</code>, <code>crm_get_campaign_follow_up</code>, <code>crm_mark_campaign_contact_hot</code>, <code>crm_create_opportunity_from_campaign</code>, <code>crm_upload_campaign_asset</code>, <code>crm_set_marketing_consent</code>, <code>crm_update_marketing_profile</code>, <code>crm_erase_marketing_data</code> e altri || Creare liste e [[Assistant CRM/Marketing|campagne]], seguirne i risultati, gestire consenso e profilo.
|-
| '''Anagrafiche e informazioni commerciali''' || <code>crm_enrich_company</code>, <code>enrich_companies_excel</code>, <code>creditsafe_companysearch</code>, <code>creditsafe_companycreditreport</code> || Arricchire le anagrafiche, cercare aziende e ottenere report di affidabilità (Creditsafe).
|-
| '''Integrazione TMS esterno''' || <code>crm_list_levia_customers</code>, <code>crm_list_levia_shipments</code>, <code>crm_get_levia_shipment</code>, <code>crm_list_levia_trips</code>, <code>crm_get_levia_trip</code> e altri || Consultare dati del TMS Levia, dove l'integrazione è attiva.
|-
| '''Telefonia''' || <code>make_calls</code>, <code>open_call_app</code>, <code>get_call_transcripts</code> || Avviare chiamate e leggere le trascrizioni.
|-
| '''Dati e query''' || <code>search_db_schema</code>, <code>describe_db_schema</code>, <code>validate_db_query</code>, <code>execute_db_query</code>, <code>export_db_query</code> || Interrogare i dati in '''sola lettura''' ed esportarli.
|-
| '''Previsioni''' || <code>list_forecast_metrics</code>, <code>forecast_metric</code>, <code>forecast_db_query</code>, <code>forecast_file</code> || Proiettare volumi, fatturato e andamenti su serie storiche (dal database o da un file CSV/Excel).
|-
| '''Allegati e OCR''' || <code>upload_mcp_attachment</code>, <code>ingest_attachments</code>, <code>get_attachment_workflows</code> || Caricare un file e leggerlo (testo e tabelle, OCR per le scansioni).
|-
| '''Privacy''' || <code>anonymize_document</code>, <code>anonymize_text</code>, <code>deanonymize_text</code> || Sostituire i dati personali con segnaposto prima dell'elaborazione e ripristinarli alla fine.
|-
| '''Documentazione''' || <code>documentazione_wiki_search</code> || Cercare in questa wiki per rispondere alle domande sull'uso dei prodotti.
|-
| '''Documenti''' ([[Assistant DocAI]]) || strumenti <code>docai_*</code> || Lavorare con DocAI per conto dell'utente.
|-
| '''Programmi registrati''' || <code>get_agent_tool_schema</code>, <code>invoke_agent_tool</code> || Usare i programmi di terzi registrati nel connettore (tramite OpenAPI o WSDL).
|}

== I flussi tipici ==
=== Da un allegato a un'operazione ===
# <code>upload_mcp_attachment</code> carica il file (con [[AdA]] il file è già disponibile).
# <code>ingest_attachments</code> ne estrae testo e tabelle (OCR per le scansioni). Non scrive nulla nei gestionali.
# L'AI prepara i dati per la destinazione e usa lo strumento di scrittura (es. <code>logistica_create_transport_services</code>), mostrando l'anteprima e chiedendo conferma.

=== Interrogare i dati ===
<code>search_db_schema</code> (quale tabella?) → <code>describe_db_schema</code> (quali colonne?) → <code>validate_db_query</code> → <code>execute_db_query</code> o <code>export_db_query</code>. Le query sono solo in lettura e vengono validate prima dell'esecuzione.

=== Fare una previsione ===
<code>list_forecast_metrics</code> per vedere le metriche già pronte, poi <code>forecast_metric</code>; se nessuna metrica va bene, <code>forecast_db_query</code> con una query; per i dati di un file, <code>forecast_file</code>. Il risultato indica anche l'affidabilità della previsione. Le festività italiane sono considerate.

=== Proteggere i dati personali ===
<code>anonymize_document</code> o <code>anonymize_text</code> sostituiscono nomi, codici fiscali, IBAN, indirizzi, telefoni e altri dati personali con segnaposto (es. <code>[PERSONA_1]</code>), elaborando il documento '''solo in locale'''. L'AI lavora sul testo anonimizzato; alla fine <code>deanonymize_text</code> ripristina i dati originali in un file. Date e importi restano in chiaro.

[[Categoria:Intelligenza artificiale]]
[[Categoria:Guide]]

Connettore MCP/Strumenti - Cronologia

Nicholas: Connettore MCP: collegamento e strumenti