AI für Python auswählen

Mit der select_ai-Clientbibliothek können Sie von Python-Anwendungen aus auf DBMS_CLOUD_AI-Funktionen in der autonomen KI-Datenbank zugreifen.

Select AI for Python generiert SQL aus Eingabeaufforderungen in natürlicher Sprache, führt generierte SQL aus und erklärt sie, verwaltet kontextbezogene Unterhaltungen, fasst Inhalte zusammen und übersetzt sie, generiert synthetische Daten und erstellt Retrieval-Augmented Generation-(RAG-)Workflows.

Select AI for Python unterstützt auch gestreamte Textantworten, synchrone und asynchrone Programmierung, Netzwerkzugriffsverwaltung für externe Hosts, Connection Pooling und eine optionale Befehlszeilenschnittstelle.

Unterstützte Plattformen

Select AI for Python ist für Autonomous AI Database 26ai und 19c zertifiziert. Andere Plattformen funktionieren möglicherweise mit der Bibliothek, sind jedoch nicht zertifiziert.

Melden Sie Produktprobleme im GitHub-Repository für python-select-ai.

Select AI für Python installieren

Installieren Sie das Package "Select AI for Python" mit pip:

python3 -m pip install select_ai

Um die optionalen Abhängigkeiten der Befehlszeilenschnittstelle zu installieren, verwenden Sie:

python3 -m pip install 'select_ai[cli]'

Select AI for Python unterstützt Python 3.11, 3.12, 3.13 und 3.14.

Datenbankberechtigungen und Netzwerkzugriff verwalten

Select AI for Python trennt Datenbankpackageberechtigungen, HTTP-Zugriff und externen Hostnetzwerkzugriff.

Datenbankpaketberechtigungen

Mit den folgenden APIs können Sie Datenbankpackageberechtigungen erteilen oder entziehen:

select_ai.grant_privileges(...)
select_ai.revoke_privileges(...)

Diese APIs unterstützen die folgenden Datenbankpaketberechtigungen:

  • DBMS_CLOUD
  • DBMS_CLOUD_AI
  • DBMS_CLOUD_AI_AGENT
  • DBMS_CLOUD_PIPELINE

HTTP-Zugriff

Verwenden Sie die folgenden APIs, um den HTTP-Zugriff zu verwalten:

select_ai.grant_http_access(...)
select_ai.revoke_http_access(...)

Netzwerkzugriff auf externen Host

Mit den Netzwerkzugriffs-APIs können Sie Hostzugriffslisteneinträge für externe Hosts verwalten. Geben Sie den Host, die erforderlichen Berechtigungen und einen optionalen Portbereich an.

Synchrone APIs:

select_ai.grant_network_access(...)
select_ai.revoke_network_access(...)

Asynchrone APIs:

await select_ai.async_grant_network_access(...)
await select_ai.async_revoke_network_access(...)

Aufgaben, die sie ausführen können

In der folgenden Tabelle werden die primären Select AI-Funktionen für Python zusammengefasst:

Fähigkeit Beschreibung
Natural Language-to-SQL SQL aus Eingabeaufforderungen in natürlicher Sprache generieren, generiertes SQL ausführen, SQL erklären und Abfrageergebnisse in natürlicher Sprache beschreiben
Retrieval-Augmented Generation Erstellen und verwalten Sie Vektorindizes, die relevanten Inhalt für generative KI-Antworten abrufen.
Unterhaltungen Verwalten Sie die Prompt-Historie und den Konversationskontext für alle zugehörigen Anforderungen.
KI-Profile Konfigurieren Sie KI-Provider, Zugangsdaten, Modellparameter, Datenbankobjekte und Vektorindizes.
Synthetische Daten Generieren Sie synthetische Daten basierend auf angegebenen Attributen.
Zusammenfassung Ergebnisse von Text- oder Datenbankabfragen zusammenfassen
Übersetzung Text aus einer Ausgangssprache in eine Zielsprache übersetzen
Feedback Positives oder negatives Feedback für generiertes SQL erfassen und vorhandenes Feedback entfernen.
Synchrone und asynchrone APIs Verwenden Sie synchrone APIs oder Python-Konstrukte async und await basierend auf den Anwendungsanforderungen.
Verbindungspooling Erstellen Sie gemeinsame synchrone oder asynchrone Connection Pools für gleichzeitige Anwendungen.
Streamingantworten Generierten CLOB-Text in konfigurierbaren Blöcken von unterstützten Profilmethoden empfangen.
Befehlszeilenschnittstelle Mit Chats, SQL-Vorgängen, Profilen, Zusammenfassungen und Übersetzungen von einem Terminal arbeiten
Netzwerkzugriff auf externen Host Erteilen oder widerrufen Sie den Zugriff auf externe Hosts mit synchronen oder asynchronen APIs.
KI-Agents Agent-spezifische Klassen und Vorgänge finden Sie unter AI-Agent für Python auswählen.

Unterstützte Klassen

In der folgenden Tabelle werden die primären Select AI-Klassen für Python zusammengefasst:

Klasse oder Klassengruppe Zweck
Bereitstellerklassen Definieren Sie den AI-Provider, der einem Profil zugeordnet ist.
Profile und AsyncProfile Erstellen und verwalten Sie KI-Profile und Prozess-Prompts.
ProfileAttributes Definieren Sie Profileinstellungen wie Provider, Zugangsdaten, maximale Token, Temperatur, Objektliste und Vektorindex.
Conversation und AsyncConversation Erstellen und verwalten Sie kontextbezogene Unterhaltungen.
ConversationAttributes Konversationseinstellungen und -kontext festlegen
VectorIndex und AsyncVectorIndex Erstellen und verwalten Sie Vektorindizes für RAG.
VectorIndexAttributes Definieren Sie Vektorindexeinstellungen. Verwenden Sie für einen Vektorindex mit einer geplanten Aktualisierung vector_index.get_next_refresh_timestamp(), um den UTC-Zeitstempel der nächsten Aktualisierung abzurufen.
SyntheticDataAttributes Einstellungen für die Generierung synthetischer Daten definieren

Bereitstellerklassen

"AI für Python auswählen" enthält die folgenden Providerklassen:

  • OpenAIProvider
  • AzureProvider
  • OCIGenAIProvider
  • AWSProvider
  • GoogleProvider
  • AnthropicProvider
  • CohereProvider
  • HuggingFaceProvider

Providerspezifische Attribute und unterstützte Parameter finden Sie in der AI für Python-API-Referenz auswählen.

Mit KI-Profilen arbeiten

Ein AI-Profil verbindet eine Python-Anwendung mit einem AI-Provider und definiert, wie Select AI-Prozesse Prompts ausführen. Ein Profil kann Providerinformationen, Zugangsdaten, Modelleinstellungen, Datenbankobjekte und Vektorindizes enthalten.

Select AI for Python stellt synchrone und asynchrone Profilklassen bereit:

Wird verarbeitet Class
Synchron Profile
Asynchron AsyncProfile

Verwenden Sie ein synchrones Profil in Anwendungen, die jeweils einen Vorgang verarbeiten. Verwenden Sie ein asynchrones Profil in Anwendungen, die Hintergrundprozesse verarbeiten oder eine Ereignisschleife verwenden.

In der folgenden Tabelle werden häufig verwendete Profilfunktionen beschrieben:

Funktion Beschreibung
create() Erstellt ein AI-Profil in der Datenbank oder ersetzt ein vorhandenes Profil. Siehe create() GitHub-Dokumentation.
delete() Entfernt ein AI-Profil. Siehe delete() GitHub-Dokumentation.
fetch() Ruft ein vorhandenes Profil aus der Datenbank ab.
get_attributes() Gibt die aktuellen Profilattribute zurück. Weitere Informationen finden Sie in der GitHub-Dokumentation get_attributes().
set_attribute() Aktualisiert ein Profilattribut.
set_attributes() Aktualisiert mehrere Profilattribute.
generate() Verarbeitet einen Prompt basierend auf der angegebenen Aktion. Siehe generate() GitHub-Dokumentation.
run_sql() Generiert und führt SQL aus. Das ist die Standardaktion. Weitere Informationen finden Sie in der GitHub-Dokumentation run_sql().
show_sql() Generiert SQL, ohne es auszuführen. Siehe GitHub-Dokumentation zu show_sql().
explain_sql() Erläutert generiertes SQL. Weitere Informationen finden Sie in der GitHub-Dokumentation zu explain_sql().
narrate() Beschreibt Abfrageergebnisse in natürlicher Sprache. Siehe narrate() GitHub-Dokumentation.
chat() Sendet einen Freiform-Prompt an das generative KI-Modell. Weitere Informationen finden Sie in der Chat() GitHub-Dokumentation.
show_prompt() Gibt den konstruierten Prompt zurück, der an das generative KI-Modell gesendet wird. Siehe GitHub-Dokumentation zu show_prompt().
summarize() Fasst den bereitgestellten Inhalt zusammen. Weitere Informationen finden Sie in der GitHub-Dokumentation zu summarize().
translate() Übersetzt Text aus einer Ausgangssprache in eine Zielsprache. Weitere Informationen finden Sie in der GitHub-Dokumentation zu translate().
generate_synthetic_data() Generiert synthetische Daten auf Basis der angegebenen Attribute. Weitere Informationen finden Sie in der GitHub-Dokumentation generate_synthetic_data().
add_positive_feedback() Erfasst positives Feedback für generiertes SQL. Weitere Informationen finden Sie in der GitHub-Dokumentation add_positive_feedback().
add_negative_feedback() Erfasst negatives Feedback für generiertes SQL. Weitere Informationen finden Sie in der GitHub-Dokumentation add_negative_feedback().
delete_feedback() Entfernt zuvor aufgezeichnetes Feedback. Weitere Informationen finden Sie in der GitHub-Dokumentation zu delete_feedback().

