Documentazione dell'infrastruttura Oracle Cloud

Seleziona AI per Python

Select AI for Python integra funzionalità di intelligenza artificiale generativa nei flussi di lavoro di Autonomous AI Database. Select AI for Python fornisce una libreria client, select_ai, che consente di utilizzare le funzionalità DBMS_CLOUD_AI in Autonomous AI Database di Python. Select AI for Python supporta flussi di lavoro di intelligenza artificiale generativa avanzati, riepilogo, meccanismi di feedback, gestione coerente dei metadati e funzionalità di intelligenza artificiale autentica. Supporta anche Python 3.14 e include un sito di documentazione HTML aggiornato (Nuovo)

Azioni che è possibile eseguire

  • Connessione al database mediante connessioni sincrone o asincrone

  • Crea e gestisci profili AI per abilitare l'utilizzo di modelli AI da una vasta gamma di provider AI

  • Utilizza il linguaggio naturale per eseguire query sul database tramite la generazione SQL basata sull'intelligenza artificiale

  • Descrivere i risultati delle query nel linguaggio naturale

  • Crea e gestisci conversazioni con la cronologia dei prompt

  • Crea e aggiorna facilmente gli indici vettoriali da utilizzare con flussi di lavoro RAG (Retrieval Augmented Generation) integrati e automatizzati

  • Genera dati sintetici per test e analisi utilizzando l'intelligenza artificiale generativa

  • Riepiloga il testo o i risultati della query

  • Registrare e gestire il feedback del modello

  • Crea agenti AI autonomi e di interazione. Per informazioni dettagliate, vedere Select AI Agent for Python.

Piattaforme supportate

Select AI for Python è certificato per Autonomous Database 19c e Autonomous AI Database 26ai. Selezionare AI per Python può funzionare su altre piattaforme, tuttavia non è certificato.

Fare clic su https://github.com/oracle/python-select-ai/issues per segnalare i problemi.

Funzioni supportate per il profilo AI selezionato (sincrono e asincrono)

Quando si inviano prompt tramite un profilo, è possibile scegliere tra diverse funzioni definite per gli oggetti profilo AI. Alcuni sono i seguenti:

  • create(): creare il profilo AI nel database o sostituirlo, se necessario.

  • delete(): rimuove il profilo.

  • generate(): utilizzare il profilo per elaborare un prompt in base all'azione scelta.

  • generate_synthetic_data(): consente di creare dati sintetici in base agli attributi forniti.

  • get_attributes(): restituisce gli attributi del profilo corrente.

  • run_sql(): genera ed esegue SQL (impostazione predefinita).

  • show_sql(): genera SQL senza eseguirlo.

  • explain_sql(): fornire una spiegazione per l'istruzione SQL generata.

  • narrate(): descrivere i risultati delle query in linguaggio naturale.

  • chat(): partecipa a una conversazione in formato libero.

  • show_prompt(): visualizza il prompt costruito inviato al modello di intelligenza artificiale generativa.

  • summarize(): produrre un riepilogo per il contenuto fornito.

  • add_positive_feedback(), add_negative_feedback(), delete_feedback(): consente di gestire il feedback utente associato alle query generate.

Per un elenco completo delle funzioni, vedere la guida Select AI for Python. Per ulteriori informazioni sulle azioni Seleziona AI, vedere anche Usa parola chiave AI per immettere i prompt.

Classi supportate

La libreria include classi per la gestione di provider, profili, conversazioni, indici vettoriali e dati sintetici. Sono disponibili sia versioni sincrone che asincrone.

  • Classi provider: definire il provider AI: OpenAIProvider, AzureProvider, OCIGenAIProvider, AWSProvider, GoogleProvider, AnthropicProvider, CohereProvider, HuggingFaceProvider.

  • Profile: definisce il profilo AI generativa per elaborare i prompt (provider, credenziali, metadati, opzioni) e supporta la generazione di dati sintetici.

  • ProfileAttributes: dettagli di configurazione del profilo quali provider, nome credenziale, numero massimo di token, temperatura, elenco di oggetti o indice vettoriale.

  • ConversationAttributes: consente di gestire il contesto conversazionale tra i prompt.

  • VectorIndex e VectorIndexAttributes: consente di creare e gestire gli indici vettoriali per RAG.

  • SyntheticDataAttributes: crea set di dati sintetici per test e sviluppo.

Per le classi Profile, Conversation e VectorIndex esistono equivalenti asincroni.

Per un riferimento completo alle API, vedere la guida Select AI for Python.

Miglioramenti all'aggiornamento di API e attributi

Sono disponibili i seguenti miglioramenti:

  • Tutti gli oggetti proxy ora supportano fetch() per recuperare gli oggetti esistenti.

  • Tutti gli oggetti proxy forniscono set_attribute() e set_attributes() per aggiornamenti coerenti

Privilegio e accesso HTTP

La gestione dei privilegi è separata dalla configurazione dell'accesso HTTP.

API privilegi:

  • select_ai.grant_privileges
  • select_ai.revoke_privileges
I privilegi vengono aggiornati per includere quanto riportato di seguito.
  • DBMS_CLOUD
  • DBMS_CLOUD_AI
  • DBMS_CLOUD_AI_AGENT
  • DBMS_CLOUD_PIPELINE

API di accesso HTTP:

  • select_ai.grant_http_access
  • select_ai.revoke_http_access

Altri miglioramenti