Esecuzione dell'attività di debug

Quando le attività nella sessione condivisa non avanzano come previsto, questa guida consente di identificare la causa e di intervenire. La maggior parte dei problemi rientra in alcune categorie:

  • Attività bloccate
  • Convalida troppo rigida o troppo debole
  • Errori degli agenti o degli strumenti
  • Comportamento cognitivo che sembra inaspettato

Attività bloccate in Nuovo stato

Un'attività rimane nello stato Nuovo. Cause comuni:

Dipendenze non soddisfatte

L'attività dipende da un'altra attività che non si trova in uno stato finale.

Come controllare: Aprire l'attività ed esaminare il campo Dipende da. Controllare lo stato di ogni dipendenza.

Come correggere:

  • Se la dipendenza è bloccata, eseguire prima il debug dell'attività.
  • Se la dipendenza non è più rilevante, rimuoverla dal campo Depends on .If the dependency is no longer relevant, remove it from the Depends on field.
  • Se la dipendenza è completata ma l'attività è ancora nello stato Nuovo, il processo cognitivo non è ancora operativo sull'attività. Attendere 1-2 minuti.

Cognition non è in esecuzione

Il Discovery Engine potrebbe essere arrestato.

Come verificare: Verifica che il Discovery Engine sia in esecuzione nella tua sessione condivisa.

Come risolvere: Avvia il motore di rilevamento. Cognition avvia il ciclo di ragionamento e seleziona le attività pronte.

Annotazioni

Il motore di individuazione potrebbe arrestarsi durante gli aggiornamenti del servizio. Questo è previsto. I dati della sessione condivisa, i risultati delle attività e la cronologia di esecuzione vengono mantenuti. Avvia di nuovo il Motore di individuazione per riprendere.

Il motore di ricerca non si avvia

Il modello di chat richiesto per la convalida delle attività potrebbe non essere distribuito.

Procedura: Verificare che l'area di lavoro disponga di una distribuzione del modello di chat denominata gpt-5-4 (modello: gpt-5.4).

Procedura: distribuire il modello (vedere Creare la distribuzione del modello di chat), quindi avviare il motore di individuazione.

Cognition è occupato con altre attività

Se molte attività vengono eseguite o sono in convalida, l'elaborazione potrebbe attendere la disponibilità di risorse prima di avviarne di nuove.

Procedura: esaminare il numero di attività attualmente in Stato di esecuzione. Controllare se la conoscenza è in un ciclo di attesa esaminando l'attività di sessione condivisa.

Come risolvere: attendere il completamento di alcune attività. Il processo cognitivo assegna priorità alle attività in base alla priorità e all'idoneità delle dipendenze.

Attività bloccate in modalità esecuzione

Un'attività rimane in corso mentre un agente opera sull'attività stessa. Se persiste per un tempo insolitamente lungo, potrebbe verificarsi un problema.

Tempi di esecuzione normali

Prima di presumere che un'attività sia bloccata, considerare cosa accade:

  • Attività solo agente (nessuna chiamata allo strumento): in genere viene completata in meno di 1 minuto.
  • Attività con chiamate agli strumenti: la prima chiamata allo strumento in una sessione può richiedere 2-4 minuti a causa dell'avvio a freddo del supercomputer. Le chiamate successive sono più veloci (meno di 1 minuto).
  • Attività con calcoli elevati: alcuni strumenti eseguono simulazioni o analisi su larga scala che richiedono 5-15 minuti.

La risposta dell'agente è bloccata

Se un'attività è stata eseguita per più di 15 minuti senza attività dello strumento, la risposta del modello sottostante potrebbe essere bloccata.

Come verificare: Controllare la cronologia di esecuzione dell'attività per la sessione corrente. Se la risposta mostra "in corso" senza nuovo output per un periodo prolungato, è probabile che la risposta venga bloccata a livello di modello.

Come correggere:

  • Arrestare e riavviare il motore di individuazione. Ciò fa sì che la cognizione rivaluti tutte le attività e riprovi a eseguire quella bloccata.
  • Se il problema persiste, verificare se la distribuzione modello nell'area di lavoro è integra.

Esecuzione dello strumento non riuscita

L'agente ha chiamato uno strumento, ma lo strumento ha restituito un errore.

Procedura: esaminare la cronologia di esecuzione per ottenere i risultati delle chiamate dello strumento. I messaggi di errore degli strumenti in genere includono dettagli su ciò che è andato storto.

Errori e correzioni comuni degli strumenti:

