Azienda

Creare agenti AI con la Mistral Agents API

May 27, 2025

By Mistral AI

Cover

Oggi annunciamo la nostra nuova Agents API, un importante passo avanti per rendere l’AI più capace, utile e attiva nella risoluzione dei problemi.

I modelli linguistici tradizionali eccellono nella generazione di testo, ma sono limitati nella capacità di eseguire azioni o mantenere il contesto. La nostra nuova Agents API supera questi limiti combinando i potenti modelli linguistici di Mistral con:

  • Connettori integrati per esecuzione di codice, ricerca web, generazione di immagini e strumenti MCP 

  • Memoria persistente tra conversazioni 

  • Funzionalità di orchestrazione agentica

La Agents API integra la nostra Chat Completion API offrendo un framework dedicato che semplifica l’implementazione di casi d’uso agentici. Costituisce la base delle piattaforme agentiche di livello enterprise.

Fornendo un framework affidabile che consente agli agenti AI di gestire attività complesse, mantenere il contesto e coordinare più azioni, la Agents API permette alle aziende di usare l’AI in modi più concreti e incisivi.


Agenti Mistral in azione.

Esplori le diverse applicazioni della Agents API di Mistral in vari settori:

Assistente di coding con Github.

Un workflow agentico creato con la Agents API di Mistral, in cui un agente interagisce con Github e supervisiona un agente sviluppatore, alimentato da DevStral per scrivere codice. All’agente viene concessa piena autorità su Github, mostrando la gestione automatizzata delle attività di sviluppo software.

Consulti il nostro cookbook

Assistente per ticket Linear.

Un assistente intelligente per il coordinamento delle attività, basato sulla nostra Agents API, che usa un’architettura MCP multi-server per trasformare trascrizioni di chiamate in PRD, poi in issue Linear operative, e monitorare i deliverable di progetto.

Consulti il nostro cookbook

Analista finanziario.

Un agente di consulenza finanziaria costruito con la nostra Agents API, che orchestra più server MCP per acquisire metriche finanziarie, compilare insight e archiviare i risultati in modo sicuro.

Consulti il nostro cookbook

Assistente di viaggio.

Un potente assistente di viaggio AI che aiuta a pianificare viaggi, prenotare alloggi e gestire le esigenze di viaggio.

Consulti il nostro cookbook

Assistente nutrizionale.

Un compagno alimentare basato su AI progettato per aiutare a definire obiettivi, fare log dei pasti, ricevere suggerimenti alimentari personalizzati, monitorare i risultati quotidiani e scoprire opzioni di ristorazione allineate agli obiettivi nutrizionali.

Consulti il nostro cookbook


Crei un agente con connettori integrati e strumenti MCP.