Eine vollständige Liste der Methoden und Parameter finden Sie unter AI für Python-API-Referenz auswählen.

Informationen zu Select AI-Aktionen finden Sie auch unter AI-Schlüsselwort zum Eingeben von Prompts verwenden.

Profilantworten streamen

Verwenden Sie Streaming, wenn eine Anwendung generierten Text verarbeiten muss, sobald er verfügbar ist, anstatt auf die vollständige CLOB-Antwort zu warten.

Die Klassen Profile und AsyncProfile unterstützen das Streaming über die folgenden Parameter:

Parameter Beschreibung
stream=True Gibt generierten Text als Stream zurück.
chunk_size Legt die Menge an generiertem Text fest, der in jedem Chunk zurückgegeben wird.

Streaming wird für die folgenden Profilmethoden unterstützt:

Methode Streaming-Unterstützung
chat() Ja
narrate() Ja
explain_sql() Ja
show_sql() Ja
show_prompt() Ja
run_sql() Nein

Die Methode run_sql() gibt ein Datenbankergebnis zurück und unterstützt kein Streaming.

Mit Unterhaltungen verwalten

Verwenden Sie Unterhaltungen, um Kontext über zugehörige Prompts hinweg zu verwalten. Eine Konversation speichert die Eingabeaufforderungshistorie, sodass spätere Anfragen auf Informationen aus früheren Anfragen verweisen können.

Select AI for Python bietet synchrone und asynchrone Unterhaltungsklassen:

Wird verarbeitet Class
Synchron Conversation
Asynchron AsyncConversation

Mit ConversationAttributes können Sie Unterhaltungseinstellungen definieren.

Verwenden Sie eine Unterhaltung, wenn eine Anwendung einen kontextbezogenen Chat oder eine Folge zugehöriger Anforderungen in natürlicher Sprache erfordert. Verwenden Sie ein Profil direkt, wenn jede Anforderung unabhängig ist.

Mit Vektorindizes arbeiten

Verwenden Sie einen Vektorindex, um Retrieval-Augmented Generation zu unterstützen. Ein Vektorindex ruft relevanten Inhalt ab und fügt diesen Inhalt zu einem Prompt hinzu, bevor das generative KI-Modell eine Antwort generiert.

"AI für Python auswählen" stellt die folgenden Vektorindexklassen bereit:

Wird verarbeitet Class
Synchron VectorIndex
Asynchron AsyncVectorIndex

Verwenden Sie VectorIndexAttributes, um die Vektorindexkonfiguration zu definieren.

Die Methode VectorIndex.create() unterstützt den Parameter wait_for_completion. Legen Sie diesen Parameter fest, um zu steuern, ob die Methode wartet, bis die Erstellung des Vektorindex beendet ist, bevor sie zurückgegeben wird.

Verwenden Sie vector_index.get_next_refresh_timestamp(), um den UTC-Zeitstempel der nächsten geplanten Aktualisierung abzurufen.

Details zur Datenbank finden Sie unter Prozedur CREATE_VECTOR_INDEX.

Synthetische Daten generieren

Verwenden Sie generate_synthetic_data(), um synthetische Daten basierend auf den angegebenen Attributen zu generieren.

Mit SyntheticDataAttributes können Sie Einstellungen für synthetische Daten definieren. Diese Einstellungen beschreiben die zu generierenden Daten und die Parameter, die vom generativen KI-Modell verwendet werden.

Synthetische Daten können Entwicklung, Demonstrationen und andere Szenarien unterstützen, die repräsentative Daten erfordern, ohne Produktionsdatensätze zu verwenden.

Vorhandene Objekte abrufen und aktualisieren

Select AI for Python bietet konsistente Methoden zum Abrufen und Aktualisieren von datenbankgestützten Proxyobjekten:

Methode Zweck
fetch() Ruft ein vorhandenes Datenbankobjekt ab und gibt das entsprechende Proxyobjekt zurück.
set_attribute() Aktualisiert ein Attribut in einem Proxyobjekt.
set_attributes() Aktualisiert mehrere Attribute für ein Proxyobjekt.

Diese Methoden bieten eine konsistente Möglichkeit, mit Profilen, Unterhaltungen, Vektorindizes und anderen unterstützten Proxyobjekten zu arbeiten.

Objekte mit Klassenmethoden löschen

Verwenden Sie Löschmethoden auf Klassenebene, wenn eine Anwendung ein Objekt löschen muss, ohne zuvor ein Proxyobjekt zu erstellen oder abzurufen.

Profile.delete_profile(profile_name)
VectorIndex.delete_index(index_name)

Synchrone und asynchrone APIs verwenden

Select AI for Python stellt synchrone und asynchrone APIs für seine primären Vorgänge bereit.

In der folgenden Tabelle werden synchrone Klassen und Vorgänge ihren asynchronen Entsprechungen zugeordnet:

Synchrone Klasse oder Operation Asynchrones Äquivalent
Profile AsyncProfile
Conversation AsyncConversation
VectorIndex AsyncVectorIndex
select_ai.create_pool() select_ai.create_pool_async()
select_ai.grant_network_access() select_ai.async_grant_network_access()
select_ai.revoke_network_access() select_ai.async_revoke_network_access()

Asynchrone APIs in Anwendungen verwenden, die:

  • Mehrere Prompts gleichzeitig verarbeiten
  • Ereignisschleife verwenden
  • Integration mit asynchronen Python-Frameworks.
  • Blockierung muss beim Warten auf Datenbankvorgänge vermieden werden.

Verwenden Sie select_ai.create_pool_async(), um einen gemeinsamen Verbindungspool für asynchrone Workflows zu erstellen.

AsyncProfile unterstützt Streaming von denselben unterstützten Textmethoden wie Profile. Legen Sie stream=True fest, und geben Sie bei Bedarf chunk_size an.

Die vollständige asynchrone API-Referenz finden Sie unter AI für Python-API-Referenz auswählen.

Verbindungspools verwalten

Verwenden Sie einen Connection Pool, wenn eine Anwendung wiederholte oder gleichzeitige Datenbankanforderungen verarbeitet.

Select AI for Python stellt die folgenden Poolerstellungsfunktionen bereit:

Wird verarbeitet Funktion
Synchron select_ai.create_pool()
Asynchron select_ai.create_pool_async()

Ein Shared Pool reduziert die Notwendigkeit, für jeden Prozess eine neue Datenbankverbindung zu erstellen, und unterstützt gleichzeitige Anwendungs-Workloads.

Befehlszeilenschnittstelle verwenden

Die optionale select-ai-Befehlszeilenschnittstelle bietet Terminalzugriff auf allgemeine Select AI-Vorgänge.

Installieren Sie die CLI-Abhängigkeiten:

python3 -m pip install 'select_ai[cli]'

Führen Sie die Befehlszeilenschnittstelle aus:

select-ai

In der folgenden Tabelle werden die unterstützten Befehle zusammengefasst:

Befehl Zweck
select-ai chat Startet eine interaktive, kontextbezogene Chatsession.
select-ai sql show Generiert und zeigt SQL an, ohne es auszuführen.
select-ai sql run Generiert und führt SQL aus.
select-ai sql explain Erläutert generiertes SQL.
select-ai sql narrate Beschreibt Abfrageergebnisse in natürlicher Sprache.
select-ai profile list Listet AI-Profile auf.
select-ai profile summarize Fasst Inhalt mit einem AI-Profil zusammen.
select-ai profile translate Übersetzt Inhalte mit einem KI-Profil.

Geben Sie Datenbankverbindungswerte als Befehlsoptionen an, oder definieren Sie die folgenden Umgebungsvariablen:

Umgebungsvariable Beschreibung
SELECT_AI_USER Gibt den Datenbankbenutzernamen an.
SELECT_AI_PASSWORD Gibt das Datenbankpasswort an.
SELECT_AI_DB_CONNECT_STRING Gibt die Datenbank-Verbindungszeichenfolge an.

AI-Agent für Python auswählen

Informationen zu Select AI Agent-spezifischen Klassen, Toolvorgängen, instruction-Parametern und Löschmethoden auf Klassenebene finden Sie unter AI-Agent für Python auswählen.

Zugehörige Ressourcen