Error Causa possibile Correzione
"L'esecuzione dello strumento è fallita senza registri" Non è stato possibile avviare il nodo del supercomputer (SKU della macchina virtuale con restrizioni, superata la quota) Controllare la configurazione del pool di nodi e la disponibilità dello SKU della macchina virtuale
Timeout della connessione all'API esterna Restrizioni di rete sulla subnet del supercomputer Verificare che gli endpoint necessari siano accessibili dal pool di nodi. Vedere Gestire pool di supercomputer e nodi
Errore di autenticazione (403) Mancata assegnazione di ruolo per l'identità dell'area di lavoro o del supercomputer Verificare che l'identità gestita abbia i ruoli necessari per gli account di archiviazione, i registri contenitori e altre risorse
Errore di pull dell'immagine del contenitore ACR non è accessibile dal supercomputer o l'immagine non esiste Controllare le regole di rete del Registro Azure Container e verificare che venga eseguito il push dell'immagine

Attività cicliche tra esecuzione e incompletezza

Quando un'attività passa ripetutamente dallo stato Esecuzione in corso allo stato Incompleto e viceversa, il processo cognitivo viene ritentato perché il risultato non soddisfa i requisiti di convalida.

I requisiti di convalida sono troppo rigidi

L'agente produce risultati ragionevoli, ma non corrispondono esattamente a quanto richiesto dai criteri di convalida.

Come controllare: leggere i commenti di convalida sull'attività. Ogni tentativo include commenti che spiegano quali requisiti sono stati superati e quali non sono riusciti.

Come correggere:

  • Modificare i requisiti di convalida in modo che siano raggiungibili con gli agenti e gli strumenti disponibili.
  • Requisiti di riformulazione per concentrarsi sulle questioni più importanti anziché richiedere dettagli completi.
  • Per indicazioni sulla calibrazione della convalida, vedere Relazione di trust e modelli di sessione condivisa di base .

L'agente non è in grado di eseguire l'attività

L'agente assegnato potrebbe non avere gli strumenti o le istruzioni appropriate per il tipo di lavoro richiesto dall'attività.

Come eseguire la verifica: controllare quale agente è stato assegnato dal processo cognitivo. Controllare se l'agente dispone degli strumenti necessari per l'attività. Confrontare il riepilogo delle funzionalità dell'agente con i requisiti dell'attività.

Come correggere:

  • Se un agente diverso sarebbe più appropriato, aggiungere un commento all'attività specificando l'agente da usare e il motivo (ad esempio, "Usare molToolkit per questa attività. Richiede rdkit per la convalida SMILES"). Cognition legge i commenti quando si selezionano agenti.
  • Se non esiste alcun agente appropriato, potrebbe essere necessario crearne o configurare uno. Vedere Concetti relativi all'agente di individuazione.

La descrizione dell'attività è ambigua

Se la descrizione dell'attività non fornisce un contesto sufficiente per l'agente, l'agente potrebbe produrre risultati tecnicamente validi, ma perdere il punto.

Procedura: leggere il risultato dell'agente e confrontarlo con quello effettivamente desiderato. Se il risultato punta alla descrizione letteralmente ma non soddisfa la finalità, la descrizione richiede più contesto.

Procedura: aggiornare la descrizione dell'attività con dettagli più specifici su ciò che si sta cercando, quindi impostare di nuovo lo stato su Nuovo.

Attività contrassegnate come richiede attenzione dell'utente

Quando la conoscenza contrassegna un'attività, significa che la conoscenza ha provato più approcci e non è stato in grado di produrre un risultato che supera la convalida.

Come diagnosticare:

  1. Controllare la cronologia di esecuzione: quante esecuzioni sono state tentate? Quali approcci sono stati provati?
  2. Leggere i commenti di convalida: quali requisiti specifici non sono riusciti in ogni tentativo?
  3. Esaminare il risultato più recente: è quello che serve?

Opzioni per la risoluzione:

  • Accettare il risultato: se il risultato più recente è sufficiente, aggiornare i requisiti di convalida e contrassegnare l'attività Completa.
  • Fornire indicazioni: aggiungere un commento che spiega cosa manca o quale approccio provare. Impostare di nuovo lo stato su Nuovo.
  • Suddividere l'attività: se l'attività è troppo complessa per un singolo agente, scomporla in attività figlio più piccole.
  • Selezione dell'agente guida: se l'agente corrente non dispone delle funzionalità appropriate, aggiungere un commento che specifica quale agente usare e perché, impostare di nuovo lo stato su Nuovo.
  • Rimuovi l'attività: se l'attività non è più rilevante, impostarne lo stato su Rimosso in modo che la cognizione passi oltre.

Problemi di comportamento cognitivo

Il riscaldamento di Cognition richiede molto tempo

Quando si avvia per la prima volta il motore di individuazione, la conoscenza passa attraverso un periodo di riscaldamento in cui compila il contesto esaminando tutte le attività e pianificandone l'approccio. Il riscaldamento richiede in genere 30-90 secondi e prevede diversi cicli di ragionamento interni prima dell'avvio della prima attività.

