Documentation sur Oracle Cloud Infrastructure

Ensemble DBMS_CLOUD_AI_AGENT

Cet ensemble définit et gère les agents, les tâches, les outils et l'orchestration Select AI.

Voir aussi :

Rubrique parent : Informations de référence sur les ensembles fournis avec Autonomous AI Database

Sommaire des sous-programmes DBMS_CLOUD_AI_AGENT

Cette section décrit les sous-programmes DBMS_CLOUD_AI_AGENT de Select AI Agent fournis avec Autonomous AI Database.

Sous-programme Description

CREATE_AGENT Procédure

Cette procédure crée un agent.

Attributs CREATE_AGENT

Fournit des attributs pour la création d'un agent.

ENABLE_AGENT Procédure

Cette procédure permet à un agent.

DISABLE_AGENT Procédure

Cette procédure désactive un agent.

DROP_AGENT Procédure

Cette procédure supprime un agent existant.

CREATE_TASK Procédure

Cette procédure crée une tâche qu'un agent et une équipe d'agent peuvent inclure.

Attributs CREATE_TASK

Fournit des attributs pour la création d'une tâche d'agent.

ENABLE_TASK Procédure

Cette procédure active une tâche d'agent.

DISABLE_TASK Procédure

Cette procédure désactive une tâche d'agent.

DROP_TASK Procédure

Cette procédure supprime une tâche d'agent existante.

CREATE_TOOL Procédure

Cette procédure crée des outils personnalisés qu'un agent peut inclure.

Attributs CREATE_TOOL

Fournit des attributs pour la création d'outils.

ENABLE_TOOL Procédure

Cette procédure active un outil enregistré.

DISABLE_TOOL Procédure

Cette procédure désactive un outil enregistré.

DROP_TOOL Procédure

Cette procédure supprime un outil existant.

CREATE_TEAM Procédure

Cette procédure crée une équipe d'agent et inclut les agents et les tâches.

Attributs CREATE_TEAM

Fournit des attributs pour la création d'une équipe d'agent.

Fonction SET_TEAM

Cette procédure définit l'équipe de l'agent dans la session en cours.

Fonction GET_TEAM

Cette procédure retourne l'équipe d'agent définie dans la session courante.

Fonction CLEAR_TEAM

Cette procédure efface l'équipe d'agent définie dans la session courante.

Fonction RUN_TEAM

Cette procédure crée un nouvel agent ou en exécute un en pause.

ENABLE_TEAM Procédure

Cette procédure permet à une équipe d'agent.

DISABLE_TEAM Procédure

Cette procédure désactive une équipe d'agent.

DROP_TEAM Procédure

