Agenti di salvataggio
È possibile costruire in modo incrementale il proprio agente AI in Agent Lab e tenere traccia del lavoro di sviluppo salvando la configurazione dei componenti principali dell'agente.
Quando si salva la configurazione dell'agente, si può scegliere di salvarla in diversi tipi di risorse. Il salvataggio del lavoro come risorsa consente di condividere il lavoro con i collaboratori del progetto in corso.
| Tipo di asset | Quando utilizzare questo tipo di attività | Cosa viene salvato | Come recuperare il bene |
|---|---|---|---|
| Attività dell'agente | Quando si crea un agente che genera i risultati desiderati utilizzando una combinazione di un modello specifico e un insieme di strumenti e si desidera riutilizzare l'agente. | Nome e descrizione dell'agente, foundation model e relative impostazioni dei parametri, domande di avvio rapido, istruzioni per il modello e strumenti utilizzati dall'agente. Nota: L'output generato dall'agente non viene salvato come parte dell'asset Agente.
|
Dalla scheda Agenti salvati di Agent Lab |
| Assetto standard del notebook | Quando si desidera lavorare con gli agenti in modo programmatico, ma si vuole partire dall'interfaccia Agent Lab per una migliore esperienza di sviluppo degli agenti. | Le impostazioni di foundation model e dei relativi parametri e gli strumenti utilizzati dall'agente sono formattati come codice Python e memorizzati in un blocco note Python. | Dalla pagina delle risorse del progetto |
| Blocco Note di distribuzione | Quando il vostro agente è in grado di svolgere funzioni avanzate come la ricerca di documenti di base per trovare risposte alle domande di una chat e volete distribuire la funzione come servizio di intelligenza artificiale. | Un servizio di intelligenza artificiale distribuibile che può essere consumato tramite API REST. | Dalla pagina delle risorse del progetto |
Ciascuno di questi tipi di risorse è disponibile nella pagina delle risorse del progetto. I collaboratori del progetto con il ruolo di Admin o Editor possono aprire e lavorare con le risorse. La risorsa agente viene bloccata automaticamente se viene aperta in modalità di modifica, impedendo ad altri utenti di utilizzarla. È possibile accedere alla risorsa agente in modalità Anteprima senza bloccarla.
Salvataggio del lavoro di sviluppo dell'agente
Per salvare il lavoro di sviluppo dell'agente, completare i passaggi seguenti:
Dall'intestazione dell'editor dell'agente, fare clic sull'icona Salva lavoro
, quindi su Salva con nome.Scegliere un tipo di risorsa.
Se si sceglie di creare un notebook di flusso Gen AI distribuibile, è necessario associare l'agente a uno spazio di distribuzione. Per ulteriori informazioni, vedere Spazi di distribuzione.
Dare un nome alla risorsa e aggiungere una descrizione.
Fare clic su Salva.
Lavorare con gli agenti salvati in un blocco note
Quando si salva il lavoro come risorsa notebook, viene creato un notebook Python.
Per lavorare con una risorsa notebook agente, seguire la procedura relativa al tipo di notebook.
Notebook standard
Aprire l'asset del blocco note dalla scheda Assets del progetto.
Fare clic sull'icona Modifica
per istanziare il blocco note, in modo da poter procedere con il codice.Il blocco note contiene codice eseguibile che gestisce le seguenti fasi per l'utente:
- Autentica con il servizio.
- Definisce una classe Python.
- Definisce il sito foundation model selezionato e i suoi parametri, un insieme di strumenti e istruzioni da utilizzare per creare l'agente.
- Crea ed esegue l'agente abbinandolo a una domanda come input per generare una risposta.
Utilizzate il notebook così com'è, oppure modificatelo per soddisfare le esigenze del vostro caso d'uso.
Il codice Python generato utilizzando il Laboratorio agenti viene eseguito correttamente. È necessario testare e convalidare qualsiasi modifica apportata al codice.
Blocco Note di distribuzione
Aprire l'asset del blocco note dalla scheda Assets del progetto.
Fare clic sull'icona Modifica
per istanziare il blocco note, in modo da poter procedere con il codice.Il blocco note contiene codice eseguibile che gestisce le seguenti fasi per l'utente:
- Autentica con il servizio.
- Si connette allo spazio di destinazione e promuove gli asset in modo che i loro dati siano accessibili dal servizio AI.
- Definisce il servizio AI da distribuire. Questo include il codice per creare l'agente, formattare l'input per l'agente ed eseguire l'agente per generare le risposte.
- Testa il servizio AI localmente.
- Distribuisce il servizio AI nello spazio di destinazione.
- Testa il servizio AI distribuito.
Utilizzate il notebook così com'è, oppure modificatelo per soddisfare le esigenze del vostro caso d'uso.
Il codice Python generato utilizzando il Laboratorio agenti viene eseguito correttamente. È necessario testare e convalidare qualsiasi modifica apportata al codice.
Il servizio di intelligenza artificiale distribuito dal notebook può essere consumato utilizzando un'API REST. Di seguito è riportato un esempio di richiesta cURL per chiamare l'installazione client:
curl --location '${PUBLIC_ENDPOINT}' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ${IAM_TOKEN}' \ --data '{ \ "messages": [{$MESSAGES}] }'Dove
- PUBLIC_ENDPOINT è l'endpoint pubblico della distribuzione. Vedere Creazione di distribuzioni online.
- IAM_TOKEN è il token di autenticazione per accedere ai servizi IBM Cloud. Vedere Credenziali per l'accesso al programma. Il token di accesso utilizzato deve essere associato allo stesso account del progetto a cui si fa riferimento nel blocco note.
- MESSAGGI è un array di voci di testo della cronologia della chat con il seguente schema:
{ "role": type, // "user" or "assistant" "content": content // The text content of the message }
Per i dettagli su come distribuire e inferenziare i servizi AI, vedere Distribuzione dei servizi AI con gli strumenti.
Lavorare con le risorse dell'agente salvate
Per continuare a lavorare con un agente salvato, aprirlo dalla scheda Agenti salvati del Laboratorio agenti.
Quando si apre un agente salvato, il salvataggio automatico è attivo, il che significa che tutte le modifiche apportate all'agente si rifletteranno nell'asset dell'agente salvato. Se si desidera che l'agente salvato rimanga invariato, fare clic su Nuovo agente per avviare la creazione di un nuovo agente.
Argomento principale: Laboratorio agenti