agents creation templates

Author: gopalsanjith

autonomous-ai-agents/oci_autonomous_database/oci_autonomous_database_agent.sql

@@ -0,0 +1,164 @@
+-- Copyright (c) 2025 Oracle and/or its affiliates.
+-- Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+--
+-- ======================================================================
+-- Purpose:
+--   Install and configure an OCI Autonomous Database AI Agent using
+--   DBMS_CLOUD_AI_AGENT (Select AI / Oracle AI Database).
+-- ======================================================================
+
+SET SERVEROUTPUT ON
+SET VERIFY OFF
+WHENEVER SQLERROR EXIT SQL.SQLCODE
+
+PROMPT ======================================================
+PROMPT OCI Autonomous Database AI Agent Installer
+PROMPT ======================================================
+
+-- Target schema
+ACCEPT SCHEMA_NAME CHAR PROMPT 'Enter target schema name: '
+DEFINE INSTALL_SCHEMA = '&SCHEMA_NAME'
+
+-- AI Profile
+ACCEPT PROFILE_NAME CHAR PROMPT 'Enter AI Profile name to be used with the Agent: '
+DEFINE PROFILE_NAME = '&PROFILE_NAME'
+
+PROMPT ------------------------------------------------------
+PROMPT Installing into schema: &&INSTALL_SCHEMA
+PROMPT Using AI Profile     : &&PROFILE_NAME
+PROMPT ------------------------------------------------------
+
+----------------------------------------------------------------
+-- 1. Grants (safe to re-run)
+----------------------------------------------------------------
+BEGIN
+  DBMS_OUTPUT.PUT_LINE('Granting required privileges to &&INSTALL_SCHEMA ...');
+  EXECUTE IMMEDIATE 'GRANT EXECUTE ON DBMS_CLOUD_AI_AGENT TO &&INSTALL_SCHEMA';
+  EXECUTE IMMEDIATE 'GRANT EXECUTE ON DBMS_CLOUD TO &&INSTALL_SCHEMA';
+  DBMS_OUTPUT.PUT_LINE('Grants completed.');
+END;
+/
+
+----------------------------------------------------------------
+-- 2. Create installer procedure in target schema
+----------------------------------------------------------------
+PROMPT Creating installer procedure in &&INSTALL_SCHEMA ...
+
+CREATE OR REPLACE PROCEDURE &&INSTALL_SCHEMA..install_oci_autonomous_database_agent (
+  p_profile_name IN VARCHAR2
+)
+AUTHID DEFINER
+AS
+BEGIN
+  DBMS_OUTPUT.PUT_LINE('--------------------------------------------');
+  DBMS_OUTPUT.PUT_LINE('Starting OCI Autonomous Database AI installation');
+  DBMS_OUTPUT.PUT_LINE('Schema : ' || USER);
+  DBMS_OUTPUT.PUT_LINE('--------------------------------------------');
+
+  ------------------------------------------------------------
+  -- DROP & CREATE TASK
+  ------------------------------------------------------------
+  BEGIN
+    DBMS_CLOUD_AI_AGENT.DROP_TASK('OCI_AUTONOMOUS_DATABASE_TASKS');
+  EXCEPTION
+    WHEN OTHERS THEN NULL;
+  END;
+
+  DBMS_CLOUD_AI_AGENT.CREATE_TASK(
+    task_name   => 'OCI_AUTONOMOUS_DATABASE_TASKS',
+    description => 'Task for provisioning and managing OCI Autonomous Databases.',
+    attributes  => '{
+      "instruction": "Identify the intent of the user request and determine the correct Autonomous Database operation. '
+        || 'Prompt the user only for necessary missing details. '
+        || 'Ask clarifying questions if intent is ambiguous. '
+        || 'When presenting any list, object, or JSON structure to the user, format it in a human-readable way. '
+        || 'Confirm destructive actions before execution. '
+        || 'User request: {query}",
+      "tools": [
+        "LIST_SUBSCRIBED_REGIONS_TOOL",
+        "LIST_COMPARTMENTS_TOOL",
+        "GET_COMPARTMENT_OCID_BY_NAME_TOOL",
+        "LIST_AUTONOMOUS_DATABASES_TOOL",
+        "GET_AUTONOMOUS_DATABASE_DETAILS_TOOL",
+        "ADBS_PROVISIONING_TOOL",
+        "ADBS_UNPROVISION_TOOL",
+        "START_AUTONOMOUS_DATABASE_TOOL",
+        "STOP_AUTONOMOUS_DATABASE_TOOL",
+        "DATABASE_RESTART_TOOL",
+        "MANAGE_AUTONOMOUS_DB_POWER_TOOL",
+        "UPDATE_AUTONOMOUS_DB_RESOURCES_TOOL",
+        "GET_MAINTENANCE_RUN_HISTORY_TOOL",
+        "UPDATE_AUTONOMOUS_DATABASE_TOOL",
+        "LIST_KEY_STORES_TOOL",
+        "LIST_DB_HOMES_TOOL",
+        "SHRINK_AUTONOMOUS_DATABASE_TOOL",
+        "DELETE_KEY_STORE_TOOL",
+        "LIST_APPLICATION_VIPS_TOOL",
+        "LIST_ACDS_TOOL",
+        "LIST_ADB_BACKUPS_TOOL",
+        "HUMAN_TOOL"
+      ]
+    }'
+  );
+  DBMS_OUTPUT.PUT_LINE('Created task OCI_AUTONOMOUS_DATABASE_TASKS');
+
+  ------------------------------------------------------------
+  -- DROP & CREATE AGENT
+  ------------------------------------------------------------
+  BEGIN
+    DBMS_CLOUD_AI_AGENT.DROP_AGENT('OCI_AUTONOMOUS_DATABASE_ADVISOR');
+    DBMS_OUTPUT.PUT_LINE('Dropped agent OCI_AUTONOMOUS_DATABASE_ADVISOR');
+  EXCEPTION
+    WHEN OTHERS THEN
+      DBMS_OUTPUT.PUT_LINE('Agent OCI_AUTONOMOUS_DATABASE_ADVISOR does not exist, skipping');
+  END;
+
+  DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
+    agent_name => 'OCI_AUTONOMOUS_DATABASE_ADVISOR',
+    attributes =>
+      '{' ||
+      '"profile_name":"' || p_profile_name || '",' ||
+      '"role":"You are an OCI Autonomous Database Advisor. You help users provision, list, start/stop/restart, resize, update configuration, and inspect ADB-related resources safely. You confirm destructive actions and present results clearly."' ||
+      '}',
+    description => 'AI agent for advising and automating OCI Autonomous Database operations'
+  );
+  DBMS_OUTPUT.PUT_LINE('Created agent OCI_AUTONOMOUS_DATABASE_ADVISOR');
+
+  ------------------------------------------------------------
+  -- DROP & CREATE TEAM
+  ------------------------------------------------------------
+  BEGIN
+    DBMS_CLOUD_AI_AGENT.DROP_TEAM('OCI_AUTONOMOUS_DATABASE_TEAM');
+    DBMS_OUTPUT.PUT_LINE('Dropped team OCI_AUTONOMOUS_DATABASE_TEAM');
+  EXCEPTION
+    WHEN OTHERS THEN
+      DBMS_OUTPUT.PUT_LINE('Team OCI_AUTONOMOUS_DATABASE_TEAM does not exist, skipping');
+  END;
+
+  DBMS_CLOUD_AI_AGENT.CREATE_TEAM(
+    team_name  => 'OCI_AUTONOMOUS_DATABASE_TEAM',
+    attributes => '{
+      "agents":[{"name":"OCI_AUTONOMOUS_DATABASE_ADVISOR","task":"OCI_AUTONOMOUS_DATABASE_TASKS"}],
+      "process":"sequential"
+    }'
+  );
+  DBMS_OUTPUT.PUT_LINE('Created team OCI_AUTONOMOUS_DATABASE_TEAM');
+
+  DBMS_OUTPUT.PUT_LINE('--------------------------------------------');
+  DBMS_OUTPUT.PUT_LINE('OCI Autonomous Database AI installation COMPLETE');
+  DBMS_OUTPUT.PUT_LINE('--------------------------------------------');
+END install_oci_autonomous_database_agent;
+/
+
+----------------------------------------------------------------
+-- 3. Execute installer in target schema
+----------------------------------------------------------------
+PROMPT Executing installer procedure ...
+BEGIN
+  &&INSTALL_SCHEMA..install_oci_autonomous_database_agent('&&PROFILE_NAME');
+END;
+/
+
+PROMPT ======================================================
+PROMPT Installation finished successfully
+PROMPT ======================================================