跳转到主要内容
AI 端口旨在连接到一系列提供 REST API 的 AI 模型。支持的列表见下方。

​
核心功能

  • 多供应商 AI 集成
  • 灵活的提示词工程（Prompt Engineering）
  • 可自定义的 AI 模型选择
  • 结构化输出控制
  • 智能内容处理

​
概述

知行之桥 AI 端口是一个灵活的集成工具，通过 REST API 连接到任何 AI 模型，能够使用可配置的系统提示词和用户提示词处理输入消息，从而在工作流中生成结构化输出。它支持流行的 AI 服务，如 OpenAI、Gemini、Ollama 以及其他兼容 OpenAI 的供应商，并能完全控制 API 端点、模型和参数。通过支持 ArcScript 的提示词和可自定义的输出格式，该端口支持多种使用场景，例如从非结构化反馈中提取见解、跨语言翻译内容以及将文本数据转换为可操作的结构化信息。

​
操作

​
端口配置

本节包含所有可配置的端口属性。

​
AI 配置页面

如果尚未在 设置 > 高级 > AI 设置 中配置全局 AI 设置，AI 配置 页面将显示一条消息，提示必须先完成此配置才能使用该端口。点击 配置 AI 设置 按钮，并按照 AI 设置 中的说明进行操作。如果全局设置已配置，但想在此端口中覆盖这些设置，请点击 编辑。要覆盖全局设置，请开启 覆盖全局设置 切换开关。现在可以选择要使用的 AI 供应商，输入相应的连接详细信息并保存配置。该端口支持以下供应商：
  • Claude
  • Deepseek
  • Gemini
  • Grok
  • Ollama（云端和本地）
  • OpenAI
  • OpenAI Compatible（任何实现 OpenAI API 的 AI 供应商）
使用 编辑 AI 设置 面板定义 基地址 (Base URL)（仅当供应商为 Ollama 或 OpenAI Compatible 时可用），添加供应商的 API Key，并选择 模型。 要填充 用户提示词 字段，可以点击 推荐提示词 查看针对各种场景预定义的一组提示词，也可以直接在字段中输入自己的提示词。这是定义在接收到文件时希望端口执行的任务或请求的地方。例如，可以输入类似 使用自然语言总结入站的 EDI X12 文件 的内容，以便不熟悉 EDI X12 结构的员工能够阅读摘要并了解文档包含的信息。此字段支持 ArcScript。 还可以选择 将输入消息附加到请求。当向 AI 供应商提供二进制文件（如 PDF 或图像）时，这尤其有用。 要在请求中包含非二进制文件，需要在提示词中使用 _message.body，如下所示：
如需完整示例，请查看 推荐提示词 下拉列表中的“总结”选项。
开启 系统提示词 以提供一组特定的指令、约束、语言或角色，供 AI 供应商在提供响应时使用。例如：在回答中不要使用任何破折号或表情符号。 此字段同样支持 ArcScript。 测试配置和提示词的方式取决于端口的操作类型：
  • 如果端口是触发端口，点击 测试 按钮。
  • 如果端口是转换或终结端口，在 测试 页面上，将内容粘贴到 输入正文 中，或使用下拉列表添加 请求头 和值，然后点击 测试 按钮。
在这两种情况下，测试结果都会显示在 测试 页面中。测试日志显示在 日志 页面中。

​
设置页面

与端口核心配置相关的设置。

​
配置

​
高级设置

​
高级页面

​
其他设置

​
代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下，本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一：Basic、Digest、Proprietary 或 NTLM。

​
消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

​
日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型：
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

​
其他

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

​
自动化页面

​
自动化设置

与端口自动处理文件相关的设置。

​
警报页面

​
SLA 页面

​
交易页面

此页面列出了与该端口关联的所有消息。使用搜索栏查找特定消息，或点击漏斗图标应用过滤器。可以按时间、消息方向和/或状态进行过滤。 此页面上的选项因端口的操作类型而异：
  • 如果端口是 触发 端口，使用 接收文件 按钮开始工作流。
  • 如果端口是 转换 或 终结 端口，使用 上传文件 按钮将文件上传到工作流。

​
宏

​
示例