Oracle APEX 能拥有 AI 智能体的能力吗？

做 APEX 开发，我们很熟悉这样的过程：建一个页面，放几个输入项，写一段 PL/SQL，点击按钮，业务就往前走一步。

但如果按钮背后的需求变成“帮我查一查这个主题最近发生了什么，再整理出值得关注的变化”，该怎么实现呢？

用户没有告诉我们去哪个网站，也没给出搜索关键词，更没有指定先读哪篇文章。程序需要根据目标找资料，判断结果是否相关，继续读取，再组织答案。每一个动作都能调用 API，但把这些动作接起来，需要有人作判断。

APEX 能不能保留我们熟悉的页面和业务逻辑，同时借用 AI Agent 的能力，完成这种过程不完全固定的任务？

先看清楚，Agent 的能力从哪里来

在这个Demo里，APEX 接收用户的任务，Hermes 负责运行 Agent，模型参与判断下一步该做什么，搜索和网页读取工具负责接触外部信息。

假设输入“Oracle APEX 最新进展”，APEX 不需要写死一份网站清单，也不用在 PL/SQL 中逐条编排搜索词。Hermes 在限定的任务范围内调用搜索工具，拿到结果后读取相关页面，把工具返回的信息交给模型继续处理，最后形成摘要和引用。

Agent 的能力，体现在“判断—调用工具—观察结果—继续处理”的执行过程。 单次模型问答也能生成一段摘要；这个 Demo 要证明的是，摘要前面确实发生了联网检索和资料读取。

Hermes 的 API Server 提供 Responses 接口，并能在服务端执行工具调用。这让 APEX 可以通过 HTTP 提交任务，不必自行实现 Agent 的执行循环。Hermes API Server 文档

APEX 仍然掌握用户身份、任务入口、参数校验和页面展示。Hermes 在受限工具范围内完成搜索分析。模型密钥留在服务端，浏览器接触不到它。

这里也需要交代一个背景：APEX 本身已有 AI Agents 和 AI Tools 能力。选择 Hermes，是在探索接入独立 Agent 运行时的路线，便于利用它的工具与执行机制，也便于让同一套能力被不同应用调用。项目应根据已有能力选择实现方式。Oracle APEX AI Agents 与 AI Tools 文档

从一次点击，看懂整个调用过程

这个 Demo 每次点击都是一个独立任务，没有连续对话，也不保存搜索记录。为了方便观察，使用一次同步请求：页面显示处理中，服务端完成搜索与校验后，一次性返回结果。

前端做的事情很少。取得查询主题以后，调用 APEX 的 Ajax Callback：

1
2
3
4
5

const r = await apex.server.process(
  'SEARCH',
  { x01: topic },
  { dataType: 'json', timeout: 135000 }
);

SEARCH 是应用内的处理入口，后面调用 DEMO_SEARCH_PKG.AJAX_SEARCH。浏览器提交的是主题，不能指定 Hermes 地址、模型或工具权限。前端还负责禁用重复点击、显示状态，以及在失败后恢复按钮。

PL/SQL package 接手以后，先检查登录状态和输入长度，再由服务端读取接口配置。以下是参考源码中的调用部分，省略了前后的结果解析：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

base_url := rtrim(
  apex_app_setting.get_value('HERMES_API_BASE_URL'), '/'
);

body.put('input', topic);
body.put('store', false);
body.put('stream', false);

response := apex_web_service.make_rest_request(
  p_url                  => base_url || '/v1/responses',
  p_http_method          => 'POST',
  p_body                 => body.to_clob,
  p_credential_static_id => c_cred,
  p_transfer_timeout     => 120
);

c_cred 引用 APEX Web Credential，代码里不写密钥。服务地址来自 APEX 的服务端设置。这里的名称是代码中的配置约定，文章和附件不提供任何作者环境的配置值。

请求体还带有固定的 instructions：先搜索，再读取相关网页；只处理公开信息；查询内容与网页正文都作为资料看待；最后按约定输出 JSON。允许哪些工具，则在 Hermes 的运行配置与权限层控制。

