Condividi tramite

Connettere gli agenti ai dati strutturati

Gli agenti di intelligenza artificiale spesso devono eseguire query o modificare dati strutturati per rispondere a domande, aggiornare i record o creare pipeline di dati.

Databricks offre diversi approcci per la connessione degli agenti ai dati strutturati nelle tabelle di Unity Catalog e negli archivi dati esterni. Usare server MCP preconfigurato per l'accesso immediato agli spazi Genie e ai warehouse SQL oppure creare strumenti personalizzati per flussi di lavoro specializzati.

Questa pagina illustra come:

Eseguire query sui dati nelle tabelle di Unity Catalog

Se l'agente deve eseguire query sui dati nelle tabelle di Unity Catalog, Databricks consiglia di usare spazi Genie. Uno spazio Genie è una raccolta di un massimo di 25 tabelle del catalogo Unity che Genie può mantenere nel contesto ed eseguire query usando il linguaggio naturale. Gli agenti possono accedere allo spazio Genie usando un URL MCP preconfigurato.

Per connettersi a uno spazio Genie:

  1. Creare uno spazio Genie con le tabelle su cui eseguire query e condividere lo spazio con gli utenti o le entità servizio che devono accedervi. Vedere Configurare e gestire uno spazio di intelligenza artificiale/BI Genie.
  2. Creare un agente e connetterlo all'URL MCP gestito preconfigurato per lo spazio: https://<workspace-hostname>/api/2.0/mcp/genie/{genie_space_id}.

Per informazioni su come creare un agente che si connette ai server MCP gestiti, vedere Usare i server MCP gestiti di Databricks.

Annotazioni

Il server MCP gestito per Genie richiama Genie come strumento MCP, il che significa che la cronologia non viene passata quando si richiamano le API Genie.

Sistema multi-agente Genie

Importante

Questa funzionalità è in Anteprima Pubblica.

Per i sistemi avanzati multi-agente, è anche possibile usare Genie come agente anziché integrarlo tramite MCP. Quando si invoca Genie come agente, è possibile passare in modo deterministico il contesto di conversazione esistente a Genie.

Per un approccio code-first, vedere Utilizzare Genie nei sistemi multi-agente (Model Serving). Per un approccio basato sull'interfaccia utente, vedere Usare Agent Brick: Supervisor Agent per creare un sistema multi-agente coordinato.

Eseguire query sui dati usando lo strumento per funzioni SQL del Catalogo Unity

Creare uno strumento di recupero strutturato usando le funzioni SQL del catalogo unity quando la query è nota in anticipo e l'agente fornisce i parametri.

L'esempio seguente crea una funzione di Catalogo Unity denominata lookup_customer_info, che consente a un agente di intelligenza artificiale di recuperare dati strutturati da una tabella ipotetica customer_data .

Eseguire il codice seguente in un editor SQL.

CREATE OR REPLACE FUNCTION main.default.lookup_customer_info(
  customer_name STRING COMMENT 'Name of the customer whose info to look up'
)
RETURNS STRING
COMMENT 'Returns metadata about a particular customer, given the customer's name, including the customer's email and ID. The
customer ID can be used for other queries.'
RETURN SELECT CONCAT(
    'Customer ID: ', customer_id, ', ',
    'Customer Email: ', customer_email
  )
  FROM main.default.customer_data
  WHERE customer_name = customer_name
  LIMIT 1;

Dopo aver creato uno strumento di Unity Catalog, puoi aggiungerlo al tuo agente. Consulta Creare uno strumento agente.

  • Last updated on