# Failproof AI: Italian > Trace agent behavior, find failures with audits, and prevent repeat failures with deployed policies. ## Italian ### Start #### Start here - [Rendi il tuo agent failproof](https://docs.befailproof.ai/it/index.md): Osservabilità e enforcement per ogni harness su cui i tuoi agent vengono eseguiti — coding CLI, chat gateway, assistant auto-hosted e tuoi agent strumentati. - [Guida introduttiva](https://docs.befailproof.ai/it/start/quickstart.md): Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo. - [Harness per agenti](https://docs.befailproof.ai/it/reference/harnesses.md): Cattura sessioni e applica criteri su tutti i 12 harness di agenti supportati. - [Failproof Assistant](https://docs.befailproof.ai/it/sessions/assistant.md): Analizza e gestisci Failproof AI in linguaggio naturale, da domande e query a dashboard e audit. - [Esegui il tuo primo controllo di guasto](https://docs.befailproof.ai/it/start/first-audit.md): Crea un audit dal dashboard Cloud o dalla CLI di fp e rivedi i suoi primi risultati. - [Evita il tuo primo errore con una policy](https://docs.befailproof.ai/it/start/first-policy.md): Scrivi una versione di policy, distribuiscila in modalità observe e poi applicala. - [Scegli la tua configurazione](https://docs.befailproof.ai/it/start/setup.md): Scegli l'applicazione locale, Failproof AI Cloud, o un deployment aziendale. - [Concetti fondamentali](https://docs.befailproof.ai/it/start/concepts.md): L'insieme minimo di concetti utilizzati in Failproof AI. ##### Starter templates - [Agenti personalizzati](https://docs.befailproof.ai/it/start/quickstarts/custom-agents.md): Racchiudi il tuo agente in tre blocchi `with` e inizia a registrare. - [LangChain e LangGraph](https://docs.befailproof.ai/it/start/quickstarts/langchain.md): Installa, strumenta e visualizza la tua prima traccia. - [CrewAI](https://docs.befailproof.ai/it/start/quickstarts/crewai.md): Installa, strumenta e visualizza la tua prima traccia. - [LlamaIndex](https://docs.befailproof.ai/it/start/quickstarts/llamaindex.md): Installa, strumenta e visualizza la tua prima traccia. - [Pydantic AI](https://docs.befailproof.ai/it/start/quickstarts/pydantic-ai.md): Installa, strumenta e visualizza la tua prima traccia. ### Trace Agents #### Understand every run - [Sessioni](https://docs.befailproof.ai/it/sessions/overview.md): Inizia con il registro completo di un'esecuzione dell'agente. - [Eventi live](https://docs.befailproof.ai/it/sessions/live-events.md): Guarda l'attività dell'agente arrivare mentre una sessione è in esecuzione. - [Leggere una traccia](https://docs.befailproof.ai/it/sessions/read-a-trace.md): Trova l'evento che ha cambiato il corso di una sessione agente. - [Modelli](https://docs.befailproof.ai/it/sessions/models.md): Confronta latenza, token, utilizzo del contesto e distribuzione del traffico dei modelli. - [Hooks](https://docs.befailproof.ai/it/sessions/hooks.md): Misura l'attività degli hook, i trigger e la latenza separatamente dai risultati delle policy. - [Decisioni delle policy](https://docs.befailproof.ai/it/sessions/policy-decisions.md): Vedi quali policy hanno valutato, bloccato, istruito o consentito. - [Strumenti](https://docs.befailproof.ai/it/sessions/tools.md): Trova strumenti lenti, non funzionanti o sovrutilizzati in tutte le sessioni dell'agente. - [Errori](https://docs.befailproof.ai/it/sessions/errors.md): Raggruppa errori ripetuti e apri le sessioni dietro di essi. - [Metriche](https://docs.befailproof.ai/it/sessions/metrics.md): Traccia metriche di grandezza come latenza, costo e utilizzo di token. - [Dashboard](https://docs.befailproof.ai/it/sessions/dashboards.md): Traccia i segnali di affidabilità che contano per un agente o un flusso di lavoro. - [Query](https://docs.befailproof.ai/it/sessions/queries.md): Esplora i dati di sessione, evento e valutazione con SQL riutilizzabile. #### Plug in your agent - [Strumenta il tuo agente](https://docs.befailproof.ai/it/start/integrations.md): Connetti qualsiasi framework di agenti supportato a Failproof AI con una sola chiamata. - [Agenti personalizzati](https://docs.befailproof.ai/it/start/integrations/custom-agents.md): Strumenta un agente che hai scritto tu stesso, o un framework per il quale Failproof AI non ha un adapter. - [LangChain e LangGraph](https://docs.befailproof.ai/it/start/integrations/langchain.md): Strumenta grafi, nodi, tool, retriever e chiamate ai modelli con una sola chiamata. - [CrewAI](https://docs.befailproof.ai/it/start/integrations/crewai.md): Strumenta equipaggi, flussi, agenti per ruolo, strumenti, memoria e feedback umano. - [LlamaIndex](https://docs.befailproof.ai/it/start/integrations/llamaindex.md): Strumenta flussi di lavoro, passaggi, agenti di funzioni e retriever. - [Pydantic AI](https://docs.befailproof.ai/it/start/integrations/pydantic-ai.md): Strumenta agenti tipizzati, tool, chiamate di modello e retry. ### Find failures #### Evaluate agents - [Valuta gli agenti](https://docs.befailproof.ai/it/evaluations/overview.md): Assegna un punteggio a ogni sessione conclusa dell'agente con valutazioni che definisci: controlli Python ospitati o giudici LLM nel tuo worker. - [Scrivi una valutazione](https://docs.befailproof.ai/it/evaluations/write.md): Descrivi cosa misurare e lascia che l'assistente rediga una valutazione Python ospitata, oppure scrivi il codice tu stesso. I giudici LLM vengono eseguiti nel tuo worker. - [Testare una valutazione](https://docs.befailproof.ai/it/evaluations/test.md): Esegui una valutazione rispetto alle tue sessioni reali prima di distribuirla. Nulla viene archiviato. - [Distribuire e versionare una valutazione](https://docs.befailproof.ai/it/evaluations/deploy.md): Distribuisci una versione immutabile, vedi cosa è in produzione, pubblica nuove versioni, ripristina versioni precedenti e valuta le sessioni già presenti. - [Leggere i risultati delle valutazioni](https://docs.befailproof.ai/it/sessions/evaluations.md): Traccia i punteggi di valutazione nel tempo, confronta agenti e ambienti, scopri perché una sessione ha ottenuto un punteggio basso e chiedi all'assistente. #### Find and manage failures - [Audit](https://docs.befailproof.ai/it/audits/overview.md): Esamina una popolazione definita di sessioni per individuare errori che solo le tracce non riveleranno. - [Audit della cronologia dell'agente locale](https://docs.befailproof.ai/it/audits/local-audit.md): Scansiona le cronologie CLI dell'agente supportate offline e verifica il comportamento rischioso o inefficiente localmente. - [Configurare un audit](https://docs.befailproof.ai/it/audits/setup.md): Definisci un obiettivo di audit, la popolazione della sessione e il contesto delle prove. - [Contesto dell'agente](https://docs.befailproof.ai/it/audits/agent-contracts.md): Indica ai controlli cosa deve fare, produrre e non fare mai ogni agente. - [Eseguire e verificare un audit](https://docs.befailproof.ai/it/audits/run.md): Esegui un audit, verifica la sua copertura e ispeziona i risultati trovati. - [Cadenza di audit](https://docs.befailproof.ai/it/audits/cadence.md): Scegli quando eseguire gli audit ricorrenti e quanti dati esaminare. - [Risultati e problemi](https://docs.befailproof.ai/it/audits/findings-and-issues.md): Trasforma le prove di audit in lavoro di correzione posseduto e tracciabile. - [Avvisi](https://docs.befailproof.ai/it/audits/alerts.md): Rileva ricorrenze e instrada un incidente ai responsabili giusti. - [Ricette di audit](https://docs.befailproof.ai/it/audits/recipes.md): Obiettivi iniziali per indagini comuni su errori degli agenti. ### Prevent failures #### Prevent repeat failures - [Policies](https://docs.befailproof.ai/it/policies/overview.md): Osserva, guida o blocca le azioni dell'agente prima che un errore noto si ripeta. #### Get a policy - [Scrivi una policy](https://docs.befailproof.ai/it/policies/editor.md): Lascia che Failproof AI rediga una policy da un risultato di audit, o scrivi il codice sorgente tu stesso, quindi rivedilo, testalo e pubblicalo. - [Usa un policy pack](https://docs.befailproof.ai/it/policies/packs.md): Collega un policy pack di Failproof AI per il tuo caso d'uso, o un pack della comunità dall'hub delle policy, e scegli cosa applica. #### Ship a policy - [Testare una policy](https://docs.befailproof.ai/it/policies/test.md): Backtesta una bozza rispetto al traffico che hai già, e dimostra che blocca ciò che deve bloccare e consente ciò che deve permettere, prima che qualsiasi macchina la esegua. - [Distribuire una policy](https://docs.befailproof.ai/it/policies/deploy.md): Metti in produzione una versione di policy testata su macchine in modalità osservazione, attivala e conferma che ogni macchina l'ha ricevuta. - [Versioni e rollback](https://docs.befailproof.ai/it/policies/rollback.md): Ogni pubblicazione è una versione immutabile, quindi un rollout che interrompe il lavoro valido degli agent viene annullato ridistribuendo l'ultima versione corretta. - [Pubblicare un policy pack](https://docs.befailproof.ai/it/policies/publish-a-pack.md): Distribuisci le tue policy come release GitHub che chiunque può installare. - [Comportamento in caso di errore](https://docs.befailproof.ai/it/policies/failure-behavior.md): Comprendi cosa accade quando la valutazione delle policy o il daemon locale non sono disponibili. ### Admin #### Operate Failproof AI - [Amministrazione](https://docs.befailproof.ai/it/admin/overview.md): Gestisci accesso, utilizzo, organizzazioni e sicurezza senza mischiarli nel flusso di lavoro di affidabilità. - [Utilizzo](https://docs.befailproof.ai/it/admin/usage.md): Ispeziona il consumo dell'organizzazione e la finestra di fatturazione attiva. - [Chiavi e permessi](https://docs.befailproof.ai/it/admin/keys-and-permissions.md): Crea chiavi API con ambito per macchine, automazione e operatori. - [Utenti e organizzazioni](https://docs.befailproof.ai/it/admin/users-and-organizations.md): Controlla l'appartenenza e mantieni i dati e le azioni di ogni organizzazione isolati. - [Impostazioni e sicurezza](https://docs.befailproof.ai/it/admin/settings-and-security.md): Configura i valori operativi specifici della distribuzione e fai scelte deliberate sui dati dell'agente. ### Integrations and reference #### Connect your agents - [Integrazioni e riferimento](https://docs.befailproof.ai/it/reference/overview.md): Connetti harness di agent supportati, SDK, CLI e l'API HTTP. - [Harness per agenti](https://docs.befailproof.ai/it/reference/harnesses.md): Cattura sessioni e applica criteri su tutti i 12 harness di agenti supportati. - [Agenti personalizzati](https://docs.befailproof.ai/it/reference/custom-agents.md): Configurazione, catalogo degli eventi, regole di correlazione e consegna per failproofai-sdk. - [Evaluator SDK](https://docs.befailproof.ai/it/reference/evaluator-sdk.md): Esegui il tuo worker di valutazione, per giudici LLM e tutto ciò che Python ospitato non può fare. - [Criteri personalizzati](https://docs.befailproof.ai/it/reference/policy-sdk.md): Scrivi, testa e distribuisci criteri JavaScript o TypeScript per errori specifici dei tuoi agenti. - [Self-host Failproof AI Cloud](https://docs.befailproof.ai/it/reference/self-hosting.md): Distribuisci il piano di controllo Failproof AI su un cluster Kubernetes gestito dal cliente. #### Reference - [Failproof AI CLI](https://docs.befailproof.ai/it/reference/failproof-cli.md): Installa hook, gestisci le policy locali, connettiti al Cloud e gestisci il daemon locale. - [Dashboard locale](https://docs.befailproof.ai/it/reference/local-dashboard.md): Rivedi progetti locali, sessioni, attività delle policy, configurazione, audit e scansioni pianificate. - [Configurazione locale](https://docs.befailproof.ai/it/policies/local-configuration.md): Controlla l'ambito delle policy, i parametri, i file personalizzati e le impostazioni di Failproof AI a livello di macchina. - [Failproof Cloud CLI](https://docs.befailproof.ai/it/reference/cloud-cli.md): Riferimento completo per interrogare e amministrare Failproof AI Cloud con fp. - [HTTP API](https://docs.befailproof.ai/it/reference/http-api.md): Autenticati all'API pubblica Failproof AI Cloud `/v1` e utilizza il riferimento endpoint generato. - [Eventi e configurazione](https://docs.befailproof.ai/it/reference/events-and-configuration.md): Fai riferimento al modello di evento, agli ambienti, all'archiviazione locale e ai limiti di configurazione. - [Risoluzione dei problemi](https://docs.befailproof.ai/it/reference/troubleshooting.md): Diagnostica di sessioni mancanti, politiche mancanti, consegna non riuscita e azioni dell'agente bloccate.