Package DBMS_CLOUD_AI_AGENT

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

Récapitulatif des sous-programmes DBMS_CLOUD_AI_AGENT

Cette section couvre les sous-programmes DBMS_CLOUD_AI_AGENT de l'agent Select AI fournis avec la base de données Autonomous AI.

Procédure CREATE_AGENT

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_AGENT pour inscrire un nouvel agent AI dans la structure 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

Exemple

L'exemple suivant crée un agent pour traiter les retours de produits client. Pour obtenir un exemple complet, reportez-vous à Exemple : création d'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.

CREATE_AGENT Attributs

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

Attributs

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

Procédure ENABLE_AGENT

Cette procédure active l'agent AI spécifié par l'utilisateur. La procédure modifie le statut de l'agent AI en ENABLED.

Syntaxe

DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Paramètres

Exemple d'activation du profil AI

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

Procédure DISABLE_AGENT

Cette procédure désactive l'agent AI dans la base de données en cours. Le statut de l'agent AI est remplacé par DISABLED par cette procédure.

Syntaxe

DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Paramètres

Exemple

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

Procédure DROP_AGENT

La procédure supprime un agent AI 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

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 cet agent n'existe pas.

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 ensemble d'attributs qui indiquent 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 des 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 en chaîne et les workflows 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

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;
/

CREATE_TASK Attributs

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

Attributs

SELECT AI AGENT \

Procédure ENABLE_TASK

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

Syntaxe

DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
   task_name           IN  VARCHAR2
);

Paramètres

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 workflows de raisonnement.

Exemple d'activation d'une tâche

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

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 en cours. Le statut de la tâche devient DISABLED, ce qui empêche l'agent de l'utiliser pendant le traitement.

Syntaxe

DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
   task_name           IN  VARCHAR2
);

Paramètres

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;
/

Procédure DROP_TASK

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

Syntaxe

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

Paramètres

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.

Procédure CREATE_TOOL

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TOOL pour inscrire un outil personnalisé qu'un agent peut utiliser lors du traitement des tâches. Chaque outil est identifié par un élément tool_name unique et inclut des attributs qui définissent son objectif, sa logique d'implémentation et ses métadonnées.

Les outils peuvent être des fonctions PL/SQL personnalisées ou des types d'outil 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

Exemple

L'exemple suivant crée un outil SQL pour générer du code SQL à partir d'un profil NL2SQL existant. Pour plus d'informations, voir Exemple : Créer des outils intégrés.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
    tool_name  => 'SQL',
    attributes => '{"tool_type": "SQL",
                    "tool_params": {"profile_name": "nl2sql_profile"}}'
  );
END;
/

CREATE_TOOL Attributs

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

Attributs

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

Prérequis pour l'outil intégré

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

Outil RAG

1. Créez un profil AI qui référence un index vectoriel. Reportez-vous à Sélection de l'IA avec la génération augmentée de récupération (RAG).

Outil de NOTIFICATION

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

Outil SLACK :

1. Configurez une application Slack pour recevoir les messages de la base de données Autonomous AI.

2. Créez des informations d'identification à l'aide de DBMS_CLOUD_NOTIFICATION pour envoyer des notifications Slack à partir de la base de données Autonomous AI. Reportez-vous à Envoi de notifications Slack à partir d'une base de données Autonomous AI.

Outil de messagerie électronique :

Remarque

Remarque : l'outil de messagerie électronique envoie une notification par courriel à partir d'OCI.

1. Identifiez votre adresse SMTP. Par exemple, sélectionnez l'une des adresses 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. Accordez l'accès SMTP à l'aide d'une ACL. Reportez-vous à la section Configuring SMTP Connection.

3. Générez des informations d'identification SMTP pour la remise des courriels. Le package UTL_SMTP utilise les informations d'identification pour l'authentification auprès des serveurs de distribution de courriels lorsque vous envoyez un courriel. Pour plus d'informations, reportez-vous à Génération d'informations d'identification SMTP pour un utilisateur.

