Importazione degli agenti dell' LangGraph

Modifica online

Importa gli agenti personalizzati di LangGraph in watsonx Orchestrate per distribuirli su un'infrastruttura di livello aziendale, mantenendo il pieno controllo sulla logica e sul ragionamento degli agenti.

Nota: questa funzionalità è supportata solo nelle regioni commerciali AWS e IBM Cloud. Non è disponibile per le distribuzioni in locale né per AWS GovCloud (USA).

Perché rivolgersi agli agenti dell' LangGraph

LangGraph è un framework di programmazione per la creazione di agenti basati su modelli linguistici di grandi dimensioni (LLM) che estende LangChain con la possibilità di creare grafi ciclici. Ciò consente agli agenti di adottare modelli di ragionamento complessi che vanno oltre i semplici cicli " ReAct ", una gestione personalizzata degli stati per flussi di lavoro personalizzati, un'orchestrazione in più fasi con logica condizionale e il pieno controllo sul comportamento e sul processo decisionale degli agenti.

L'importazione degli agenti di LangGraph in watsonx Orchestrate risolve le seguenti problematiche:

Distribuzione degli agenti LangGraph esistenti : se disponi di un agente LangGraph che funziona in ambiente di sviluppo ma hai bisogno di un'infrastruttura di produzione che includa hosting, sicurezza, autenticazione, monitoraggio e applicazione delle politiche senza dover riscrivere l'agente, puoi importarlo in watsonx Orchestrate e ottenere immediatamente l'accesso a funzionalità aggiuntive con modifiche minime al codice.

Creazione di agenti specializzati : quando gli agenti standard di ReAct presentano dei limiti e sono necessari modelli di ragionamento personalizzati, una gestione complessa degli stati, flussi di lavoro a più fasi o logiche specializzate che vanno oltre la semplice selezione degli strumenti, è possibile scrivere agenti personalizzati su LangGraph con pieno controllo sulla logica e sul ragionamento, per poi eseguirli su watsonx Orchestrate come gli altri agenti nativi.

Come funzionano gli agenti di importazione di LangGraph

LangGraph Gli agenti importati in watsonx Orchestrate vengono eseguiti in modo nativo all'interno dell'infrastruttura di runtime della piattaforma. A differenza degli agenti esterni che dispongono di un proprio hosting, gli agenti LangGraph importati sono completamente integrati nella piattaforma watsonx Orchestrate. Ciò significa che:

  • Il codice dell'agente viene eseguito all'interno dell'ambiente watsonx Orchestrate con il livello di isolamento richiesto.
  • watsonx Orchestrate gestisce il ciclo di vita degli agenti, il ridimensionamento e l'allocazione delle risorse.
  • L'agente beneficia delle funzionalità di sicurezza, monitoraggio e gestioni offerte d watsonx Orchestrate.
  • La comunicazione avviene tramite il protocollo A2A ( A2A ) per la collaborazione con altri agenti.
  • Gli agenti importati da LangGraph possono essere utilizzati come agenti di primo livello o come collaboratori di altri agenti.
  • È possibile visualizzarli e configurarli nella piattaforma, nonché distribuirli in ambienti di produzione.

Prima di iniziare

Prima di importare un agente LangGraph, assicurati di disporre di:

LangGraph pacchetto

Fornire un pacchetto di file ZIP ben strutturato per l' LangGraph, contenente:

  • agent.yaml file di configurazione
  • Almeno una funzione di fabbrica (.py file)
  • requirements.txt file

Per informazioni sulla creazione di pacchetti dell'agent " LangGraph ", consultare la sezione Creazione di un pacchetto " LangGraph " per l'importazione.

Connessioni

Se il tuo agente richiama modelli di linguaggio generico (LLM) esterni o strumenti che richiedono l'autenticazione, crea tutte le connessioni necessarie al tuo agente in modo da poterle selezionare durante il processo di importazione. Per ulteriori informazioni, consultare la sezione "Creazione di connessioni per gli agenti di LangGraph ".

Importante: è necessario creare tutte le connessioni richieste prima di importare l'agente. Il processo di importazione non verifica la presenza delle connessioni richieste; assicurati quindi che tutte le connessioni necessarie siano presenti e configurate correttamente prima di procedere.

Limite di importazione

Verifica che l'utente non abbia raggiunto il limite di 3 agenti LangGraph.

Requisiti di convalida

Prima dell'importazione, il pacchetto dell'agente deve superare le seguenti verifiche:

Verifiche della struttura dei file

  • Il file ZIP non è danneggiato
  • Contiene agent.yaml il file
  • Contiene almeno un .py file
  • Contiene requirements.txt il file

Verifiche di configurazione

  • Il agent.yaml file è in formato YAML valido.
  • Il spec_version campo esiste ed è uguale a v1.
  • Il kind campo esiste ed è uguale a agent.
  • Il name campo esiste, non è vuoto e non supera i 40 caratteri.
  • Il description campo è presente e non è vuoto.
  • Il deployment.code_bundle.entrypoint campo esiste e segue module:function il formato.

Limiti e restrizioni

Si prega di tenere presente queste limitazioni quando si lavora con agenti importati da LangGraph :

Limiti per gli inquilini

