27 Registro AI

AI Registry è il catalogo centrale di agenti e server MCP per Oracle AI Data Platform. Supporta standard aperti, tra cui MCP e A2A.

AI Data Platform è il luogo in cui gli agenti vengono creati e distribuiti. Oracle Agent Hub è il punto in cui gli utenti business parlano con loro. Il registro AI è il livello tra di loro. AI Registry rende un agente o uno strumento rilevabile e utilizzabile al di fuori dell'ambiente in cui è stato integrato. Gli agenti e gli strumenti devono essere registrati nel registro AI prima di poter essere condivisi nell'hub agente. Vedere Funzionamento dell'intelligenza artificiale aziendale nell'hub agente in Uso di Oracle Agent Hub.

Puoi registrare i seguenti agenti e strumenti nel registro AI di AI Data Platform:

Type Descrizione
Agente di AI Data Platform Un agente creato e distribuito in AI Data Platform, in un'area di lavoro a cui si ha accesso. Chiamato anche agente locale nel registro AI di AI Data Platform.
Agente esterno Un agente ospitato al di fuori di AI Data Platform, aggiunto dal relativo URL della scheda agente A2A.
Server MCP Un server MCP (Model Context Protocol) che espone un set di strumenti che gli agenti possono chiamare.

Nel registro AI, puoi gestire agenti AI, server MCP e credenziali necessarie per utilizzare entrambi. Nella pagina Registro AI è possibile utilizzare le schede Agenti, Server MCP e Credenziali per visualizzare un elenco di ciascuno di essi. È possibile utilizzare la barra di ricerca per filtrare le opzioni visibili in base al nome o alla descrizione. Nella scheda Agenti è possibile utilizzare il menu a discesa Ordina per per ordinare in base alla recente aggiunta di agenti al registro.

Facendo clic su una scheda agente vengono visualizzati i dettagli relativi all'agente, fornendo l'autore, l'origine, la versione, un URL per la scheda agente e la versione del protocollo. È possibile passare dalla vista dei dettagli a una vista JSON della scheda utilizzando le opzioni nell'angolo superiore destro della scheda.

Prima di registrare nuovi agenti esterni o server MCP, è necessario registrare le proprie credenziali di autenticazione nella scheda Credenziali. È quindi possibile registrare nuovi agenti e server MCP facendo clic su Registrati in alto a destra e selezionando l'opzione appropriata. Le autorizzazioni per il registro AI vengono gestite dalla scheda Autorizzazioni.

Informazioni sulle schede agente

Le schede agente sono la struttura di metadati che descrive un agente. Il registro AI li legge durante la registrazione e li mostra all'utente per la revisione prima del commit.

Per ulteriori informazioni, vedere A2A Protocol Specification.

Le schede agente contengono le seguenti informazioni:
  • Nome, versione e descrizione.
  • L'URL della scheda agente, dove viene pubblicata la scheda stessa.
  • Versione protocollo.
  • Modalità di input e output. Ad esempio, text, text/plain o text/html.
  • Funzionalità, come lo streaming.
  • Competenze, ognuna con il proprio nome e descrizione.
La scheda corrisponde all'orchestrazione. Quando un utente fa una domanda nell'hub dell'agente senza selezionare un agente, il nome, la descrizione, le competenze e le funzionalità di questa scheda determinano se l'agente è emerso. Una vaga descrizione è il motivo più comune per cui un agente non viene mai selezionato.

Crea credenziali nel registro AI

