refs #732: add dynamic HMM HTML report MCP tool

2026-08-10 15:23:36 +09:00
parent cc2c3e3e25
commit c0c5a36ba0
12 changed files with 747 additions and 39 deletions
--- a/database/adb/83_hmm_carrier_html_report_tool.sql
+++ b/database/adb/83_hmm_carrier_html_report_tool.sql
@@ -0,0 +1,72 @@
+-- HMM carrier report template storage and DBMS_CLOUD_AI_AGENT custom tool.
+-- Run as ADMIN. Load the approved HTML template into HMM_REPORT_TEMPLATES
+-- through the deployment loader before enabling the MCP tool.
+WHENEVER SQLERROR EXIT SQL.SQLCODE ROLLBACK
+SET DEFINE OFF
+
+CREATE TABLE hmm_report_templates (
+  template_key       VARCHAR2(64) PRIMARY KEY,
+  template_version   VARCHAR2(32) NOT NULL,
+  html_template      CLOB NOT NULL,
+  active_yn          CHAR(1) DEFAULT 'Y' NOT NULL,
+  created_at         TIMESTAMP DEFAULT SYSTIMESTAMP NOT NULL,
+  updated_at         TIMESTAMP DEFAULT SYSTIMESTAMP NOT NULL,
+  CONSTRAINT hmm_report_templates_active_ck CHECK (active_yn IN ('Y', 'N'))
+);
+
+CREATE OR REPLACE PACKAGE hmm_report_render_pkg AUTHID DEFINER AS
+  FUNCTION render_carrier_report(p_report_json IN CLOB) RETURN CLOB;
+END hmm_report_render_pkg;
+/
+
+CREATE OR REPLACE PACKAGE BODY hmm_report_render_pkg AS
+  FUNCTION render_carrier_report(p_report_json IN CLOB) RETURN CLOB IS
+    l_template CLOB;
+    l_data CLOB;
+    l_html VARCHAR2(32767);
+    l_result CLOB;
+  BEGIN
+    IF p_report_json IS NULL OR dbms_lob.getlength(p_report_json) > 64000 THEN
+      raise_application_error(-20101, 'Invalid report payload size.');
+    END IF;
+    IF NOT json_exists(p_report_json, '$.report') OR NOT json_exists(p_report_json, '$.rows') THEN
+      raise_application_error(-20102, 'Report payload requires report and rows.');
+    END IF;
+    SELECT html_template INTO l_template
+      FROM hmm_report_templates
+     WHERE template_key = 'hmm-carrier-performance'
+       AND active_yn = 'Y';
+    l_data := replace(p_report_json, '</', '<\/');
+    l_html := dbms_lob.substr(replace(l_template, '__REPORT_DATA__', l_data), 32767, 1);
+    SELECT json_object(
+      'status' VALUE 'ok',
+      'template' VALUE 'hmm-carrier-performance',
+      'html' VALUE l_html
+      RETURNING CLOB
+    ) INTO l_result FROM dual;
+    RETURN l_result;
+  EXCEPTION
+    WHEN no_data_found THEN
+      raise_application_error(-20103, 'Active report template is not installed.');
+  END render_carrier_report;
+END hmm_report_render_pkg;
+/
+
+BEGIN
+  DBMS_CLOUD_AI_AGENT.DROP_TOOL('HMM_CARRIER_REPORT_RENDERER', force => TRUE);
+  DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
+    tool_name => 'HMM_CARRIER_REPORT_RENDERER',
+    attributes => q'~{
+      "instruction": "Render the supplied carrier-performance payload with the approved HMM HTML template. Do not query data and do not alter the supplied values.",
+      "function": "HMM_REPORT_RENDER_PKG.RENDER_CARRIER_REPORT",
+      "tool_inputs": [{"name":"P_REPORT_JSON","description":"Normalized carrier performance report JSON."}]
+    }~',
+    status => 'ENABLED',
+    description => 'Renders approved HMM carrier-performance HTML from already-authorized query results.'
+  );
+END;
+/
+
+SELECT tool_name, status
+  FROM user_ai_agent_tools
+ WHERE tool_name = 'HMM_CARRIER_REPORT_RENDERER';