Utilizzare un agente

Utilizzo dell'SDK Agent Platform

Quando utilizzi l'SDK Agent Platform, il codice per eseguire query su un agente è lo stesso indipendentemente dal fatto che sia in esecuzione in locale o di cui sia stato eseguito il deployment in remoto. Poiché l'insieme di operazioni supportate varia a seconda dei framework, forniamo istruzioni sull'utilizzo dei modelli specifici del framework:

Framework Descrizione
Agent Development Kit Progettato in base alle best practice interne di Google per gli sviluppatori che creano applicazioni AI o per i team che devono prototipare ed eseguire rapidamente il deployment di soluzioni basate su agenti robuste.
Agent2Agent (anteprima) Il protocollo Agent2Agent (A2A) è uno standard aperto progettato per consentire una comunicazione e una collaborazione fluide tra gli agenti AI.
LangChain Più facile da utilizzare per i casi d'uso di base grazie alle configurazioni e alle astrazioni predefinite.
LangGraph Approccio basato su grafici per la definizione dei flussi di lavoro, con funzionalità avanzate human-in-the-loop e di riavvolgimento/riproduzione.
AG2 (in precedenza AutoGen) AG2 fornisce un framework di conversazione multi-agente come astrazione di alto livello per la creazione di flussi di lavoro LLM.
LlamaIndex (anteprima) La pipeline di query di LlamaIndex offre un'interfaccia di alto livello per la creazione di flussi di lavoro RAG (Retrieval-Augmented Generation).
Personalizzato Agenti sviluppati ed eseguiti il deployment senza l'utilizzo di un modello specifico del framework.

Utilizzare gli agenti pubblicati su localhost

Se pubblichi gli agenti tramite un server API che è in attesa di richieste su http://localhost:PORT_NUMBER, invia le richieste a

http://localhost:PORT_NUMBER/API_PATH

dove

  • PORT_NUMBER è il numero di porta su cui il server è in attesa (ad es. 8080)
  • API_PATH è il percorso dell'endpoint API corrispondente (ad es. run o run_sse)

Utilizzare gli agenti di cui è stato eseguito il deployment tramite l'API sottostante

Se hai eseguito il deployment di un agente, invia le richieste all'endpoint corrispondente:

https://LOCATION-aiplatform.googleapis.com/reasoningEngines/v1/projects/PROJECT_NUMBER/locations/<var>LOCATION</var>/reasoningEngines/RESOURCE_ID/api/API_PATH

dove

  • PROJECT_ID è l' Google Cloud ID progetto in cui hai eseguito il deployment dell'agente
  • LOCATION è la regione in cui è stato eseguito il deployment dell'agente
  • RESOURCE_ID è l'ID dell'agente di cui è stato eseguito il deployment come risorsa reasoningEngine
  • API_PATH è il percorso dell'endpoint API corrispondente

Questo endpoint è equivalente alla sostituzione dell'URL di base localhost con l'URL di base dell'agente di cui è stato eseguito il deployment.

Per fare alcuni esempi, se hai eseguito il deployment del server API ADK da un Dockerfile o da un'immagine container, richiama gli endpoint API nel seguente modo:

Eseguire l'agente (risposta singola) 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the capital of France?"}]
  }
}'

Eseguire l'agente (streaming) 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run_sse -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the weather in New York?"}]
  },
  "streaming": true
}'

Utilizzare gli agent0i di cui è stato eseguito il deployment nella Google Cloud console

Per gli agenti di cui è stato eseguito il deployment sviluppati utilizzando Agent Development Kit (ADK), puoi utilizzare la Google Cloud console per interagire con l'agente:

  1. Nella Google Cloud console, vai alla pagina Agent Platform Deployments.

    Vai a Deployment di Agent Platform

    Nell'elenco vengono visualizzati i runtime che fanno parte del progetto selezionato. Puoi utilizzare il campo Filtra per filtrare l'elenco in base alla colonna specificata.

  2. Fai clic sul nome del runtime.

  3. Fai clic sulla scheda Playground.

  4. Puoi digitare un messaggio per interagire con l'agente e fare clic su Nuova sessione per avviare una nuova sessione con l'agente.

  5. Se hai abilitato le tracce tramite OpenTelemetry, puoi visualizzare i dettagli sul comportamento dell'agente durante le interazioni:

    • Traccia: tracce delle conversazioni con l'agente.

    • Evento: un grafico delle API richiamate e dei dettagli degli eventi durante le tue conversazioni con l'agente.

    • Stato: informazioni sullo stato dell'agente durante le conversazioni.

    • Sessioni: un elenco di sessioni associate all'agente. Per ulteriori informazioni, consulta Gestire utilizzando la Google Cloud console o le chiamate API

Supporto del playground

Puoi utilizzare i seguenti framework per provare l'agente:

Framework Chatta con un agente Visualizza le sessioni
Agent Development Kit (ADK) Supportato Supportati Richiede che l'agente implementi le sessioni di Agent Platform per la persistenza.
Agent2Agent (A2A) Supportato Richiede che l'agente implementi le sessioni di Agent Platform per la persistenza. Supportato Richiede che l'agente utilizzi le sessioni di Agent Platform e che l'agente debba inviare il valore user_id come parte dell'oggetto di contesto. Per un esempio su come trasmettere il valore user_id come parte dell'esecutore dell'agente, consulta il notebook Inizia a utilizzare A2A.

Passaggi successivi