È possibile salvare le credenziali necessarie per l'uso nell'autenticazione degli oggetti del registro AI come agenti e server MCP.

  1. Nella home page, fare clic su Icona Registro AIRegistro AI.
  2. Fare clic sulla scheda Credenziali, quindi su Crea credenziale.
  3. Immettere un nome e una descrizione per la credenziale.
  4. Selezionare il tipo di credenziale dal menu a discesa.
  5. Selezionare il tipo di concessione dal menu a discesa.
  6. Immettere l'URL di autorizzazione, l'URL token di accesso, l'ID client, il segreto client e l'URL di aggiornamento per le credenziali.
  7. Immettere un nome e un valore per l'ambito. È necessario specificare almeno un nome e un valore di ambito. Aggiungere nomi e valori di ambito aggiuntivi facendo clic su Aggiungi ambito.
  8. Copiare l'URL di reindirizzamento. È necessario incollare l'URL di reindirizzamento all'applicazione riservata nel dominio di Identity. L'esempio seguente mostra come copiare l'URL di reindirizzamento in Oracle Cloud Infrastructure:
    1. Eseguire il login a OCI Console.
    2. Fare clic su Identità e sicurezza, quindi su Domini e infine su Applicazioni integrate.
    3. Selezionare l'applicazione per la quale si desidera aggiornare gli URL di reindirizzamento.
    4. Fare clic sulla scheda OAuth Configurazione, quindi fare clic su Modifica configurazione OAuth.
    5. Applicare gli URL di reindirizzamento necessari, quindi fare clic su Sottometti.
  9. Fare clic su Crea.

Registrare un agente locale nel registro AI

È possibile registrare agenti AI locali dalle aree di lavoro di Oracle AI Data Platform a cui si ha accesso.

Gli agenti devono essere distribuiti in AI Data Platform prima di poter essere registrati nel registro AI. Vedere Distribuzione agente.
  1. Nella home page, fare clic su Icona Registro AIRegistro AI.
  2. Fare clic su Registra, quindi su Agente.
  3. Fare clic su Agente locale.
  4. Dal menu a discesa Area di lavoro selezionare l'area di lavoro in cui si trova l'agente locale.
  5. Nel menu a discesa Agente, selezionare l'agente che si desidera registrare.
  6. Facoltativo: superare l'icona della scheda per visualizzare un'anteprima della scheda agente.
  7. Fare clic su Avanti.
  8. Confermare che i dettagli dell'agente sono corretti, quindi fare clic su Registra.

Registra un agente esterno nel registro AI

È possibile registrare agenti AI esterni dalle origini supportate nel registro AI. Questi agenti devono essere conformi al protocollo A2A.

Se l'agente esterno richiede l'autenticazione, prima creare tali credenziali nella scheda Credenziali del registro AI.
  1. Nella home page, fare clic su Icona Registro AIRegistro AI.
  2. Fare clic su Registra, quindi su Agente.
  3. Fare clic su Agente esterno.
  4. Immettere l'URL della scheda agente.
  5. Facoltativo: se l'endpoint richiede credenziali sicure, selezionare Richiedi autenticazione, quindi selezionare le credenziali dal menu a discesa Credenziali.
  6. Fare clic su Avanti.
  7. Facoltativo: se si seleziona Richiedi autenticazione, immettere le credenziali per un account che ha diritto all'agente nella finestra di dialogo visualizzata.
  8. Rivedere i dettagli dell'agente per verificarne l'accuratezza, quindi fare clic su Registra.

Registra un server MCP nel registro AI

Un server MCP espone un set di strumenti che gli agenti possono individuare e chiamare tramite un'interfaccia standard. La registrazione di uno nel registro AI rende questi strumenti disponibili nella piattaforma.

Nota

Se il server MCP richiede l'autenticazione, è necessario prima creare le credenziali OAuth nel registro AI. Impossibile aggiungere le credenziali nell'ambito della registrazione di un server MCP.
  1. Nella home page, fare clic su Icona Registro AIRegistro AI.
  2. Fare clic su Registra, quindi su Server MCP.
  3. Immettere l'URL dell'endpoint del server MCP.
  4. Immettere un nome visualizzato e una descrizione utili. Gli utenti e gli agenti li utilizzeranno per identificare lo scopo del server MCP.
  5. Dal menu a discesa, selezionare il metodo Transport.
  6. Facoltativo: se il server MCP richiede credenziali sicure, selezionare Richiedi autenticazione. Selezionare le credenziali dal menu a discesa Credenziali.
  7. Fare clic su Continua.
  8. Esaminare l'elenco degli strumenti inclusi per il server MCP selezionato. Selezionare gli strumenti che si desidera includere singolarmente o fare clic su Seleziona tutto per includere tutti gli strumenti elencati.
  9. Fare clic su Registra.