Ogni inquilino può avvalersi al massimo di tre agenti di LangGraph. Questo limite tiene conto di tutti gli agenti LangGraph, compresi quelli importati e quelli copiati negli spazi di lavoro. Se si raggiunge questo limite, qualsiasi tentativo di importare ulteriori agenti LangGraph genera un errore di «limite superato». Quando si gestisce l'utilizzo di " LangGraph " all'interno di un tenant, è necessario tenere conto sia degli agenti importati che di quelli copiati.

Requisiti di connessione

È necessario creare tutte le connessioni prima di importare l'agente; sono supportate solo le connessioni configurate con le credenziali del team.

Nota: il sistema non verifica se le connessioni selezionate soddisfano i requisiti del tuo agente.

Persistenza dello stato

Tra un turno di conversazione e l'altro vengono conservati solo i messaggi presenti nel grafico degli agenti. Gli oggetti di stato personalizzati complessi non vengono salvati tra un turno e l'altro.

Per ulteriori informazioni su come abilitare la persistenza dello stato per un agent LangGraph, consultare Abilitazione della persistenza dello stato per gli agent LangGraph.

Collaborazione tra agenti

Gli agenti nativi di watsonx Orchestrate possono utilizzare gli agenti di LangGraph come collaboratori, ma gli agenti di LangGraph non possono utilizzare gli agenti nativi come collaboratori.

Strumenti e integrazioni

Gli strumenti inclusi nel pacchetto dell'agente non sono disponibili come strumenti dell' watsonx Orchestrate e e sono supportati solo in modalità di sola lettura. Inoltre:

  • Non è possibile utilizzare gli strumenti del proprio agente LangGraph in altri agenti.
  • watsonx Orchestrate Strumenti quali i flussi di lavoro basati su agenti, gli strumenti " Python ", gli strumenti MCP e gli strumenti " OpenAPI " non sono supportati per gli agenti " LangGraph ".

Altre limitazioni

Al momento sono supportati solo gli agenti LangGraph basati su Python.

Importante: per le limitazioni e i comportamenti noti, consultare la sezione "Problemi noti ".

Procedura

Segui questi passaggi per importare l'agente " LangGraph " su watsonx Orchestrate.

Passaggio 1: Importare il pacchetto dell'agente

  1. Vai alla pagina "Agenti e strumenti" su watsonx Orchestrate.
  2. Fai clic su Crea agente + > Importa agente d LangGraph.
  3. Carica il pacchetto dell'agente LangGraph.
    • Il file ZIP non è danneggiato
    • Contiene agent.yaml il file
    • Contiene almeno un .py file
    • Contiene requirements.txt il file
    • agent.yaml ha una sintassi YAML corretta
    • I campi di configurazione obbligatori sono presenti e validi
  4. Se la convalida non va a buon fine, viene visualizzato un messaggio di errore che indica cosa è necessario modificare. Risolvi i problemi nel tuo pacchetto agente e prova a caricarlo di nuovo.
  5. Se la convalida va a buon fine, fare clic su Avanti per passare alla selezione della connessione.

Passaggio 2: Seleziona le connessioni

  1. La schermata delle connessioni mostra tutte le connessioni di squadra disponibili nella tua istanza.
  2. Seleziona tutte le connessioni necessarie al corretto funzionamento del tuo agente:
    • Per gli agenti basati su LLM, seleziona la connessione relativa al tuo fornitore di modelli linguistici.
    • Se utilizzi API esterne, seleziona le connessioni per ciascuna API a cui il tuo agente effettua una chiamata.
    • Se il tuo agente non richiede alcuna connessione, puoi saltare questo passaggio.
  3. Fai clic su Avanti per completare l'importazione.
Nota: tutte le connessioni sono elencate senza alcun filtro. Spetta a te selezionare le connessioni corrette che corrispondono a quanto previsto dalla tua funzione di creazione di agenti. Il sistema non verifica se le connessioni selezionate siano effettivamente necessarie per il tuo agente.
Importante:

Quando si utilizza un agente LangGraph, non è possibile modificare alcuni campi di configurazione tramite l'interfaccia standard.

  • Stile dell'agente
  • Configurazione vocale
  • Conoscenze
  • Strumenti
  • Agenti collaboratori
  • Linee guida
  • Chattare con i documenti

Per modificare una qualsiasi di queste impostazioni, aggiorna direttamente il codice dell'agente LangGraph e reimporta il pacchetto.

Cosa fare successivamente

Dopo aver importato il tuo agente " LangGraph ", puoi potenziarlo con ulteriori funzionalità di " watsonx Orchestrate " utilizzando l'ADK:

Integrazione con AI Gateway : utilizza i modelli di linguaggio (LLM) di watsonx Orchestrate tramite l'AI Gateway standard, invece di gestire autonomamente le connessioni ai tuoi modelli LLM.

Integrazione della memoria : integrarsi con i servizi di memoria di watsonx Orchestrate per recuperare ricordi rilevanti per il contesto, inserire nuovi ricordi o garantire la continuità della conversazione tra una sessione e l'altra.

Istruzioni aggiuntive : istruzioni di leverage configurate dal generatore di agenti per personalizzare il comportamento degli agenti senza modificare il codice.

Variabili di contesto : accedi alle variabili di contesto dell' watsonx Orchestrate.

Per ulteriori informazioni, consultare la documentazione relativa all'Agent Development Kit di IBM watsonx Orchestrate.