Limiti di utilizzo di Copilot Studio ed errori di agente non disponibile

Sommario

Questo articolo illustra come risolvere gli errori di limitazione, limite di utilizzo e agente non disponibile in Microsoft Copilot Studio. Questi errori si verificano quando l'utilizzo dell'agente supera i limiti di capacità o i limiti di frequenza dell'IA generativa, oppure quando un ambiente non dispone di crediti Copilot per eseguire flussi dell'agente o flussi di lavoro. Usare i passaggi di risoluzione per la causa che corrisponde all'errore.

Sintomi

È possibile ricevere uno o più dei seguenti messaggi di errore o comportamenti durante l'interazione con un agente:

EnforcementMessage: "Questo agente non è attualmente disponibile. Ha raggiunto il limite di utilizzo. Riprovare più tardi".
GenAISearchandSummarizeRateLimitReached: "È stato raggiunto il limite di utilizzo per la ricerca e il riepilogo. Riprovare più tardi".
GenAIToolPlannerRateLimitReached: "È stato raggiunto il limite di utilizzo per l'orchestrazione generativa. Riprovare più tardi".
OpenAIRateLimitReached: "È stato raggiunto il limite di utilizzo openAI. Riprovare più tardi".
FlowActionForbidden: In un agente compilato con l'harness standard, la conversazione mostra questo codice di errore. Nella chat di test i dettagli dell'errore possono includere "L'ambiente '<EnvironmentId>' non dispone di crediti Copilot sufficienti per l'esecuzione dei flussi di lavoro".
InsufficientMcsCredits: Quando si avvia direttamente un flusso dell'agente, l'esecuzione non riesce con questo codice di errore e il messaggio "L'ambiente '<EnvironmentId>' non dispone di Copilot crediti sufficienti per l'esecuzione dei flussi di lavoro". Quando si testa un flusso di lavoro, i dettagli dell'errore includono InsufficientMcsCredits.
Errore di chiamata dello strumento: In un agente creato con GitHub Copilot harness, la chiamata allo strumento ha esito negativo e viene visualizzato il messaggio "L'ambiente ha esaurito i Copilot Credits".

Quando un flusso dell'agente o un flusso di lavoro viene bloccato, l'agente risponde comunque alle domande che non richiedono il flusso.

Determinare la causa del problema

Trova la corrispondenza del messaggio di errore con la causa appropriata:

Per EnforcementMessage, GenAISearchandSummarizeRateLimitReached, GenAIToolPlannerRateLimitReachedo OpenAIRateLimitReached, vedere Causa: l'utilizzo dell'agente supera la capacità dell'ambiente o i limiti di velocità generativi dell'intelligenza artificiale.
Per FlowActionForbidden, InsufficientMcsCredits o il messaggio "L'ambiente ha esaurito i crediti Copilot", vedere Causa: L'ambiente non dispone di crediti Copilot per eseguire flussi agente o flussi di lavoro.

Annotazioni

FlowActionForbidden viene restituito anche quando viene negata una chiamata di flusso per altri motivi, ad esempio le autorizzazioni. Controllare i dettagli dell'errore per il messaggio relativo ai crediti Copilot prima di continuare.

Causa: l'utilizzo dell'agente supera la capacità dell'ambiente o i limiti di frequenza dell'IA generativa

Copilot Studio applica vincoli di frequenza e utilizzo predefiniti per proteggersi da picchi di utilizzo imprevisti che potrebbero influire sulle funzionalità dell'applicazione. L'utilizzo dell'agente viene misurato in crediti Copilot. Il numero di crediti utilizzati da un agente dipende dalla progettazione e dalle funzionalità dell'agente. Quando il consumo supera la capacità disponibile in un ambiente, l'ambiente è in eccedenza. Una volta attivato il controllo dell'eccedenza, viene visualizzato il messaggio "Questo agente attualmente non è disponibile. Ha raggiunto il limite di utilizzo. Riprova più tardi." Per altre informazioni sui crediti e sull'imposizione dell'eccedenza, vedere Applicazione dell'eccedenza.

Per i messaggi generati con l'uso dell'intelligenza artificiale generativa e per l'orchestrazione degli argomenti, le quote limitano il numero di richieste che è possibile inviare al minuto e all'ora. Una volta raggiunto il limite, i messaggi dell'agente successivi vengono bloccati, causando uno dei sintomi elencati. Queste quote e limiti si applicano per l'ambiente dataverse. Per altre informazioni, vedere Quote e limiti per Copilot Studio.

Soluzione: esaminare le quote e il consumo di crediti di Copilot

Esaminare i contingenti e i limiti di Copilot Studio applicabili all'ambiente e confrontarli con l'utilizzo recente. Per visualizzare il consumo nell'interfaccia di amministrazione di Power Platform, vedere Visualizzare il consumo di credito Copilot.

Se l'utilizzo raggiunge questi limiti, un amministratore può esaminare le opzioni di capacità disponibili per la tua organizzazione. Per informazioni dettagliate sulle licenze e sulla capacità, vedere Licenze di Copilot Studio e Gestire crediti Copilot e capacità per Copilot Studio.

