Server di mock tooling

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

La CLI di Agent 365 include un server di strumenti simulati per test e sviluppo. Questo server simula le interazioni con il server MCP (Model Context Protocol), così puoi testare localmente le capacità degli strumenti del tuo agente senza dover implementare vere e proprie implementazioni server. Non copre nessun'altra funzionalità dell'Agent 365.

Vantaggi dell'uso del server simulato

Il server simulato offre i seguenti vantaggi per lo sviluppo e il testing locale:

Sviluppo offline: Testa il tuo agente senza connettività internet o dipendenze esterne.
Test costanti: Ricevi risposte prevedibili per i casi limite.
Debug: visualizza tutte le richieste e le risposte in tempo reale
Iterazione veloce: Non c'è bisogno di aspettare chiamate API esterne o configurare ambienti di test complessi.

Prerequisiti

Prima di utilizzare il server mock tooling, assicurati di avere i seguenti prerequisiti:

CLI dell'Agente 365 installato - Usa il server di strumenti mock insieme alla CLI. Consulta Agent 365 CLI per le istruzioni di installazione.
- Dovresti avere almeno la versione 1.1.25-preview per usare il server di mock tooling.
Progetto di agente di esempio - Un progetto di agente locale che può connettersi ai server MCP. Consulta il nostro Agent365-Samples repository per i punti di partenza disponibili.

Avvia il server di strumenti simulati

Usa il comando a365 sviluppare start-mock-tooling-server per avviare il server mock tooling.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

Opzioni di comando

Il server mock supporta le seguenti opzioni:

Opzione	Description	Impostazione predefinita
`-p, --port <port>`	Numero di porta per il server fittizio	5309
`-v, --verbose`	Abilitare la registrazione dettagliata	false
`-?, -h, --help`	Visualizzare informazioni sulla Guida e sull'utilizzo	-
`-bg`	Eseguire il server in un nuovo terminale	-

Esempi

I seguenti esempi mostrano modi comuni per avviare il server di mock tooling:

Inizia con le impostazioni predefinite:

a365 develop start-mock-tooling-server

Inizia con una conversione personalizzata:

a365 develop start-mock-tooling-server -p 8080

Inizia con un registro dettagliato:

a365 develop start-mock-tooling-server -v

Quando esegui il comando, esso:

Avvia il server mock sulla porta specificata (predefinito: localhost:5309).
Visualizza i log del server e le richieste in arrivo nel terminale.

Usa un server mock con agenti di esempio

Per collegare il tuo agente campione al server di mock tooling:

Passo 1: Avvia il server simulato

a365 develop start-mock-tooling-server

Il server avvia e mostra l'output in modo simile al seguente esempio:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

Passo 2: Configura il tuo agente

Imposta la MCP_PLATFORM_ENDPOINT variabile di ambiente nel tuo sample agent per puntare al server mock:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Se usi una porta personalizzata, sostituisci 5309 con il numero di porta che hai scelto.

Passo 3: Gestisci il tuo agente

Inizia il tuo agente campione come fai normalmente. L'agente ora si connette al server simulato invece che ai veri server MCP.

Passo 4: Monitorare l'attività dei server

Il terminale server simulato mostra:

Richieste in arrivo dal tuo agente
Risposte prese in giro inviate
Stato della connessione ed errori (se presenti)

Esempi di log del server:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

Fermare il server simulato

Per fermare il server simulato, usa Ctrl+C nel terminale dove il server è in esecuzione, oppure chiudi la finestra del terminale.

Risoluzione dei problemi

Questa sezione contiene informazioni su come risolvere problemi comuni con il server di mock tooling.

Suggerimento

La Guida alla risoluzione dei problemi dell'Agente 365 contiene raccomandazioni di alto livello, best practice e link a contenuti di risoluzione dei problemi per ogni fase del ciclo di sviluppo dell'Agente 365.

Il server mock non si avvia

Sintomo:Error: Address already in use

Causa: Un altro processo è già usare la porta predefinita (5309) o la porta specificata da te.

Soluzione:

Usa una porta diversa.

a365 develop start-mock-tooling-server -p 8080

Oppure fermare il processo usando la porta e riprovare.

L'agente non può connettersi al server simulato

Sintomo: I log degli agenti mostrano errori di connessione o timeout quando si cerca di raggiungere il server simulato.

Causa:

Il server simulato non è in esecuzione.
Variabile ambientale errata MCP_PLATFORM_ENDPOINT .
Problemi di firewall o configurazione di rete.