Configurare e usare un agente nella chat

In ALIDA è possibile esporre un endpoint per ogni agente. La chat della BDA puo essere collegata, tramite questi endpoint, a piu agenti usando una variabile d'ambiente contenente la relativa configurazione JSON.

Prima di iniziare, verificare di disporre di: - Un agente in esecuzione - l'URL dell'endpoint di invocazione dell'agente; - l'URL dell'endpoint di streaming, se l'agente lo espone; - il protocollo API dell'endpoint.

Gli URL sono endpoint REST esposti dalla BDA. Per capire come ALIDA espone e protegge questi endpoint, consultare Porte I/O: Endpoint REST API.

Campi di configurazione

Campo	Significato
name	Nome visualizzato o logico dell'agente.
url	Endpoint principale per invocare l'agente.
streamingUrl	Endpoint per ricevere risposte in streaming.
protocol	Protocollo applicativo usato dall'integrazione.
contextPage	Pagine ALIDA in cui l'agente sarà utilizzabile nella chat, può essere lasciato vuoto per rendere l'agente disponibile in ogni paagina di alida
extra.queryParams	Parametri aggiuntivi della chiamata.

Esempi di configurazione

OpenCodeEndpoint compatibile OpenAI

{
  "name": "Custom Coding Agent",
  "url": "https://<url-istanza-alida>/events/bda/<bda-id>/<service-id>",
  "streamingUrl": "https://<url-istanza-alida>/events/bda/streaming/<bda-id>/<service-id>",
  "token": "",
  "protocol": "OpenCode",
  "contextPage": [
    {
      "path": "/services"
    }
  ],
  "extra": {
    "queryParams": {
      "token": "{{alida-token}}"
    }
  }
}

Usare questa configurazione per qualsiasi agente che espone API compatibili con OpenAI. L'ADK Agent e uno degli agenti che integra questo tipo di endpoint.

{
  "type": "agent",
  "name": "Alida Agent",
  "url": "https://<url-istanza-alida>/events/bda/<bda-id>/<service-id>/v1",
  "streamingUrl": "https://<url-istanza-alida>/events/bda/streaming/<bda-id>/<service-id>",
  "token": "",
  "protocol": "OpenAI",
  "contextPage": [
    {
      "path": "/services"
    }
  ],
  "extra": {
    "queryParams": {
      "token": "{{alida-token}}"
    }
  }
}

Prima richiesta

1. Raggiungere la pagina indicata in contextPage, ad esempio /services.
2. Aprire la chat e formulare una richiesta coerente con il contesto.
3. Verificare il risultato prima di usare o distribuire gli artefatti prodotti.