Ogni agente può essere dotato di potenti connettori integrati, strumenti già distribuiti e pronti per essere richiamati dagli agenti on demand, e di strumenti MCP: 

  • Esecuzione di codice

    La Agents API può usare il connettore di esecuzione del codice, consentendo agli sviluppatori di creare agenti che eseguono codice Python in un ambiente sandbox sicuro. Ciò permette agli agenti di affrontare un’ampia gamma di attività, tra cui calcoli e analisi matematiche, visualizzazione e plotting dei dati, e calcolo scientifico.

  • Generazione di immagini

    Lo strumento connettore per la generazione di immagini, basato su Black Forest Lab FLUX1.1 [pro] Ultra, consente agli agenti di creare immagini per applicazioni diverse. Questa funzionalità può essere sfruttata per vari casi d’uso, come generare supporti visivi per contenuti didattici, creare grafiche personalizzate per materiali di marketing o persino produrre immagini artistiche.

  • Libreria documenti

    Document Library è uno strumento connettore integrato che consente agli agenti di accedere ai documenti da Mistral Cloud. Alimenta la funzionalità RAG integrata, rafforzando la conoscenza degli agenti grazie ai contenuti dei documenti caricati dagli utenti.

  • Ricerca web

    La Agents API offre la ricerca web come connettore, consentendo agli sviluppatori di combinare i modelli Mistral con informazioni diversificate e aggiornate provenienti dalla ricerca web, da fonti giornalistiche affidabili e da altre fonti. Questa integrazione facilita la generazione di risposte aggiornate, informate e supportate da evidenze.
    Gli agenti con funzionalità di ricerca web mostrano un miglioramento significativo delle prestazioni. Nel benchmark SimpleQA, Mistral Large e Mistral Medium con ricerca web raggiungono punteggi rispettivamente del 75% e dell’82,32%, rispetto al 23% e al 22,08% senza ricerca web (vedere la figura sotto).

    Accuratezza SimpleQA (più alto è meglio)

     

  • Strumenti MCP

    L’SDK della Agents API può anche sfruttare strumenti basati sul Model Context Protocol (MCP), un protocollo aperto e standardizzato che consente un’integrazione fluida tra agenti e sistemi esterni. Gli strumenti MCP offrono un’interfaccia flessibile ed estensibile che permette agli agenti di accedere al contesto del mondo reale, tra cui API, database, dati degli utenti, documenti e altre risorse dinamiche. Consulti le demo Github, Financial Analyst e Linear MCP per scoprire come usare gli strumenti MCP con Mistral Agents in azione.
    Mcp Mistral

Memoria e contesto con conversazioni stateful.

La Agents API offre una gestione solida delle conversazioni tramite un sistema di conversazione flessibile e stateful. Ogni conversazione conserva il proprio contesto, consentendo interazioni fluide e coerenti nel tempo.

  • Gestione delle conversazioni

    Esistono due modi per avviare una conversazione:
    Ogni conversazione mantiene una cronologia strutturata tramite voci di conversazione, assicurando la preservazione del contesto tra le interazioni.

    1. Con un Agent: crei una conversazione con uno specifico agent_id per sfruttarne le capacità specialistiche.

    2. Accesso diretto: avvii una conversazione specificando direttamente il modello e i parametri di completamento, ottenendo un accesso rapido ai connettori integrati.

  • Interazioni stateful e ramificazione delle conversazioni

    Gli sviluppatori non sono più tenuti a monitorare la cronologia delle conversioni; hanno la possibilità di visualizzare le conversazioni passate. Possono sempre continuare qualsiasi conversazione o avviare nuovi percorsi conversazionali da qualsiasi punto. 

  • Output in streaming

    L’API supporta anche output in streaming, sia all’avvio di una conversazione sia quando se ne continua una precedente. Questa funzionalità consente aggiornamenti e interazioni in tempo reale. 

Orchestrazione degli agenti.

La vera potenza della nostra Agents API risiede nella capacità di orchestrare più agenti per risolvere problemi complessi. Tramite l’orchestrazione dinamica, gli agenti possono essere aggiunti o rimossi da una conversazione in base alle necessità, ciascuno contribuendo con le proprie capacità uniche per affrontare diverse parti di un problema.

Agents

  • Creazione di un workflow agentico

    Per creare un workflow con handoff, inizi creando tutti gli agenti necessari. Può creare tutti gli agenti necessari, ciascuno con strumenti e modelli specifici, per formare un workflow su misura.

  • Handoff tra agenti

    Una volta creati gli agenti, definisca quali agenti possono trasferire attività ad altri. Ad esempio, un agente finanziario potrebbe delegare attività a un agente di ricerca web o a un agente calcolatore in base alle esigenze della conversazione.
    Gli handoff consentono una catena di azioni fluida. Una singola richiesta può attivare attività su più agenti, ognuno dei quali gestisce parti specifiche della richiesta. Questo approccio collaborativo permette una risoluzione dei problemi efficiente ed efficace, sbloccando potenti possibilità per applicazioni nel mondo reale.

Inizi subito.

Per iniziare, consulti la nostra documentazione, crei il suo primo agente e inizi a costruire.