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_aiUm 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_CLOUDDBMS_CLOUD_AIDBMS_CLOUD_AI_AGENTDBMS_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:
OpenAIProviderAzureProviderOCIGenAIProviderAWSProviderGoogleProviderAnthropicProviderCohereProviderHuggingFaceProvider
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-aiIn 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.