# Strumenti integrati

Le azioni che un agente può intraprendere, dalla lettura dei file all'esecuzione del codice e al lavoro tra le app.

Source: https://docs.opser.com/it/agents/tools/

## Gli strumenti trasformano una richiesta in un'azione

Uno strumento dà all'agente un'operazione che può effettivamente eseguire. Ha un nome, input strutturati e un risultato. Leggere un foglio di calcolo, eseguire uno script, creare un record e ispezionare un calendario collegato sono azioni dello strumento. La conversazione ti consente di seguire questo lavoro.

Si può chiedere in un linguaggio comune. Non è necessario ricordare i nomi degli strumenti. Sono elencati di seguito in modo da poter comprendere le fondamenta della piattaforma e riconoscerle nei dettagli dell'attività.

## File, codice e ricerca

| Strumento | Ciò che consente |
| --- | --- |
| `file` | Leggere e scrivere i file dell'area di lavoro, ispezionare le immagini e restituire un file nella conversazione |
| `shell` | Eseguire comandi e script nell'ambiente di lavoro dell'agente |
| `storage` | Memorizzare i file oltre una copia funzionante, recuperarli e creare collegamenti di condivisione supportati |
| `web` | Cercare e recuperare informazioni web pubbliche |
| `browser` | Ispezionare e interagire con le pagine web attraverso il servizio browser supportato |

Il filesystem rende possibile il lavoro in più fasi: uno strumento può creare un file letto da un altro strumento. Uno script può elaborare un file di origine e salvare un risultato per il lavoro successivo. Vedere [file persistenti](https://docs.opser.com/it/agents/files/) e [esecuzione di codice](https://docs.opser.com/it/capabilities/code/).

## Documenti e output generati

| Strumento | Ciò che consente |
| --- | --- |
| `pdf` | Leggere, compilare, unire e dividere i PDF e creare un PDF stampando un documento scritto in HTML |
| `spreadsheet` | Ispezionare fogli di calcolo e file CSV: elencare i fogli, descriverli e leggerne le righe |
| `presentation` | Ispezionare, visualizzare in anteprima ed esportare le presentazioni |
| `media` | Generare immagini, video e audio supportati |

L'agente crea cartelle di lavoro, presentazioni e report scrivendo brevi programmi nel suo ambiente isolato, che gli offrono formattazione, formule e grafici reali, poi usa questi strumenti per controllare, visualizzare in anteprima e convertire il risultato. Questi strumenti possono funzionare con gli stessi file dell'area di lavoro. Le operazioni disponibili e i fornitori determinano quali formati e opzioni di generazione possono essere utilizzati. Il lavoro di modello e alcune operazioni consumano crediti; "built in" non significa che ogni attività sia gratuita.

## Controllo del lavoro aziendale e della piattaforma

| Strumento | Ciò che consente |
| --- | --- |
| `data` | Gestisci set di dati aziendali di proprietà degli utenti, ispeziona la loro struttura ed esegui query di reporting supportate |
| `internal_app` | Creare, testare, rivedere e installare un'app dell'area di lavoro quando il costruttore è abilitato |
| `external_app` | Creare e pubblicare un sito Web o un'app web separata con funzionalità di dati esplicite |
| `platform` | Controllare o modificare le impostazioni di profilo, contesto, agente, accesso e area di lavoro supportate |
| `notify` | Invia una notifica supportata a una persona |

L'amministrazione della piattaforma utilizza i permessi del chiamante. Dare all'agente un'istruzione in lingua naturale non lo rende un amministratore. Le app forniscono i propri strumenti per i record che possiedono — ad esempio, l'app Dashboard consente all'agente di ispezionare e organizzare i widget della dashboard; utilizzare tali interfacce piuttosto che trattare ogni tabella di app come un set di dati generale.

## Memoria, guida e coordinamento

| Strumento | Ciò che consente |
| --- | --- |
| `memory` | Salvare, trovare e rimuovere fatti ricordati |
| `skills` | Scopri e carica le istruzioni riutilizzabili e gestisci le competenze personalizzate o installate supportate |
| `plan` | Tracciare i passaggi dell'attività nella conversazione |
| `ask_user_question` | Chiedi una decisione o dettagli mancanti |
| `subagent` | Delegare un compito limitato e riportare la sua relazione |
| `cron` | Creare, ispezionare, eseguire o rimuovere il lavoro programmato |
| `activity` | Scoprire cosa hanno fatto persone e agenti nell'area di lavoro |
| `connector` | Scopri e invoca le operazioni supportate sui servizi connessi e avvia un collegamento di account da completare |

Gli strumenti possono essere aggiunti al set disponibile di una conversazione quando necessario. Il passaggio di attivazione `toolbox` carica uno strumento differito o un toolkit dell'app; non esegue l'azione aziendale o concede nuovo accesso.

## Cosa è disponibile per il tuo agente

Opser fornisce la piattaforma di fondazione strumento. Il set effettivo dipende dalle restrizioni dell'agente, dalla configurazione dell'area di lavoro, dalle app installate, dagli account collegati e dal contesto dell'attività. Alcuni strumenti sono destinati a una conversazione o automazione. La creazione di app e i servizi supportati dal provider possono non essere disponibili in un ambiente anche se la piattaforma li supporta.

A [abilità](https://docs.opser.com/it/agents/skills/) Indica all'agente come utilizzare una capacità. Non installa software mancante o autorizza un account. Quando il lavoro è bloccato, chiedere all'agente di identificare lo strumento non disponibile, l'autorizzazione, la connessione o il servizio, quindi risolvere tale dipendenza.