Cette procédure supprime une équipe d'agent existante.
  • Procédure CREATE_AGENT
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_AGENT pour enregistrer un nouvel agent AI dans le cadre Sélectionner un agent AI. Définissez l'identité de l'agent à l'aide de agent_name, configurez son comportement avec le paramètre d'attributs et fournissez éventuellement une description.
  • Attributs CREATE_AGENT
    Ces attributs définissent le rôle d'un agent et le nom du profil d'intelligence artificielle.
  • Procédure ENABLE_AGENT
    Cette procédure active l'agent IA spécifié par l'utilisateur. La procédure modifie le statut de l'agent d'intelligence artificielle à ENABLED.
  • Procédure DISABLE_AGENT
    Cette procédure désactive l'agent IA dans la base de données courante. Le statut de l'agent IA est modifié à DISABLED par cette procédure.
  • Procédure DROP_AGENT
    La procédure supprime un agent d'IA existant. Si l'agent n'existe pas, la procédure génère une erreur.
  • Procédure CREATE_TASK
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TASK pour définir une tâche qu'un agent Select AI peut inclure dans son processus de raisonnement. Chaque tâche a un nom unique et un jeu d'attributs qui spécifient le comportement de l'agent lors de la planification et de l'exécution de la tâche.
  • Attributs CREATE_TASK
    Ces attributs définissent les instructions et les outils de l'agent disponibles pour la tâche.
  • Procédure ENABLE_TASK
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TASK pour activer une tâche définie précédemment. Le statut de la tâche passe à ENABLED, ce qui permet à l'agent de l'utiliser lors du traitement.
  • Procédure DISABLE_TASK
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TASK pour désactiver une tâche dans la base de données courante. Le statut de la tâche passe à DISABLED, ce qui empêche l'agent de l'utiliser lors du traitement.
  • Procédure DROP_TASK
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TASK pour supprimer de la base de données une tâche définie précédemment. Si la tâche n'existe pas, vous pouvez supprimer l'erreur en réglant le paramètre force à TRUE.
  • Procédure CREATE_TOOL
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TOOL pour enregistrer un outil personnalisé qu'un agent peut utiliser lors du traitement des tâches. Chaque outil est identifié par un tool_name unique et comprend des attributs qui définissent son objectif, sa logique de mise en œuvre et ses métadonnées.
  • Attributs CREATE_TOOL
    Ces attributs fournissent une configuration d'outil à l'aide d'un objet JSON dans le paramètre des attributs. Chaque attribut configure la façon dont l'agent utilise l'outil lors du raisonnement.
  • Procédure ENABLE_TOOL
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TOOL pour activer un outil précédemment enregistré. Le statut de l'outil passe à ENABLED, ce qui permet à l'agent de l'utiliser pour les tâches.
  • Procédure DISABLE_TOOL
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TOOL pour désactiver un outil enregistré. Le statut de l'outil passe à DISABLED, ce qui empêche l'agent de l'utiliser dans les tâches.
  • Procédure DROP_TOOL
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TOOL pour supprimer un outil précédemment enregistré auprès de l'agent. Si la tâche n'existe pas, vous pouvez supprimer l'erreur en réglant le paramètre force à TRUE.
  • Procédure CREATE_TEAM
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TEAM pour définir une équipe d'agents IA qui travaillent ensemble pour accomplir des tâches. Vous spécifiez les agents et les tâches associées, ainsi que la façon dont les tâches doivent être traitées.
  • Attributs CREATE_TEAM
    Ces attributs fournissent la configuration de l'équipe d'agents d'IA. Chaque équipe dispose d'un team_name unique et utilise un jeu d'attributs pour définir sa structure et sa stratégie d'exécution.
  • Fonction SET_TEAM
    Utilisez DBMS_CLOUD_AI_AGENT.SET_TEAM pour spécifier l'équipe d'agent d'intelligence artificielle pour la session courante.
  • Fonction GET_TEAM
    Utilisez DBMS_CLOUD_AI_AGENT.GET_TEAM pour retourner l'équipe d'agent d'intelligence artificielle pour la session courante.
  • Fonction CLEAR_TEAM
    Utilisez DBMS_CLOUD_AI_AGENT.CLEAR_TEAM pour effacer l'équipe d'agent d'intelligence artificielle définie dans la session courante. Cette procédure ne laisse pas tomber l'équipe.
  • Fonction RUN_TEAM
    Utilisez DBMS_CLOUD_AI_AGENT.RUN_TEAM pour démarrer une nouvelle équipe d'agent IA ou reprendre une mise en pause en attente d'une entrée humaine. Si vous fournissez un ID processus existant et que le processus d'équipe associé est à l'état WAITING_FOR_HUMAN, la fonction reprend le flux de travail à l'aide de l'entrée que vous fournissez en tant que réponse humaine.
  • Procédure ENABLE_TEAM
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TEAM pour activer une équipe d'agent d'IA spécifiée par l'utilisateur. Le statut de l'équipe passe à ENABLED.
  • Procédure DISABLE_TEAM
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TEAM pour désactiver une équipe d'agent d'IA existante. Le statut de l'équipe passe à DISABLED.
  • Procédure DROP_TEAM
    Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TEAM pour supprimer une équipe d'agent d'IA créée précédemment.

Rubrique parent : Ensemble DBMS_CLOUD_AI_AGENT

CREATE_AGENT Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_AGENT pour enregistrer un nouvel agent AI dans le cadre Sélectionner un agent AI. Définissez l'identité de l'agent à l'aide de agent_name, configurez son comportement avec le paramètre d'attributs et fournissez éventuellement une description.

Syntaxe 

DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
     agent_name          IN  VARCHAR2,
     attributes          IN  CLOB,
     status              IN  VARCHAR2  DEFAULT NULL,
     description         IN  CLOB      DEFAULT NULL
  );

Paramètres

Paramètre Description

agent_name

Nom de l'agent d'intelligence artificielle. Le nom de l'agent doit respecter les règles d'attribution de nom de l'identificateur SQL Oracle. La longueur maximale du nom est de 125 caractères.

Il s'agit d'un paramètre obligatoire.

attributes

Attributs personnalisés pour l'agent d'intelligence artificielle. Voir Attributs CREATE_AGENT pour plus de détails.

status

Statut de l'agent.

La valeur par défaut est enabled.

description

Description spécifiée par l'utilisateur pour l'agent d'intelligence artificielle.

La valeur par défaut est NULL.

Exemple

L'exemple suivant crée un agent pour traiter les retours de produits client. Pour un exemple complet, voir Exemple : Créer un agent de retour de produit. 

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
    agent_name => 'CustomerAgent',
    attributes => '{
       "profile_name": "GOOGLE",
                       "role": "You are an experienced customer agent who deals with customers return request."
     }'
  );
END;
/  
 
PL/SQL procedure successfully completed.

Attributs CREATE_AGENT

Ces attributs définissent le rôle d'un agent et le nom du profil d'IA.

Attributs

Nom d'attribut Par défaut Description

profile_name

 -

Profil d'intelligence artificielle utilisé par l'agent pour envoyer une demande au GML.

Il s'agit d'un paramètre obligatoire.

role

-

Définir la fonction de l'agent et fournir un contexte à l'agent. Ceci est envoyé au GML.

Il s'agit d'un paramètre obligatoire.

enable_human_tool

True

Permettre à l'agent de poser des questions à l'utilisateur pour obtenir des informations ou des éclaircissements.

L'exemple suivant montre comment personnaliser les attributs d'agent dans la procédure.
BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
    agent_name => 'Customer_Return_Agent',
    attributes => '{
       "profile_name": "GOOGLE",
                       "role": "You are an experienced customer agent who deals with customers return request.",
			   "enable_human_tool": "False"
     }'
  );
END;
/  
 
PL/SQL procedure successfully completed

ENABLE_AGENT Procédure

Cette procédure active l'agent d'intelligence artificielle que l'utilisateur spécifie. La procédure modifie le statut de l'agent d'intelligence artificielle à ENABLED.

Syntaxe 

DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

agent_name

Nom de l'agent d'intelligence artificielle à activer.

Ce paramètre est obligatoire.

Exemple pour activer le profil d'intelligence artificielle

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
         agent_name    => 'Customer_Return_Agent'
     );
END;
/

DISABLE_AGENT Procédure

Cette procédure désactive l'agent AI dans la base de données courante. Le statut de l'agent IA est modifié à DISABLED par cette procédure.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

agent_name

Nom de l'agent d'intelligence artificielle.

Ce paramètre est obligatoire.

Exemple 

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
         agent_name    => 'Customer_Return_Agent'
     );
END;
/

DROP_AGENT Procédure

La procédure supprime un agent IA existant. Si l'agent n'existe pas, la procédure génère une erreur.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DROP_AGENT(
    agent_name          IN  VARCHAR2,
    force               IN  BOOLEAN DEFAULT FALSE
 );

Paramètres

Paramètre Description

agent_name

Nom de l'agent d'intelligence artificielle.

Il s'agit d'un paramètre obligatoire.

force

Si TRUE, la procédure ignore les erreurs si l'agent d'intelligence artificielle n'existe pas.

La valeur par défaut pour ce paramètre est FALSE.