Questo comportamento è normale. Non arrestare e riavviare il Discovery Engine durante la fase di riscaldamento, perché ogni riavvio avvia un nuovo periodo di riscaldamento.

Cognition continua ad aspettare invece di lavorare

Se la conoscenza sembra trovarsi in un ciclo di attesa (verifica ripetutamente lo stato dell'attività senza avviare un nuovo lavoro), potrebbe bloccare altre attività in stati attivi.

Come controllare: cercare le attività in Esecuzione o in Convalida che sono presenti da molto tempo. Lo stato dell'attività potrebbe bloccare l'avanzamento della conoscenza.

Procedura: risolvere prima le attività bloccate. Una volta che i bloccanti vengono cancellati, la conoscenza riprende il normale funzionamento.

Cognition assegna l'agente errato

Cognition seleziona gli agenti in base alla valutazione delle funzionalità dell'agente e dei requisiti delle attività. In alcuni casi, potrebbe scegliere un agente che non dispone degli strumenti appropriati per il processo.

Procedura: esaminare l'agente assegnato dell'attività e confrontarne il riepilogo delle funzionalità con le esigenze dell'attività.

Come correggere:

  • Aggiungere un commento all'attività specificando l'agente da usare, ad esempio "Questa attività richiede paperAnalyzer. Ha bisogno di funzionalità di ricerca della letteratura"). Cognition legge i commenti al momento della selezione degli agenti nel tentativo successivo.
  • Se ciò si verifica ripetutamente, verificare che gli agenti abbiano riepiloghi chiari e descrittivi affinché il processo cognitivo possa effettuare selezioni migliori.

Cognition crea troppi sottoattività

La conoscenza potrebbe scomporre obiettivi generali in più sottoattività di quanto necessario.

Come correggere:

  • Rimuovere le sottoattività che non sono utili impostandone lo stato su Rimosso.
  • Inserire un commento all'attività madre per guidare il processo cognitivo su aree specifiche.
  • Usare il modello di esplorazione guidata anziché l'autonomia completa per assegnare limiti cognitivi.

Non è possibile visualizzare i file di output

Le attività vengono visualizzate come Completate e i risultati menzionano gli output dei file, ma si riscontrano errori di accesso quando si clicca sui collegamenti ai file.

Perché questo accade: gli agenti creano file usando l'identità gestita della piattaforma. Quando si visualizzano i file in VS Code, il browser usa l'identità dell'utente per accedere direttamente all'archiviazione BLOB. Si tratta di due percorsi di accesso separati.

Per visualizzare i file, è necessario disporre di tre elementi:

Controllo Quali requisiti sono necessari Chi lo corregge
Network L'indirizzo IP (o VPN) deve essere autorizzato dal firewall dell'account di archiviazione Administrator
CORS L'account di archiviazione deve consentire le richieste da vscode.dev e *.vscode-cdn.net Administrator
Autorizzazioni L'account ha bisogno del ruolo Lettore dei dati del BLOB di archiviazione nell'account di archiviazione Administrator

Se uno di questi elementi non è presente, verrà visualizzato un errore quando si fa clic sui collegamenti ai file, anche se i file sono stati creati correttamente.

Procedura: contattare l'amministratore con il nome dell'account di archiviazione (visibile nelle proprietà del contenitore di archiviazione) e chiedere loro di verificare tutti e tre gli elementi. Per i requisiti di configurazione completi, vedere Archiviazione BLOB di Azure in Microsoft Discovery.

Annotazioni

Le sessioni condivise continuano a funzionare correttamente indipendentemente dall'accesso ai file. Gli agenti possono leggere e scrivere file, la cognizione può convalidare il contenuto dei file, e i risultati delle attività acquisiscono l'output di testo. Il problema di accesso influisce solo sulla possibilità di visualizzare direttamente i file.

Controllo dell'integrità della sessione condivisa

Per una valutazione rapida dello stato della sessione condivisa:

  • Conteggio delle attività in base allo stato: quante sono le attività completate rispetto a quelle nuove, quelle in esecuzione e quelle richiedono attenzione da parte dell'utente?
  • Identificare i fattori di blocco: sono presenti attività in esecuzione o che richiedono attenzione da parte dell'utente che bloccano altre attività?
  • Verificare lo stato della cognizione: Discovery Engine è in esecuzione? La cognizione è in fase di ciclo attivo?
  • Esaminare le attività recenti: negli ultimi 30 minuti è cambiato qualcosa? In caso contrario, qualcosa potrebbe essere bloccato.

Se è necessario aiutare a interpretare lo stato della sessione condivisa, la cronologia di esecuzione delle singole attività fornisce le informazioni più dettagliate su cosa è successo e perché.

Contenuti correlati

  • Ultimo aggiornamento: