> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/intelligence/ai-chat.md). # AI Chat Configuri AI Chat con riconoscimento del contesto, controlli l'accesso ad agenti e strumenti e consulti la cronologia delle chat memorizzata in PowerShell Universal. AI Chat è un assistente con riconoscimento del contesto nella console di amministrazione di PowerShell Universal. Consente a un utente autorizzato di selezionare un agente AI, chiedergli di ispezionare o aggiornare la risorsa corrente, esaminare la sua attività sugli strumenti e ricevere una risposta in streaming. La chat è disponibile nelle pagine della console che forniscono un contesto di risorsa modificabile, come script, app, API, pianificazioni e componenti del portale. ## Come funziona Il pannello della chat trasmette il tipo di risorsa corrente, l'identificatore della risorsa, l'ambito del repository e il file principale all'agente AI selezionato. L'agente riceve istruzioni per rimanere entro tale ambito e può utilizzare gli strumenti configurati per ispezionare, aggiornare e ricaricare la risorsa. Una sessione di chat ha un ID di conversazione. Clear chat avvia una nuova conversazione nella console. Il pannello dell'attività della sessione mostra le chiamate agli strumenti e le modifiche ai file effettuate durante la sessione corrente. ## Configurare AI Chat 1. Crei un agente AI in **Build > AI > Agents**. Ne configuri il provider, il modello, l'endpoint, le credenziali, le istruzioni ed eventuali [AI Tools](/powershell-universal/it/intelligence/ai-tools.md) che può richiamare. 2. Abiliti **Available in Chat** per l'agente AI. 3. Assegni ruoli all'agente AI quando solo determinati utenti devono poterlo selezionare. Un agente senza ruoli assegnati è disponibile per tutti gli utenti che dispongono dell'autorizzazione per la chat. 4. Conceda agli utenti l'autorizzazione **Chat** `Read` o `Write`. Gli utenti devono inoltre soddisfare i requisiti di ruolo dell'agente selezionato ed eventuali requisiti di ruolo della risorsa che stanno modificando. Se nessun agente AI idoneo è abilitato per la chat, il pannello della chat rimane non disponibile per l'utente. ## Chi può utilizzare la chat Un utente può utilizzare AI Chat solo quando sono soddisfatte tutte le condizioni seguenti: * L'utente dispone dell'autorizzazione **Chat** `Read` o `Write`. * Almeno un agente AI ha **Available in Chat** abilitato. * L'utente dispone di un ruolo consentito da tale agente AI, quando l'agente ha restrizioni di ruolo. * L'utente è autorizzato ad accedere alla risorsa corrente. Le autorizzazioni della chat controllano l'uso del pannello. I ruoli degli agenti AI controllano quali agenti abilitati un utente può selezionare. ## Strumenti disponibili per AI Chat L'agente AI selezionato può richiamare gli AI Tools personalizzati configurati su tale agente. Questi strumenti vengono eseguiti con le impostazioni configurate di script, timeout e destinazione di esecuzione. AI Chat fornisce inoltre strumenti integrati con riconoscimento del contesto per gli utenti che dispongono del ruolo **Administrator**, **Operator** o **App Editor** e dell'autorizzazione Chat `Read` o `Write`. Gli strumenti disponibili dipendono dalla risorsa corrente e dal livello di autorizzazione. | Funzionalità | Accesso in lettura | Accesso in scrittura | | ------------------------------------------------------------------------- | ------------------------------------ | ------------------------------------ | | Individuare le risorse e leggere i file del repository | Sì | Sì | | Elencare risorse, notifiche, file, contenuto dei file e guida dei comandi | Sì | Sì | | Ricaricare la risorsa corrente | No | Sì | | Creare, aggiornare, spostare o eliminare i file del repository | No | Sì | | Ispezionare un endpoint GET configurato per un'app | Solo contesto app | Solo contesto app | | Cercare le proprietà dei controlli del portale | Solo contesto componente del portale | Solo contesto componente del portale | Le operazioni sui file integrate sono limitate all'ambito del repository della risorsa corrente. Non possono uscire da tale ambito. ## Cronologia e conservazione delle chat PowerShell Universal memorizza la cronologia delle chat nel proprio database. Ogni record include la conversazione e l'agente selezionato, l'utente, il contesto della risorsa, i messaggi, l'utilizzo dei token e, per ogni chiamata agli strumenti, il nome, gli argomenti, il risultato, l'errore, lo stato e i timestamp. Gli utenti con l'autorizzazione **Chat History** `Read` possono esaminare le conversazioni persistenti da **Build > AI > Chat History**. La cronologia viene conservata in base all'impostazione generale `GroomDays` e viene eliminata quando supera tale periodo di conservazione. Tenga conto di questa politica di conservazione quando i prompt o gli argomenti degli strumenti possono contenere informazioni sensibili. ## Pagine correlate * [Agenti IA](/powershell-universal/it/intelligence/ai-agents.md) * [AI Tools](/powershell-universal/it/intelligence/ai-tools.md) * [Built In MCP Tools](/powershell-universal/it/intelligence/built-in-mcp-tools.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/it/intelligence/ai-chat.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.