Exemple 

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_AGENT(agent_name => 'Customer_Return_Agent);
END;
/

Notes d'utilisation

Utilisez force pour supprimer un agent et ignorer les erreurs si l'agent d'intelligence artificielle n'existe pas.

CREATE_TASK Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TASK pour définir une tâche qu'un agent Select AI peut inclure dans son processus de raisonnement. Chaque tâche a un nom unique et un jeu d'attributs qui spécifient le comportement de l'agent lors de la planification et de l'exécution de la tâche.

Vous pouvez définir des dépendances entre les tâches à l'aide de l'attribut input, ce qui permet à Select AI de transmettre la sortie d'une tâche à une autre. Cela prend en charge le raisonnement enchaîné et les flux de travail en plusieurs étapes.

Syntaxe 

DBMS_CLOUD_AI_AGENT.CREATE_TASK(
     task_name           IN  VARCHAR2,
     attributes          IN  CLOB,
     status              IN  VARCHAR2  DEFAULT NULL,
     description         IN  CLOB      DEFAULT NULL
  );

Paramètres

Paramètre Description

task_name

Nom unique de la tâche.

Il s'agit d'un paramètre obligatoire.

attributes

Objet JSON contenant des attributs propres à la tâche. Voir Attributs CREATE_TASK.

status

Statut de la tâche.

La valeur par défaut est ENABLED.

description

Description définie par l'utilisateur pour aider à identifier la tâche. Cette valeur est stockée dans la base de données mais n'est pas envoyée au LLM.

La valeur par défaut est NULL.

Exemple

L'exemple suivant crée une tâche pour traiter un retour de produit d'un client. 

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TASK(
    task_name => 'Return_And_Price_Match',
    attributes => '{"instruction": "Process a product return request from a customer:{query}' ||
                    '1. Ask customer the reason for return (price match or defective)' ||
                    '2. If price match:' ||
                    '   a. Request customer to provide a price match link' ||
                    '   b. Use websearch tool to get the price for that price match link' ||
                    '   c. Ask customer if they want a refund.' ||
                    '   d. Send email notification only if customer accept the refund.' ||
                    '3. If defective:' ||
                     '   a. Process the defective return",
                    "tools": ["WebSearch", "Email"]}'
  );
END;
/

Attributs CREATE_TASK

Ces attributs définissent les instructions et les outils de l'agent disponibles pour la tâche.

Attributs

Nom d'attribut Par défaut Description

instruction

 -
Une déclaration claire et concise qui décrit ce que la tâche doit accomplir. Ce texte est inclus dans l'invite envoyée au GML. Vous pouvez inclure un paramètre fictif {query} pour représenter votre entrée en langue naturelle. Exemple : 
SELECT AI AGENT <user_prompt>

Il s'agit d'un paramètre obligatoire.

tools

-

Tableau JSON de noms d'outil que l'agent peut utiliser pour terminer la tâche. Par exemple : "tools": ["RAG", "SQL", "WEBSEARCH", "NOTIFICATION"].

Il s'agit d'un paramètre obligatoire.

input

 -

Identifie les autres tâches dont les sorties doivent être utilisées comme entrées pour cette tâche. Select AI fournit automatiquement ces sorties au LLM.

enable_human_tool

 -

Permettre à l'agent de poser des questions à l'utilisateur lorsqu'il nécessite des informations ou des éclaircissements au cours d'une tâche.

Valeur par défaut Vrai.

Note

La tâche enable_human_tool remplace l'attribut enable_human_tool de l'agent. Si l'agent enable_human_tool est réglé à false et que la tâche enable_human_tool est réglée à true, lors de l'exécution de la tâche, le GML doit poser des questions.

ENABLE_TASK Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TASK pour activer une tâche définie précédemment. Le statut de la tâche passe à ENABLED, ce qui permet à l'agent de l'utiliser lors du traitement.

Syntaxe 

DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
   task_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

task_name

Nom de la tâche à activer.

Ce paramètre est obligatoire.

Notes d'utilisation

La tâche doit déjà exister dans le système. Cette procédure met à jour le statut de la tâche, ce qui la rend disponible pour le processus d'agent lors des flux de travail de raisonnement.

Exemple pour activer une tâche

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
         task_name    => 'Return_And_Price_Match'
     );
END;
/

DISABLE_TASK Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TASK pour désactiver une tâche dans la base de données courante. Le statut de la tâche passe à DISABLED, ce qui empêche l'agent de l'utiliser lors du traitement.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
   task_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

task_name

Nom de la tâche à désactiver.

Ce paramètre est obligatoire.

Notes d'utilisation

La désactivation d'une tâche ne la supprime pas; vous pouvez la réactiver ultérieurement à l'aide de DBMS_CLOUD_AI_AGENT.ENABLE_TASK. Une fois désactivée, la tâche devient inactive et l'agent ne la prend plus en compte lors de la sélection de la tâche.

Exemple

L'exemple suivant désactive une tâche existante.

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
         task_name    => 'Return_And_Price_Match'
     );
END;
/

DROP_TASK Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TASK pour supprimer de la base de données une tâche définie précédemment. Si la tâche n'existe pas, vous pouvez supprimer l'erreur en réglant le paramètre force à TRUE.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DROP_TASK(
   task_name IN  VARCHAR2,
   force     IN  BOOLEAN DEFAULT FALSE
);

Paramètres

Paramètre Description

task_name

Nom de la tâche à abandonner

Il s'agit d'un paramètre obligatoire.

force

Si TRUE, la procédure ignore les erreurs si la tâche n'existe pas.

La valeur par défaut pour ce paramètre est FALSE.

Exemple 

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_TASK(task_name => 'Return_And_Price_Match');
END;
/

Notes d'utilisation

Utilisez force pour supprimer une tâche et ignorer les erreurs si la tâche n'existe pas.

CREATE_TOOL Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TOOL pour enregistrer un outil personnalisé qu'un agent peut utiliser lors du traitement des tâches. Chaque outil est identifié par un tool_name unique et comprend des attributs qui définissent son objectif, sa logique de mise en œuvre et ses métadonnées.

Les outils peuvent être des procédures ou des fonctions PL/SQL personnalisées, ou des types d'outils intégrés tels que RAG, SQL, WEBSEARCH ou NOTIFICATION.

Syntaxe 

DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
     tool_name          IN  VARCHAR2,
     attributes          IN  CLOB,
     status              IN  VARCHAR2  DEFAULT NULL,
     description         IN  CLOB      DEFAULT NULL
  );

Paramètres

Paramètre Description

tool_name

Nom unique pour identifier l'outil.

Il s'agit d'un paramètre obligatoire.

attributes

Attributs d'outil au format JSON. Voir Attributs CREATE_TOOL.

Il s'agit d'un paramètre obligatoire.
status

Statut de l'outil.

La valeur par défaut est ENABLED.

description

Description définie par l'utilisateur pour aider à identifier l'outil. Cette valeur est stockée dans la base de données mais n'est pas envoyée au LLM.

La valeur par défaut est NULL.

Exemple

L'exemple suivant crée un outil pour générer un courriel au destinataire. 

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
    tool_name  => 'NOTIFICATION',
    attributes => '{"tool_type": "EMAIL"}'
  );
END;
/

Attributs CREATE_TOOL

Ces attributs fournissent une configuration d'outil à l'aide d'un objet JSON dans le paramètre des attributs. Chaque attribut configure la façon dont l'agent utilise l'outil lors du raisonnement.

Attributs

Nom d'attribut Par défaut Description

instruction

 -

Une déclaration claire et concise qui décrit ce que l'outil doit accomplir et comment le faire. Ce texte est inclus dans l'invite envoyée au GML.

Il s'agit d'un paramètre obligatoire.

function

-

Indique la procédure ou la fonction PL/SQL à appeler lorsque l'outil est utilisé.

Il s'agit d'un paramètre obligatoire pour les outils personnalisés.

tool_type

 -

Spécifie un type d'outil intégré. Si défini, instruction et function ne sont pas requis.

Les valeurs possibles sont :
  • SQL
  • RAG
  • WEBSEARCH
  • NOTIFICATION

Vous pouvez créer des outils intégrés avec des noms et des paramètres personnalisés. Vous pouvez également créer plusieurs outils intégrés avec le même tool_type mais avec des tool_params différents.

tool_params

 -

Spécifie les paramètres d'enregistrement des outils intégrés.

tool_inputs

 -

Décrit les arguments d'entrée. Similaire aux commentaires de colonne d'une table. Exemple :

"tool_inputs": [
  {
    "name": "data_guard",
    "description": "Only supported values are "Enabled" and "Disabled""
  }
]

Préalables pour l'outil intégré

Effectuez les étapes suivantes avant d'utiliser les outils intégrés :

Outil ROV

  1. Créez un profil d'IA qui référence un index vectoriel. Voir Sélectionner l'IA avec génération augmentée d'extraction (RAG).

Outil de NOTIFICATION

Les éléments suivants sont pris en charge : SLACK et EMAIL.

Outil SLACK :

  1. Configurez une application Slack pour recevoir des messages d'Autonomous Database.
  2. Créez des données d'identification à l'aide de DBMS_CLOUD_NOTIFICATION pour envoyer des avis Slack à partir d'Autonomous Database. Voir Envoyer des avis Slack à partir d'une base de données autonome sur l'IA.

Outil EMAIL :

Note

L'outil de courriel envoie un avis par courriel à partir d'OCI.
  1. Identifiez votre point d'extrémité SMTP. Par exemple, sélectionnez l'un des points d'extrémité SMTP : 
    smtp.us-phoenix-1.oraclecloud.com
smtp.us-ashburn-1.oraclecloud.com
smtp.email.uk-london-1.oci.oraclecloud.com
smtp.email.eu-frankfurt-1.oci.oraclecloud.com
  2. Accorder l'accès SMTP à l'aide d'une liste de contrôle d'accès. Voir Configuration d'une connexion SMTP.
  3. Générez les données d'identification SMTP pour la transmission de messages. L'ensemble UTL_SMTP utilise des données d'identification pour l'authentification sur les serveurs de transmission de messages lors de l'envoi d'un courriel. Pour plus d'informations, voir Générer les données d'identification SMTP pour un utilisateur.
  4. création d'expéditeurs approuvés; Effectuez cette étape pour toutes les adresses de courriel que vous utilisez comme adresse From avec le sous-programme UTL_SMTP.MAIL. Pour plus d'informations, voir Gestion des émetteurs approuvés.
  5. Accordez l'accès SMTP à l'utilisateur en ajoutant Access Control Entry (ACE). Pour plus de détails, voir Envoyer un courriel à partir d'une base de données Autonomous Database à l'aide de DBMS_CLOUD_NOTIFICATION.

Types d'outils intégrés dans l'ensemble DBMS_CLOUD_AI_AGENT

Vous pouvez enregistrer des outils intégrés à l'aide des attributs tool_type et tool_params.

Type d'outil Description Paramètres obligatoires

SQL

Convertit le langage naturel en interrogations SQL.

profile_name

RAG

Exécute la génération augmentée par extraction au moyen de la recherche vectorielle.

profile_name

NOTIFICATION
Envoie des messages à un canal Slack ou envoie des courriels à l'aide de SMTP. Options disponibles :
  • slack
  • email

notification_type.

Lorsque notification_type est slack, credential_name et channel sont obligatoires.

Lorsque notification_type est email, credential_name, recipient, sender et smtp_host sont obligatoires.

WEBSEARCH

Recherche des informations sur le Web.

credential_name

ENABLE_TOOL Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TOOL pour activer un outil précédemment enregistré. Le statut de l'outil passe à ENABLED, ce qui permet à l'agent de l'utiliser pour les tâches.

Syntaxe 

DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

tool_name

Nom de l'outil à activer.

Ce paramètre est obligatoire.

Exemple 

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
         tool_name    => 'SQL'
     );
END;
/

DISABLE_TOOL Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TOOL pour désactiver un outil enregistré. Le statut de l'outil passe à DISABLED, ce qui empêche l'agent de l'utiliser dans les tâches.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

tool_name

Nom de l'outil à désactiver.

Ce paramètre est obligatoire.

Exemple

L'exemple suivant désactive un outil existant.

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
         tool_name    => 'SQL'
     );
END;
/

DROP_TOOL Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TOOL pour supprimer un outil précédemment enregistré auprès de l'agent. Si la tâche n'existe pas, vous pouvez supprimer l'erreur en réglant le paramètre force à TRUE.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DROP_TOOL(
   tool_name IN  VARCHAR2,
   force     IN  BOOLEAN DEFAULT FALSE
);

Paramètres

Paramètre Description

tool_name

Nom de l'outil à supprimer.

Il s'agit d'un paramètre obligatoire.

force

Si TRUE, la procédure ignore les erreurs si l'outil n'existe pas.

