Strumenti dell'agente di intelligenza artificiale

Articolo
02/01/2025

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Questo articolo offre una panoramica della creazione di strumenti dell'agente di intelligenza artificiale con Mosaic AI Agent Framework.

Gli strumenti dell'agente di intelligenza artificiale consentono agli agenti di eseguire attività oltre la generazione del linguaggio, ad esempio il recupero di dati strutturati o non strutturati e l'esecuzione di codice personalizzato.

Per un'introduzione agli agenti di intelligenza artificiale, vedere Che cosa sono i sistemi di intelligenza artificiale composti e gli agenti di intelligenza artificiale?.

strumenti per le funzioni del catalogo Unity e strumenti di codice dell'agente

Per creare uno strumento con Mosaic AI Agent Framework, è possibile usare qualsiasi combinazione dei metodi seguenti:

Metodo	Descrizione
funzioni del catalogo Unity	- Definito e gestito nel catalogo unity con funzionalità di sicurezza e conformità predefinite - Facilita l'individuazione, la governance e il riutilizzo - Ideale per l'applicazione di trasformazioni e aggregazioni in set di dati di grandi dimensioni
Strumenti di codice di Agent	- Definito nel codice dell'agente di intelligenza artificiale - Utile per chiamare le API REST, usare codice arbitrario o eseguire strumenti a bassa latenza - Manca la governance predefinita e l'individuabilità delle funzioni

Entrambi i metodi sono compatibili con agenti Python personalizzati o librerie di creazione di agenti come LangGraph.

Creare gli strumenti dell'agente di intelligenza artificiale

Informazioni su come creare gli strumenti dell'agente di intelligenza artificiale che consentono agli agenti di eseguire codice Python personalizzato. Consulta le funzioni del Catalogo Unity per creare strumenti dell'agente di intelligenza artificiale personalizzati.

esempi di strumenti Agent

Per esempi di strumenti dell'agente, vedere gli articoli seguenti:

Strumenti di recupero dati strutturati consentono all'agente di interrogare origini dati strutturate come tabelle SQL.
strumenti di recupero dati non strutturati consentire all'agente di eseguire query su origini dati non strutturate come un corpore di testo per eseguire la generazione aumentata del recupero.
strumenti di connessione esterna connettere gli strumenti dell'agente a servizi e API esterni.

Aggiungere strumenti del catalogo Unity agli agenti

A differenza degli strumenti di codice dell'agente, definiti nel codice dell'agente, gli strumenti del catalogo Unity devono essere aggiunti in modo esplicito agli agenti per renderli disponibili per l'uso.

Databricks consiglia di usare UCFunctionToolkit per integrare gli strumenti di Catalogo Unity con framework di creazione di agenti e SDK. Consulta le funzioni del Catalogo Unity per creare strumenti dell'agente di intelligenza artificiale personalizzati.

È anche possibile usare AI Playground per aggiungere rapidamente gli strumenti del catalogo Unity agli agenti per creare prototipi di comportamento. Consulta Prototype tool-calling agents nel AI Playground.

Migliorare la chiamata agli strumenti con documentazione chiara

Gli strumenti ben documentati consentono agli agenti di intelligenza artificiale di comprendere quando e come usare gli strumenti in modo efficace. Per documentare i parametri degli strumenti e restituire i valori, seguire queste procedure consigliate:

Per le funzioni del catalogo unity, usare COMMENT per descrivere le funzionalità e i parametri degli strumenti.
Definire chiaramente gli input e gli output previsti.
Fornire descrizioni significative per migliorare l'usabilità.

Esempio: Documentazione efficace degli strumenti

L'esempio seguente mostra stringhe di COMMENT valide per uno strumento funzione catalogo Unity che esegue query su una tabella strutturata.

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 specific customer including their email and ID.'
RETURN SELECT CONCAT(
    'Customer ID: ', customer_id, ', ',
    'Customer Email: ', customer_email
  )
  FROM main.default.customer_data
  WHERE customer_name = customer_name
  LIMIT 1;

Esempio: Documentazione dello strumento inefficace

L'esempio seguente non contiene dettagli importanti, rendendo più difficile l'uso efficace dello strumento da parte dell'agente di intelligenza artificiale:

CREATE OR REPLACE FUNCTION main.default.lookup_customer_info(
  customer_name STRING COMMENT 'Name of the customer.'
)
RETURNS STRING
COMMENT 'Returns info about a customer.'
RETURN SELECT CONCAT(
    'Customer ID: ', customer_id, ', ',
    'Customer Email: ', customer_email
  )
  FROM main.default.customer_data
  WHERE customer_name = customer_name
  LIMIT 1;

Condividi tramite