在搜索结果中插入图像说明

对于搜索结果中的每条记录,将图像从源字段发送到图像说明模型,并将返回的说明插入目标字段。

选项 

  • 账户名是用于 AI 账户名的文本表达式。在当前文件中,使用配置 AI 账户脚本步骤设置账户,并在此脚本步骤运行之前随时为其分配此名称。

  • 模型是图像标题模型的名称。将模型名称指定为文本表达式。有关支持的模型,请参阅 FileMaker 技术规格

  • 来源字段是指该脚本步骤将向模型发送其中图像以生成文字说明的容器字段。 如果字段为空,则不会向模型发送任何内容,且目标字段保持不变。

  • 目标字段指定要插入返回的说明的文本字段。

  • 替换目标内容将替换目标字段的内容(如果有的话)。若此选项关闭,则仅当字段为空时,才会将结果添加到目标字段中;否则,该字段保持不变。如果源字段的内容频繁更改,则打开此选项很有用。

  • 发生错误时继续即使在某些记录中遇到错误后,也会继续处理搜索结果。选择此选项后,出现错误的记录将保持为空,使其更容易找到和解决。如果未选择,脚本步骤在出现错误时停止。

  • 参数是 JSON 对象的文本表达式,可包含 FileMaker 特定的参数,用于指定发送给模型的请求在大小、数量和频率方面的限制条件。根据数据量、使用的模型、模型提供商的令牌限制以及模型运行的机器的技术规格(核心、RAM 等),使用这些来优化脚本。

    详情请参阅“说明”。

兼容性 

产品 是否支持
FileMaker Pro
FileMaker Go
FileMaker WebDirect
FileMaker Server
FileMaker Cloud
FileMaker Data API
自定义 Web 发布

原始版本 

26.0

说明 

图像描述生成模型可生成对图像的文字描述。所生成的描述内容取决于所使用的模型以及图像的内容。

此脚本步骤仅支持作为模型提供商的 Claris AI Model Server。(请参阅 FileMaker Server 帮助中的配置 AI 服务。)将“账户名称”选项设置为通过配置 AI 账户脚本步骤所配置的账户,该账户对应的“自定义”模型提供商的“端点”为您的 AI 模型服务器。有关支持的图像描述生成模型,请参阅 FileMaker 技术规格

对于当前搜索结果中的每条记录,此脚本步骤会将来源字段中的图像发送至指定模型以生成文字说明,并将返回的文字说明保存至目标字段中。

对于参数选项,如果需要,可以使用 JSON 对象中的以下 FileMaker 特定键和值来调整此脚本步骤的行为。如果未指定密钥或未使用参数选项,则使用默认值。

参数键

说明

默认值

值范围

MaxRecPerCall

每次 API 调用要处理的最大记录数量

20

1 到 500

MaxRetryPerWorker

API 调用失败时重试的最大次数

5

1 到 100

RetryOnError

当一组记录中遇到错误时,1 (true) 单独重新尝试组中的记录,为那些没有错误的记录插入数据,并跳过那些会造成错误的记录。0 (false) 跳过遇到错误的整组记录,并且不生成数据。

注释  启用此参数会覆盖”发生错误时继续“选项。

1

0 或 1

注释  如果使用 JSONSetElement函数创建 JSON 对象,请使用 JSONNumber 常量来设置 type 参数。

例如,这个 JSON 对象在“参数”选项中设置了以下键:

复制
{
    "MaxRecPerCall" : 40,
    "MaxRetryPerWorker" : 10
}

注释 

  • 为了定期自动更新托管 FileMaker Pro 文件中的目标字段,您可以在主机上设置一个时间表,以在没有用户交互的情况下运行 FileMaker 脚本。请参阅 FileMaker Server 帮助FileMaker Cloud 帮助中的 FileMaker 脚本时间表。

示例 1 - 为所有照片生成说明

为 Claris AI Model Server 配置 AI 账户,切换至“产品”布局界面,显示所有记录,随后为“Products::Image”字段中的图像生成文字说明,并将这些说明存储在“Products::Caption”文本字段中。由于已启用“替换目标内容”选项,即使“Products::Caption”字段中已包含数据,该字段仍会被更新。

复制
配置 AI 账户 [ 账户名称: "my-account" ; 模型提供商: 自定义 ; 端点: "https://my-server.example.com/llm/v1/" ; 验证 SSL 证书 ; API 密钥: Global::API_Key ]

转到布局 [ "产品" (产品) ; 动画: 无 ]
显示所有记录

在搜索结果中插入图像说明 [ 账户名称: "my-account" ; 模型: "Salesforce/blip2-opt-2.7b" ; 源字段: Products::Photo ; 目标字段: Products::Caption ; 替换目标内容 ]

示例 2 -为搜索结果中的照片生成缺失的说明

为Claris AI Model Server 配置 AI 账户,切换至“产品”布局界面,然后查找“Products::Category”字段中包含“手动工具”的记录。针对此搜索结果,若“Products::Caption”文本字段中尚无数据(“替换目标内容”选项处于关闭状态),则将为“Products::Photo”字段中的图像生成文字说明,并将其存储在该文本字段中。 如果在生成记录的说明时遇到错误,脚本步骤将继续到下一个记录。

复制
配置 AI 账户 [ 账户名称: "my-account" ; 模型提供商: 自定义 ; 端点: "https://my-server.example.com/llm/v1/" ; 验证 SSL 证书 ; API 密钥: Global::API_Key ]

转到布局 [ "产品" (产品) ; 动画: 无 ]
进入查找模式 [ 暂停: 关 ]
设置字段 [ Products::Category ; "手动工具" ]
执行查找 [ ]

在搜索结果中插入图像说明 [ 账户名称: "my-account" ; 模型: "Salesforce/blip2-opt-2.7b" ; 来源字段: Products::Photo ; 目标字段: Products::Caption ; 发生错误时继续 ; 参数: JSONSetElement ( "" ;
    ["MaxRecPerCall" ; 40 ; JSONNumber] ; 
    ["MaxRetryPerWorker" ; 10 ; JSONNumber]
) ]