La valeur par défaut pour ce paramètre est FALSE.

Exemple 

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_TOOL(tool_name => 'SQL');
END;
/

Notes d'utilisation

Utilisez force pour supprimer un outil et ignorer les erreurs si l'outil n'existe pas.

CREATE_TEAM Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TEAM pour définir une équipe d'agents IA qui travaillent ensemble pour accomplir des tâches. Vous spécifiez les agents et les tâches associées, ainsi que la façon dont les tâches doivent être traitées.

Syntaxe 

DBMS_CLOUD_AI_AGENT.CREATE_TEAM(
   team_name    IN VARCHAR2,
   attributes   IN CLOB,
   status       IN VARCHAR2 DEFAULT NULL,
   description  IN CLOB     DEFAULT NULL
);

Paramètres

Paramètre Description

team_name

Nom unique permettant d'identifier l'équipe d'agent d'intelligence artificielle.

Il s'agit d'un paramètre obligatoire.

attributes

Chaîne au format JSON définissant les attributs d'équipe, tels que les agents et le processus. Voir Attributs CREATE_TEAM.

Il s'agit d'un paramètre obligatoire.
status

Statut de l'équipe.

La valeur par défaut est ENABLED.

description

Description définie par l'utilisateur pour identifier l'objectif de l'équipe. Cette valeur est stockée dans la base de données mais n'est pas envoyée au LLM.

La valeur par défaut est NULL.

Exemple

L'exemple suivant crée une équipe d'agent pour traiter le retour de produit d'un client. 

BEGIN                                                                
  DBMS_CLOUD_AI_AGENT.CREATE_TEAM( 
    team_name  => 'ReturnAgency',                                                            
    attributes => '{"agents": [{"name":"Customer_Return_Agent","task" : "Return_And_Price_Match"}],
                    "process": "sequential"}');                                                                
END;                                                                      
/

Attributs CREATE_TEAM

Ces attributs fournissent la configuration de l'équipe d'agent d'IA. Chaque équipe dispose d'un team_name unique et utilise un jeu d'attributs pour définir sa structure et sa stratégie d'exécution.

Attributs

Nom d'attribut Par défaut Description

agents

 -

Spécifie les agents de liste de tableaux JSON et les tâches correspondantes. Un agent peut être affecté à plusieurs tâches sous le même nom.

Il s'agit d'un paramètre obligatoire.

Exemple :

[
  {"name": "<agent_name>", "task": "<task_name>"
]

process

-

Indique comment les tâches sont exécutées. Utilisez "sequential" pour les tâches à exécuter les unes après les autres dans l'ordre.

Fonction SET_TEAM

Utilisez DBMS_CLOUD_AI_AGENT.SET_TEAM pour spécifier l'équipe d'agent d'intelligence artificielle pour la session courante.

Une fois qu'une équipe est définie, seule l'action select ai agent est activée, le système ne prend pas en charge les autres actions Sélectionner l'IA.

Syntaxe 

DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name      IN  VARCHAR2,
);

Paramètres

Paramètre Description

team_name

Spécifie le nom de l'équipe d'agent d'IA à utiliser dans la session courante. L'équipe doit déjà exister dans le système.

Ce paramètre est obligatoire.

Exemple

L'exemple suivant définit l'équipe d'agent d'IA spécifiée par l'utilisateur dans la session courante.

EXEC DBMS_CLOUD_AI_AGENT.SET_TEAM('ReturnAgency');

Fonction GET_TEAM

Utilisez DBMS_CLOUD_AI_AGENT.GET_TEAM pour retourner l'équipe d'agent d'intelligence artificielle pour la session courante.

Syntaxe 

DBMS_CLOUD_AI_AGENT.GET_TEAM RETURN VARCHAR2;

Exemple

L'exemple suivant retourne l'équipe d'agent d'intelligence artificielle dans la session courante.

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM from DUAL;

Fonction CLEAR_TEAM

Utilisez DBMS_CLOUD_AI_AGENT.CLEAR_TEAM pour effacer l'équipe d'agent d'intelligence artificielle définie dans la session courante. Cette procédure ne laisse pas tomber l'équipe.

Syntaxe 

DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;

Exemple