这两层各有作用。任务指令告诉 Agent 这次要做什么，工具权限决定它实际上能做什么。只在提示词中写一句“不要修改服务器”，并不能建立权限边界。

GET /v1/toolsets 的真实返回字段：web 已启用，terminal 和 file 未启用。浏览器中展示的是经字段筛选的 API 响应，私有地址与认证信息未包含在内。

真正需要仔细设计的，是如何接住 Agent 的返回结果

APEX 开发者习惯了接口返回固定字段。Agent 的输出却可能少字段、带说明文字，或者给出一个看起来合理但没有检索依据的链接。

因此，这个 Demo 约定返回 quality、summary、findings 和 sources。每条发现通过 source_ids 指向来源。页面据此分区展示，不需要把一大段自由文本猜成页面组件。

更进一步，package 同时读取 Responses 返回中的工具调用记录：function_call 说明调用了什么工具，function_call_output 是对应结果，两者通过 call_id 关联。

对同一 Hermes 服务另行发起一次官方文档查询，实际返回两次 web_search 和一次 web_extract。图为真实响应选定字段在浏览器中的截图，参数 JSON 已展开便于阅读；并非 Hermes 原生管理界面，也不是上方 APEX 截图的同一次请求。

参考代码先建立调用编号与工具名称的映射：

1
2
3
4
5
6

if item.get_string('type') = 'function_call' then
  names.put(
    item.get_string('call_id'),
    item.get_string('name')
  );
end if;

随后收集搜索和网页读取结果中的 URL。模型最终列出的来源，必须在这些实际工具结果中出现，不能只凭模型说“参考了这个链接”就通过。下面这段是来源核对的核心：

1
2
3
4
5
6
7
8
9

found := false;
for j in 0 .. urls.get_size - 1 loop
  if urls.get_string(j) = url then
    found := true;
  end if;
end loop;
if not found then
  raise value_error;
end if;

完整校验还检查每条发现引用的来源编号，以及实际搜索是否成功。读取网页失败时，可以返回“证据有限”；联网检索失败时，不能把模型凭记忆生成的回答显示成搜索成功。

这种检查能够证明链接来自本次工具结果，并不证明摘要中的每句话都正确。网页本身可能不准确，模型也可能理解偏差。所以页面保留来源，让使用者能够复核。需要更高可靠性的业务，可以在这个边界上继续增加事实核对与人工审核。

展示时同样保持克制。文本内容用 textContent 或 jQuery 的 .text() 写入，来源链接检查协议，不把模型文本直接当成 HTML 执行：

1
2
3
4

text.textContent = finding.text;
a.textContent = source.title;
a.target = '_blank';
a.rel = 'noopener noreferrer';

至此，APEX 已经把一次 Agent 执行变成了一个普通业务页面能够消费的结果：有明确结构、有来源、有失败状态。

下载完整Demo

最后，要考虑安全

这个 Demo 用按钮触发固定任务，主要是为了把能力范围和验收标准讲清楚。搜索主题可以变化，任务始终是搜索与分析。一个自由聊天入口则可能接收到排查系统、修改文件、切换配置等完全不同的要求，开发者需要为更多行为定义权限和产品边界。

对话当然可以成为后续交互方式。只是接入一个聊天窗口之前，先要知道这个 Agent 被允许做什么，以及系统怎样强制落实这些限制。

按钮也不会自动带来安全。输入主题可能夹带指令，网页正文同样可能包含诱导内容。这个场景只需要搜索和网页读取工具，应移除终端、任意文件与配置修改能力；服务进程还需通过容器权限和网络出站策略限制可达范围。不要为了调用方便，就把 Agent 的管理入口暴露给浏览器或公网。

同步调用适合这里的小任务。任务变长、并发增加之后，需要重新评估超时、成本和容量；超时只意味着调用方没有取得结果，不一定意味着 Agent 已停止。store:false 也不等于所有组件都不留数据：参考实现还清理本次临时会话，模型与搜索服务的日志和数据政策则需要分别考虑。

希望这个小Demo能够对你有所启发。