4. Créer des expéditeurs approuvés Effectuez cette étape pour toutes les adresses électroniques que vous utilisez comme adresse From avec le sous-programme UTL_SMTP.MAIL. Pour plus d'informations, reportez-vous à la rubrique Gestion des expédititeurs approuvés.

5. Accordez l'accès SMTP à l'utilisateur en ajoutant une entrée de contrôle d'accès (ACE). Pour plus d'informations, reportez-vous à Envoi de courriels à partir d'une base de données Autonomous AI à l'aide de DBMS_CLOUD_NOTIFICATION.

Types d'outil intégrés dans le package DBMS_CLOUD_AI_AGENT

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

Procédure ENABLE_TOOL

Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TOOL pour activer un outil créé précédemment. Le statut de l'outil devient ENABLED, ce qui permet à l'agent de l'utiliser.

Syntaxe

DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Paramètres

Exemple

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

Procédure DISABLE_TOOL

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DISABLE_TOOL pour désactiver un outil. Le statut de l'outil devient 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

Exemple

L'exemple suivant désactive un outil existant.

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

Procédure DROP_TOOL

Utilisez la procédure DBMS_CLOUD_AI_AGENT.DROP_TOOL pour enlever un outil précédemment créé avec l'agent. Si la tâche n'existe pas, vous pouvez supprimer l'erreur en définissant le paramètre force sur TRUE.

Syntaxe

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

Paramètres

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.

Procédure CREATE_TEAM

Utilisez la procédure DBMS_CLOUD_AI_AGENT.CREATE_TEAM pour définir une équipe d'agents d'IA qui travaillent ensemble pour accomplir des tâches. Vous indiquez les agents et les tâches qui leur sont 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

Exemple

L'exemple suivant crée une équipe d'agents pour traiter le retour 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;
/

CREATE_TEAM Attributs

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

Attributs

[ {"name": "", "task": "" ]

Fonction SET_TEAM

Utilisez DBMS_CLOUD_AI_AGENT.SET_TEAM pour indiquer l'équipe d'agent AI pour la session en cours.

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 Select AI.

Syntaxe

DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name      IN  VARCHAR2,
);

Paramètres

Exemple

L'exemple suivant définit l'équipe d'agent AI spécifiée par l'utilisateur dans la session en cours.

EXEC DBMS_CLOUD_AI_AGENT.SET_TEAM('ReturnAgency');

Fonction GET_TEAM

Utilisez DBMS_CLOUD_AI_AGENT.GET_TEAM pour renvoyer l'équipe d'agent AI pour la session en cours.

Syntaxe

DBMS_CLOUD_AI_AGENT.GET_TEAM RETURN VARCHAR2;

Exemple

L'exemple suivant renvoie l'équipe d'agent AI dans la session en cours.

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 AI définie dans la session en cours. Cette procédure ne supprime pas l'équipe.

Syntaxe

DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;

Exemple

L'exemple suivant efface l'équipe d'agent AI dans la session en cours.

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 AI ou reprendre une équipe en pause en attente d'entrée humaine. Si vous indiquez un ID de processus existant et que le processus d'équipe associé est à l'état WAITING_FOR_HUMAN, la fonction reprend le workflow en utilisant l'entrée que vous fournissez comme 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

Exemple

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

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 \|\| '"}'
);

Procédure ENABLE_TEAM

Utilisez la procédure DBMS_CLOUD_AI_AGENT.ENABLE_TEAM pour activer une équipe d'agents AI spécifiée par l'utilisateur. Le statut de l'équipe devient ENABLED.

Syntaxe

DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
   team_name           IN  VARCHAR2
);

Paramètres

Exemple

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

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

Procédure DISABLE_TEAM

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

Syntaxe

DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
   team_name           IN  VARCHAR2
);

Paramètres

Exemple

L'exemple suivant désactive une équipe d'agents AI existante.

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

Procédure DROP_TEAM

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

Syntaxe

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

Paramètres

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.

Fonction DESCRIBE_TOOL

Utilisez la fonction DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL pour renvoyer des métadonnées JSON pour un outil. Le résultat inclut le nom de l'outil, la description, les attributs et les informations de schéma d'entrée qu'un client compatible MCP peut utiliser pour la découverte d'outils.

Syntaxe

DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL(
  tool_name IN VARCHAR2
) RETURN CLOB;

Paramètres

Retours

Renvoie une valeur CLOB qui contient des métadonnées d'outil et des informations d'argument au format JSON.

Exemple

DECLARE
  l_result CLOB;
BEGIN
  l_result := DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL(
    tool_name => 'FETCH_LOG_TOOL'
  );

  DBMS_OUTPUT.PUT_LINE(l_result);
END;
/

Fonction RUN_TOOL

Utilisez la fonction DBMS_CLOUD_AI_AGENT.RUN_TOOL pour appeler un outil créé par son nom. Le paramètre d'entrée transmet les arguments d'outil en tant que charge utile JSON.

Syntaxe

DBMS_CLOUD_AI_AGENT.RUN_TOOL(
  tool_name IN VARCHAR2,
  input IN CLOB
) RETURN CLOB;

Paramètres

Retours

Renvoie une valeur CLOB qui contient le résultat de l'exécution de l'outil.

Exemple

SELECT DBMS_CLOUD_AI_AGENT.RUN_TOOL(
  tool_name => 'FETCH_LOG_TOOL',
  input => '{"P_SINCE":"2026-01-01"}'
) AS tool_result
FROM dual;

Fonction LIST_TEAMS

Utilisez la fonction DBMS_CLOUD_AI_AGENT.LIST_TEAMS pour énumérer les équipes d'agent disponibles pour l'utilisateur appelant. Le résultat peut être utilisé par les couches d'intégration compatibles A2A pour la découverte d'équipe.

Syntaxe

DBMS_CLOUD_AI_AGENT.LIST_TEAMS
  RETURN CLOB;

Paramètres

Retours

Renvoie une valeur CLOB qui contient un tableau JSON. Chaque entrée inclut le nom et la description de l'équipe.

Exemple

SELECT DBMS_CLOUD_AI_AGENT.LIST_TEAMS()
FROM dual;

Fonction DESCRIBE_TEAM

Utilisez la fonction DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM pour renvoyer les métadonnées d'une équipe d'agents. Sélectionnez les outils d'agent AI disponibles pour l'équipe dans la représentation des compétences compatible A2A.

Syntaxe

DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM(
  team_name IN VARCHAR2
) RETURN CLOB;

Paramètres

Retours

Renvoie une valeur CLOB qui contient un objet JSON avec le nom de l'équipe, la description, la version facultative et la liste des briques.

Notes d'utilisation

• Les compétences sont une représentation de protocole d'outils pour les clients compatibles A2A. Ils n'introduisent pas de nouveau type d'objet de base de données Sélectionner un agent AI.

Exemple

SELECT DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM('SUPPORT_TEAM')
FROM dual;

Fonction GET_TEAM_STATE

Utilisez la fonction DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE pour renvoyer le dernier état d'exécution d'une conversation d'équipe d'agent.

Syntaxe

DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE(
  team_name IN VARCHAR2,
  params IN CLOB DEFAULT NULL
) RETURN VARCHAR2;

Paramètres

Retours

Renvoie un état d'exécution VARCHAR2, tel que RUNNING, WAITING_FOR_HUMAN, SUCCEEDED ou FAILED.

Exemple

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE(
  team_name => 'SUPPORT_TEAM',
  params => '{"conversation_id":"<CONVERSATION_ID>"}'
)
FROM dual;

Procédure SET_EXECUTION_STATE

Utilisez la procédure DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE pour mettre à jour une exécution d'équipe en attente vers un état spécifié. Cela est utile pour les workflows d'appel de l'outil agent-direct dans lesquels l'application contrôle une fois la session interactive terminée.

Syntaxe

DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE(
  team_name IN VARCHAR2,
  state IN CLOB DEFAULT 'SUCCEEDED',
  params IN CLOB DEFAULT NULL
);

Paramètres

Exemple

BEGIN
  DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE(
    team_name => 'CUSTOMER_AGENT_ONLY_TEAM',
    state => 'SUCCEEDED',
    params => '{"conversation_id":"<CONVERSATION_ID>"}'
  );
END;
/