Passa al contenuto principale

Collegare un assistente AI

L'assistente, o uno strumento HTTP che gli è messo a disposizione, legge le viste MCP con le normali chiamate REST.

OperazioneChiamata
TokenPOST <BASE_URL>/Token con grant_type=password, utente e password; poi Authorization: Bearer <token>
Elenco delle viste disponibiliGET <BASE_URL>/api/resources/MCPResources
Lettura di una vistaGET <BASE_URL>/api/resources/<vista>?PageSize=1000&PageNumber=1, con &RecordSelection=… facoltativo
Ricerca testualePOST <BASE_URL>/api/resources/<vista>/query?PageSize=100&PageNumber=1

Istruzioni per l'assistente​

Modello da adattare:

Hai accesso in sola lettura ai dati E-CUBE tramite le viste elencate in MCPResources:
MCPArticoli, MCPClienti, MCPFornitori, MCPDocumentiT, MCPDocumentiR.
- Filtra sempre con RecordSelection (tipo documento, anno, famiglia, cliente) prima di leggere le righe.
- Leggi tutte le pagine fino a TotalRowsCount prima di calcolare totali o classifiche.
- Gli importi della testata sono in val_tot_imp (imponibile), val_tot_iva e val_tot_doc.
- Non mostrare mai token o credenziali.

Le credenziali non vanno mai nel prompt: lo strumento HTTP le legge dalla propria configurazione.

Controlli​

  1. Leggi MCPResources e controlla che le viste attese siano registrate.
  2. Fai all'assistente una domanda di cui conosci la risposta e confrontala con una lettura diretta della vista.
  3. Controlla nei log che l'assistente usi filtri e paginazione invece di scaricare intere tabelle.