Se l'ambiente è in eccedenza, i passaggi descritti in Soluzione: Rendere disponibili Crediti Copilot per l'ambiente si applicano anche all'errore "Questo agente non è attualmente disponibile".

Soluzione: richiedere un aumento del limite di frequenza per Copilot Studio

Contattare il supporto tecnico Microsoft e richiedere un aumento del limite di frequenza. Questa opzione non garantisce che venga concessa un'eccezione o un aumento. Ogni richiesta è soggetta a revisione e approvazione e l'idoneità dipende dalla configurazione delle licenze dell'ambiente. Per informazioni dettagliate sulle licenze, vedere Copilot Studio licensing.

Soluzione: Pianificare l'implementazione degli agenti per la velocità effettiva e i limiti di frequenza

La pianificazione proattiva della capacità effettiva prima del test di accettazione utente (UAT), dei test di carico o della messa in produzione può aiutarti a evitare errori di limitazione della velocità. Esaminare i limiti di frequenza che si applicano a Copilot Studio, Power Automate, Dataverse, connettori e qualsiasi API downstream usata dall'agente. Stimare le finestre di traffico di picco anziché basarsi sulle medie mensili e prendere in considerazione le ottimizzazioni di progettazione per ridurre la pressione della velocità effettiva prima di richiedere un aumento del limite.

Per altre informazioni, vedi Pianificare le distribuzioni degli agenti di Copilot Studio in base alla velocità effettiva e ai limiti di frequenza.

Causa: l'ambiente non dispone di Copilot Credits per l'esecuzione di flussi dell'agente o flussi di lavoro

L'ambiente non disponeva di crediti Copilot disponibili all'avvio dell'esecuzione. In questa situazione non viene bloccata ogni esecuzione del flusso dell'agente (vedere la tabella seguente). I nuovi flussi di agenti e le esecuzioni del flusso di lavoro non possono essere eseguiti finché non sono disponibili crediti per l'ambiente. Le esecuzioni già avviate vengono completate normalmente. Per ulteriori informazioni, vedere Implementazione del flusso dell'agente. Per informazioni dettagliate sulle licenze, vedere Copilot Studio licensing.

Controllare se l'esecuzione del flusso dell'agente è bloccata

Come è stata avviata l'esecuzione del flusso dell'agente	Bloccato quando l'ambiente non dispone di crediti
Un agente chiama un flusso agente che usa il trigger Quando un agente chiama il flusso, mentre un utente autenticato con Microsoft Entra ID interagisce con l'agente	Dipende dalle licenze applicabili all'utente. Vedi applicazione forzata del flusso agente.
Uguale, ma l'utente non viene autenticato con Microsoft Entra ID, ad esempio un visitatore anonimo di un sito Web, un chiamante telefonico o un utente che accede tramite un provider di identità diverso	Yes
Un agente chiama un flusso dell'agente mentre viene eseguito in modo autonomo, ad esempio dopo l'avvio di un trigger di evento oppure un flusso di Power Automate avvia l'agente	Yes
Un agente chiama un flusso agente dalla chat di test	No
Si testa un flusso dell'agente nella finestra di progettazione del flusso	No
Un flusso agente inizia dal proprio trigger, ad esempio una pianificazione o un nuovo messaggio di posta elettronica	Yes

Questa tabella illustra i flussi degli agenti. Per i flussi di lavoro creati nell'esperienza dei flussi di lavoro, vedere Gestire l'utilizzo della capacità del flusso di lavoro.

Come illustrato nella tabella, un flusso che funziona nella chat di test può comunque essere bloccato in Teams, in un sito Web o quando l'agente opera autonomamente. Un flusso che funziona in un ambiente può comunque essere bloccato in un altro ambiente in cui non sono disponibili crediti.

Soluzione: rendere disponibili i Crediti Copilot per l'ambiente

Nell'interfaccia di amministrazione di Power Platform passare a Licenze>Copilot Studio>Ambienti, selezionare l'ambiente ed esaminare la riga Azioni flusso agente nella griglia dei dettagli del consumo di credito Copilot.
Rendere disponibili crediti all'ambiente in uno dei modi seguenti:
- Alloca i crediti Copilot all'ambiente. Passare a Licenze>Copilot Studio e quindi selezionare Gestisci crediti Copilot.
- In Eccedenze di capacità, seleziona Usa la capacità disponibile nel mio tenant. Per l'altra opzione in questo pannello, vedere Gestione del superamento.
Se non sono disponibili crediti da allocare, vedere licenze di Copilot Studio per le opzioni disponibili per l'organizzazione.
Attendere fino a 15 minuti per l'aggiornamento della disponibilità del credito e quindi riprovare dal canale in cui l'esecuzione non è riuscita.
Se le esecuzioni vengono bloccate mentre gli utenti interagiscono con l'agente, assicurarsi che l'agente sia configurato per autenticare gli utenti con Microsoft Entra ID e che il flusso usi il trigger When an agent calls the flow. Per le condizioni applicabili a tali esecuzioni, vedere Agent flow enforcement.