Esempi di casi di utilizzo
 |
Model Context Protocol (beta) è attualmente disponibile in modalità di anteprima e fornisce solo la convalida funzionale di base. Nelle release future verranno introdotte funzionalità espande e l'idoneità completa.
|
Prerequisiti
1. Creare una chiave di accesso in ThingWorx Composer. Impostare una data di scadenza appropriata.
2. Configurare il client MCP con l'IDE di VS Code e Claude Desktop.
Configurare il server MCP ThingWorx nell'IDE di VS Code.
1. Aprire l'IDE di VS Code.
2. Premere CTRL+MAIUSC+P per aprire la tavolozza dei comandi.
3. Selezionare il comando MCP Add Server.
4. Selezionare HTTP (HTTP o Server-Sent Events).
5. Immettere ThingWorx Server URL>/mcp e premere INVIO.
6. Immettere il nome del server, ad esempio ThingWorxMCPServer, e premere INVIO.
7. Selezionare Global o Workspace in base alle esigenze aziendali, quindi premere INVIO.
Il file mcp.json viene creato nell'IDE di VS Code con url e type come chiavi.
8. Aggiungere il codice seguente dopo “type”: "headers": {<APPLICATION_KEY>"}
Il file mcp.json ha un aspetto simile al seguente:
{
"servers": {
"ThingworxMCP": {
"url": "https://centr154-eastus-iot-01-twx.ptcdevops.com/Thingworx/mcp",
"type": "http",
"headers": {
"AppKey": "a57da3b7-a7f7-4b05-b48a-ac6ccdc21939"
}
}
},
"inputs": []
9. Il client MCP viene avviato nell'IDE di VS Code.
Se ThingWorx è configurato per l'autenticazione Single Sign-On (SSO), utilizzare il formato URL seguente: <ThingWorx Server URL>rp>mcp.
Scenario di esempio
Uno stabilimento di produzione dispone di più macchine da monitorare con gli indicatori KPI critici seguenti:
• Stato
• Temperature
• Umidità
• Consumo di energia
• Autonomia giornaliera
• Periodo di inattività giornaliero
Creare le seguenti entità:
• Plant1.Machine.TT (ThingTemplate)
Proprietà:
◦ Status (STRING | Persist | Logged)
◦ Temperature (NUMBER | Persist | Logged)
◦ Humidity (NUMBER | Persist | Logged)
◦ EnergyConsumption (NUMBER | Persist | Logged)
• Oggetto Plant1.WeldingMachine1.Thing
• Oggetto Plant1.WeldingMachine2.Thing
• Oggetto Plant1.WeldingMachine3.Thing
• Oggetto Plant1.WeldingMachine4.Thing
• Plant1.WeldingMachine.VS (Value Stream)
Assicurarsi che tutti gli oggetti eseguano lo stream di dati live a intervalli regolari.
Caso di utilizzo 1
Scopo
Il responsabile di uno stabilimento o il supervisore delle macchine ha bisogno di un'istantanea operativa immediata di una macchina nell'impianto produttivo. L'obiettivo è comprendere rapidamente le prestazioni correnti e identificare condizioni anomale attraverso metriche operative chiave.
Prompt dell'utente
Get the latest machine status with critical KPIs.
Risultato
Un riepilogo dello stato della macchina con i valori KPI più recenti, ad esempio consumo di energia, temperatura e autonomia totale.
Passi
1. Creare un oggetto helper denominato MCP.HelperThing in ThingWorx.
2. Creare un servizio GetCurrentMachineStatusKPI con:
◦ Input: machineName (STRING)
◦ Output: result (STRING)
3. Aprire la risorsa MCPServices e passare alla scheda Services.
4. Cercare il servizio AddTools e fare clic su Execute.
5. Nell'input toolInfo fare clic su +Add.
6. Immettere quanto segue:
◦ Service Provider Name: MCP.HelperThing
◦ Service Provider Type: Thing
◦ Service Name: GetCurrentMachineStatusKPI
◦ Description: il servizio restituisce lo stato più recente con gli indicatori KPI. Accetta machineName come input e restituisce i dati KPI.
◦ Application Name: ThingWorx
7. Fare clic su Set.
8. Fare clic su Save.
9. Fare clic su Execute:
◦ Lo strumento è stato aggiunto correttamente.
◦ Eseguire GetAllTools per confermare l'aggiunta dello strumento.
10. Nell'IDE di VS Code assicurarsi che il client MCP sia in esecuzione. Sullo schermo dovrebbe essere visibile il numero di strumenti e prompt.
11. Aprire la finestra di chat sul lato destro.
12. Immettere il prompt: Get the latest machine status with critical KPIs.
L'output deve contenere i dati KPI richiesti.
Caso di utilizzo 2
Scopo
Il responsabile di uno stabilimento o il supervisore delle macchine ha bisogno di un'istantanea operativa immediata di una macchina, ma potrebbe non sapere come formulare un prompt efficace. Questo caso di utilizzo consente agli utenti di accedere rapidamente alle informazioni sulla macchina senza richiedere competenze di prompt engineering.
Risultato
Il sistema fornisce prompt di esempio pronti per l'uso che gli utenti possono utilizzare, personalizzare e perfezionare in base alle proprie esigenze. Ciò consente un accesso rapido e uniforme a informazioni critiche sulla macchina.
Passi
1. Aprire la risorsa MCPServices e passare alla scheda Services.
2. Cercare il servizio AddPrompts e fare clic su Execute.
3. Nell'input promptInfo fare clic su +Add.
4. Immettere i dettagli seguenti:
◦ Name: Get Current Status of Machine
◦ Descrizione: prompt per ottenere lo stato corrente di una macchina. Accetta machineName come input.
◦ Content:
{
"text": "Get current status of {machineName}",
"type": "text"
◦ Prompt Arguments: aggiungere l'argomento machineName.
5. Fare clic su Add.
6. Fare clic su Save.
7. Fare clic su Execute.
◦ Il prompt viene aggiunto correttamente.
◦ Eseguire GetAllPrompts per confermare l'aggiunta del prompt.
8. Nell'IDE di VS Code assicurarsi che il client MCP sia in esecuzione. Sullo schermo dovrebbe essere visibile il numero di strumenti e prompt.
9. Aprire la finestra di chat sul lato destro.
10. Immettere / nella finestra di chat e seleziona il prompt aggiunto nei passi precedenti.
11. Immettere i valori di input e premere INVIO. L'output deve indicare lo stato della macchina richiesto.
Caso di utilizzo 3
Scopo
Il responsabile di un stabilimento o l'operatore di una macchina ha accesso ai dati aziendali e operativi pertinenti, ma non sa come interrogare l'insieme di dati, estrarre le informazioni necessarie o ricavare dettagli significativi.
Risultato
I dati disponibili vengono inseriti ed esposti come risorsa affinché il modello linguistico di grandi dimensioni (LLM) li utilizzi come riferimento contestuale. L'LLM analizza e interpreta questi dati e genera un output in linea con il prompt dell'utente, fornendo una chiara visione operativa senza richiedere all'utente di comprendere la struttura dei dati sottostante o il linguaggio di interrogazione.
Passi
1. Aprire la risorsa MCPServices e passare alla scheda Services.
2. Cercare il servizio AddResources e fare clic su Execute.
3. Nell'input resourceInfo fare clic su +Add.
4. Immettere i dettagli seguenti:
◦ Name: QueryMachineData
◦ URI: file:///C:/Thingworx/ThingworxRepository/DataRepository/all-available-machine-data.json
 | Il file JSON referenziato nel percorso URI contiene i dati della macchina esportati dallo stream di valori. |
◦ Description: risorsa per ottenere i dati della macchina. Accetta il nome della macchina come input e restituisce una infotable.
◦ Service Provider Name: MCP.HelperThing
◦ Service Provider Type: Thing
5. Fare clic su Add.
6. Fare clic su Save.
7. Fare clic su Execute.
◦ La risorsa è stata aggiunta correttamente.
◦ Eseguire GetAllResources per confermare l'aggiunta del prompt.
8. Nell'IDE di VS Code assicurarsi che il client MCP sia in esecuzione. Sullo schermo dovrebbe essere visibile il numero di strumenti e prompt.
9. Premere CTRL+MAIUSC+P per aprire la tavolozza dei comandi.
10. Selezionare il comando MCP: Browse Resources.
11. Selezionare QueryMachineData dall'elenco. all-available-machine-data.json viene aggiunto come risorsa per l'LLM nella finestra di chat.
12. Immettere un prompt per i dati allegati.