AI-Agent für Python auswählen

Mit dem Untermodul select_ai.agent können Sie datenbankinterne KI-Agent-Tools, -Aufgaben, -Agents und -Teams aus Python erstellen und verwalten.

Wählen Sie AI-Agent für Python-Builds in der select_ai-Clientbibliothek und dem Package DBMS_CLOUD_AI_AGENT aus. Es unterstützt synchrone und asynchrone Agent-Workflows in einer autonomen KI-Datenbank.

Unterstützte Plattformen

Informationen zu unterstützter Select AI für Python-Plattformen finden Sie unter Unterstützte Plattformen.

Melden Sie Produktprobleme im Select AI for Python GitHub-Repository.

Select AI Agent für Python installieren

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

python3 -m pip install select_ai

Wählen Sie AI-Agent-Klassen aus, die im Untermodul select_ai.agent enthalten sind.

Datenbankberechtigungen verwalten

Die Option "AI-Agent für Python auswählen" erfordert Zugriff auf das Datenbankpackage DBMS_CLOUD_AI_AGENT. Mit den folgenden APIs können Sie Datenbankpackageberechtigungen erteilen oder entziehen:

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

Informationen zu Berechtigungen, HTTP-Zugriff und Netzwerkzugriffsverwaltung für externe Hosts finden Sie unter Datenbankberechtigungen und Netzwerkzugriff verwalten.

Aufgaben, die sie ausführen können

In der folgenden Tabelle werden die primären Select AI Agent for Python-Funktionen zusammengefasst:

Fähigkeit Beschreibung
Werkzeuge Erstellen und verwalten Sie Tools für Natural Language-to-SQL, Websuche, Retrieval-Augmented Generation, PL/SQL, Benachrichtigungen und benutzerdefinierte Funktionen.
Aufgaben Auf dieser Seite definieren Sie die Aufgabenlogik und konfigurieren die Tools, die für eine Aufgabe verwendet werden.
Agents Weisen Sie Agentenrollen und KI-Profile zu.
Teams Multi-Agent-Teams programmgesteuert zusammenstellen und ausführen.
Teamexport und -import Agent-Teamspezifikationen synchron oder asynchron exportieren oder importieren
Synchrone und asynchrone APIs Verwenden Sie synchrone APIs oder Python-Konstrukte async und await basierend auf den Anwendungsanforderungen.
Objektlebenszyklusmanagement Agent-Objekte mit Datenbankbackup abrufen, aktualisieren und löschen.

Unterstützte Klassen

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

Klasse oder Klassengruppe Zweck
Tool und AsyncTool Erstellen und verwalten Sie KI-Agent-Tools.
Task und AsyncTask Erstellen und verwalten Sie die Aufgabenlogik und die Verwendung von Tools.
Agent und AsyncAgent Erstellen und verwalten Sie Agents, ihre Rollen, Profile und Aufgaben.
Team und AsyncTeam Multi-Agent-Teams erstellen, ausführen, exportieren und importieren.

Mit Tools arbeiten

Verwenden Sie Tools, um Funktionen bereitzustellen, die ein Agent bei der Verarbeitung einer Aufgabe aufrufen kann. Sie können SQL, Websuche, Retrieval-Augmented Generation, PL/SQL, Slack-Benachrichtigung und E-Mail-Benachrichtigungstools erstellen.

APIs für die Toolerstellung unterstützen den Parameter instruction. Verwenden Sie diesen Parameter, um ein präzises Toolausführungsverhalten zu definieren.

Web-Such- und Benachrichtigungstools erfordern Zugangsdaten und Netzwerkzugriff für den externen Service. SQL- und RAG-Tools erfordern vorhandene Select AI-Profile.

Mit Aufgaben arbeiten

Verwenden Sie Aufgaben, um die von einem Agent ausgeführte Arbeit und die Tools zu definieren, die der Agent verwenden kann. Konfigurieren Sie die Attribute instruction und tools, um zu steuern, wie der Agent Anforderungen verarbeitet.

Sie können das optionale Attribut input verwenden, um eine Aufgabe von der Ausgabe einer früheren Aufgabe abhängig zu machen.

Mit Agents arbeiten

Verwenden Sie Agents, um eine Rolle und ein KI-Profil zuzuordnen. Das Profil stellt das Modell bereit, das der Agent für Planung und Argumentation verwendet, während die Rolle das beabsichtigte Verhalten des Agents definiert.

Mitarbeiterteams verwalten

Verwenden Sie Teams, um mehrere Agents programmgesteuert zusammenzustellen und auszuführen. Ein Team koppelt Agents mit Aufgaben und unterstützt Agent-Workflows, in denen spezialisierte Agents eine Anforderung koordinieren.

Setzen Sie das Attribut process des Teams auf sequential, um Aufgabenzuweisungen in der richtigen Reihenfolge auszuführen. Verwenden Sie einen Agent in mehreren Teameinträgen wieder, wenn dieser Agent mehrere Aufgaben ausführen muss.

Mit Team.run(...) können Sie einen Teamworkflow starten. Das Argument prompt wird an die Aufgabe übergeben und kann in Aufgabenanweisungen mit {query} referenziert werden.

Agent-Teams exportieren und importieren

Select AI for Python 1.4 fügt synchrone und asynchrone APIs hinzu, um KI-Agent-Teams zu exportieren und zu importieren. Eine Teamspezifikation umfasst die Teamzusammensetzung und die zugehörigen Agent-, Aufgaben- und Tooldefinitionen.

Synchrone APIs:

Team.export_team(...)
Team.import_team(...)

Asynchrone APIs:

AsyncTeam.export_team(...)
AsyncTeam.import_team(...)

Team.export_team() gibt standardmäßig eine JSON-Spezifikation zurück. Team.import_team() akzeptiert diese JSON-Spezifikation oder ein Python-Mapping mit der Teamdefinition. Geben Sie team_name an, um ein Team unter einem neuen Namen zu importieren.

Um eine Spezifikation in den Objektspeicher zu schreiben oder aus dem Objektspeicher zu importieren, geben Sie object_storage_credential_name und location an. Legen Sie force=True fest, um widersprüchliche Tools, Aufgaben, Agents oder Teams beim Import zu ersetzen.

Die vollständigen Release-Details finden Sie unter python-select-ai v1.4.0.

Vorhandene Objekte abrufen und aktualisieren

Select AI Agent 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 Tools, Aufgaben, Agents, Teams 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.

Agent.delete_agent(agent_name)
Task.delete_task(task_name)
Tool.delete_tool(tool_name)
Team.delete_team(team_name)

Synchrone und asynchrone APIs verwenden

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

In der folgenden Tabelle werden synchrone Klassen ihren asynchronen Entsprechungen zugeordnet:

Synchrone Klasse Asynchrones Äquivalent
Tool AsyncTool
Task AsyncTask
Agent AsyncAgent
Team AsyncTeam

Asynchrone APIs in Anwendungen verwenden, die:

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

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

Zugehörige Ressourcen