Gemini API的Interactions接口Guardrails配置咨询：仅见旧版生成内容函数文档

核心配置逻辑 #

Interactions API的Guardrails配置和旧版Generate Content函数的安全配置核心逻辑一致，都是通过定义安全阈值、类别规则控制内容输出，但参数传递方式有细微调整。

具体配置步骤 #

• 复用安全类别配置：直接沿用Generate Content文档里的SafetySetting结构，核心字段为category（如HARM_CATEGORY_HATE_SPEECH）和threshold（如BLOCK_ONLY_HIGH）。
• 适配参数传递方式：调用Interactions API时，将安全配置作为guardrails参数的子项传入（替代Generate Content里的safety_settings参数），示例代码：

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

# 定义Guardrails配置
guardrails_config = {
    "safety_settings": [
        {
            "category": "HARM_CATEGORY_HATE_SPEECH",
            "threshold": "BLOCK_ONLY_HIGH"
        },
        {
            "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
            "threshold": "BLOCK_MEDIUM_AND_ABOVE"
        }
    ]
}

# 调用Interactions API
response = genai.chat.send_message(
    model="gemini-1.5-pro",
    contents="你的对话内容",
    guardrails=guardrails_config
)

• 自定义护栏规则：如需精细控制，可通过custom_guardrails参数添加自定义规则，格式与Generate Content的自定义安全规则一致，支持关键词拦截、内容模板限制等。

注意事项 #

• 目前官方对Interactions API的Guardrails细节文档更新滞后，配置时可优先参考Generate Content的安全类别和阈值定义，大部分规则可直接迁移。
• 若遇特殊场景配置问题，可通过API返回的SAFETY_BLOCKED错误信息反向排查，调整对应类别的阈值。

内容的提问来源于stack exchange，提问作者Lorenzo D'Arsiè