L'exemple suivant efface l'équipe d'agent d'intelligence artificielle dans la session courante.

BEGIN
  DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;
END;
/

Fonction RUN_TEAM

Utilisez DBMS_CLOUD_AI_AGENT.RUN_TEAM pour démarrer une nouvelle équipe d'agent d'intelligence artificielle ou reprendre une équipe en pause en attente d'une entrée humaine. Si vous fournissez un ID processus existant et que le processus d'équipe associé est à l'état WAITING_FOR_HUMAN, la fonction reprend le flux de travail à l'aide de l'entrée que vous fournissez en tant que réponse humaine.

Syntaxe 

DBMS_CLOUD_AI_AGENT.RUN_TEAM(
     team_name               IN  VARCHAR2,
     user_prompt             IN  CLOB DEFAULT NULL,
     params                  IN  CLOB DEFAULT NULL,
  );

Paramètres

Paramètre Description

team_name

Spécifie le nom de l'équipe d'agent d'IA à utiliser dans la session courante. L'équipe doit déjà exister dans le système.

Ce paramètre est obligatoire.

user_prompt

Spécifie l'interrogation ou la réponse de l'utilisateur fournie à la tâche.

Si la tâche est à l'état RUNNING, l'entrée sert de paramètre fictif pour {query} dans l'instruction de tâche.

Si la tâche est à l'état WAITING_FOR_HUMAN, l'entrée sert de réponse humaine.

params
Spécifie les paramètres personnalisés utilisés lors du processus d'équipe d'agent d'intelligence artificielle. Les paramètres pris en charge sont les suivants :
  • conversation_id : Identifie la session de conversation associée à l'équipe de l'agent. Utilisez ce paramètre pour les intégrations d'application sans état (par exemple, APEX) afin de distinguer les différentes connexions d'utilisateur.
  • variables : Définissez des paires clé-valeur qui fournissent une entrée supplémentaire à l'équipe de l'agent. Ces variables permettent de personnaliser le comportement de l'équipe au cours du processus.

Exemple

L'exemple suivant exécute l'équipe d'agent d'IA spécifiée par l'utilisateur dans la session courante.

l_final_answer := DBMS_CLOUD_AI_AGENT.RUN_TEAM(
  team_name => 'ReturnAgency',
  user_prompt => 'I want to return computer desk chair',
  params => '{"conversation_id": "' ||l_conversation_id || '"}'
);

ENABLE_TEAM Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TEAM pour activer une équipe d'agent d'IA spécifiée par l'utilisateur. Le statut de l'équipe passe à ENABLED.

Syntaxe 

DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
   team_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

team_name

Nom de l'équipe d'agent d'intelligence artificielle à activer.

Ce paramètre est obligatoire.

Exemple

L'exemple suivant active une équipe d'agent d'IA spécifiée par l'utilisateur.

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
         team_name    => 'ReturnAgency'
     );
END;
/

DISABLE_TEAM Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TEAM pour désactiver une équipe d'agent d'IA existante. Le statut de l'équipe passe à DISABLED.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
   team_name           IN  VARCHAR2
);

Paramètres

Paramètre Description

team_name

Nom de l'équipe de l'agent d'intelligence artificielle à désactiver.

Ce paramètre est obligatoire.

Exemple

L'exemple suivant désactive une équipe d'agent d'IA existante.

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
         team_name    => 'ReturnAgency'
     );
END;
/

DROP_TEAM Procédure

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TEAM pour supprimer une équipe d'agent d'IA créée précédemment.

Syntaxe 

DBMS_CLOUD_AI_AGENT.DROP_TEAM(
   team_name IN  VARCHAR2,
   force     IN  BOOLEAN DEFAULT FALSE
);

Paramètres

Paramètre Description

team_name

Nom de l'équipe à abandonner.

Il s'agit d'un paramètre obligatoire.

force

Si TRUE, la procédure ignore les erreurs si l'équipe n'existe pas.

La valeur par défaut pour ce paramètre est FALSE.

Exemple 

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_TEAM(team_name => 'ReturnAgency');
END;
/

Notes d'utilisation

Utilisez force pour supprimer une équipe et ignorer les erreurs si l'équipe n'existe pas.