안전 설정

Gemini API는 프로토타입 제작 단계에서 애플리케이션에 더 제한적인 안전 구성이 필요한지 여부를 확인할 수 있는 안전 설정을 제공합니다. 4가지 필터 카테고리에서 이러한 설정을 조정하여 특정 유형의 콘텐츠를 제한하거나 허용할 수 있습니다.

이 가이드에서는 Gemini API가 안전 설정 및 필터링을 처리하는 방법과 애플리케이션의 안전 설정을 변경하는 방법을 설명합니다.

안전 필터

Gemini API의 조정 가능한 안전 필터는 다음 카테고리를 다룹니다.

이러한 필터를 사용하여 사용 사례에 맞게 필터를 조정할 수 있습니다. 예를 들어 비디오 게임 대화를 개발하는 경우 게임의 특성상 위험으로 평가된 콘텐츠를 더 허용해도 된다고 간주할 수 있습니다.

조정 가능한 안전 필터 외에도 Gemini API에는 아동 안전을 위협하는 콘텐츠와 같은 핵심 피해에 대한 보호 기능이 내장되어 있습니다. 이러한 유형의 피해는 항상 차단되며 조정할 수 없습니다.

콘텐츠 안전 필터링 수준

Gemini API는 콘텐츠가 안전하지 않을 확률 수준을 HIGH, MEDIUM, LOW 또는 NEGLIGIBLE로 분류합니다.

Gemini API는 심각도가 아닌 콘텐츠가 안전하지 않을 확률을 기준으로 콘텐츠를 차단합니다. 일부 콘텐츠는 피해의 심각도가 여전히 높더라도 안전하지 않을 가능성이 낮을 수 있으므로 이 점을 고려해야 합니다. 예를 들어 문장을 비교해 보겠습니다.

1. 로봇이 나를 때렸습니다.
2. 로봇이 나를 베었습니다.

첫 번째 문장은 안전하지 않을 확률이 높을 수 있지만 두 번째 문장이 폭력 면에서 더 높은 심각도로 간주할 수 있습니다. 따라서 최종 사용자에게 미치는 피해를 최소화하면서 주요 사용 사례를 지원하는 데 필요한 적절한 차단 수준을 신중하게 테스트하고 고려하는 것이 중요합니다.

요청당 안전 필터링

API에 대한 각 요청의 안전 설정을 조정할 수 있습니다. 요청하면 콘텐츠가 분석되고 안전 등급이 지정됩니다. 안전 등급에는 카테고리 및 위험 분류 확률이 포함됩니다. 예를 들어 괴롭힘 카테고리가 확률이 높아 콘텐츠가 차단되었다면 반환된 안전성 등급은 카테고리가 HARASSMENT이고 피해 확률은 HIGH로 설정됩니다.

기본적으로 안전 설정은 모든 필터에서 안전하지 않을 가능성이 보통 이상인 콘텐츠 (메시지 포함)를 차단합니다. 이 기준 안전성은 대부분의 사용 사례에 적합하도록 설계되었으므로 애플리케이션에 일관되게 필요한 경우에만 안전 설정을 조정해야 합니다.

다음 표에서는 각 카테고리에서 조정할 수 있는 블록 설정을 설명합니다. 예를 들어 증오심 표현 카테고리의 차단 설정을 소수 차단으로 설정하면 증오심 표현 콘텐츠일 가능성이 높은 모든 콘텐츠가 차단됩니다. 하지만 가능성이 낮은 모든 항목이 허용됩니다.

정책을 설정하지 않으면 기본 차단 설정은 모든 카테고리에 대해 일부 차단입니다.

생성형 서비스에 전송하는 각 요청에 대해 이러한 설정을 지정할 수 있습니다. 자세한 내용은 HarmBlockThreshold API 참조를 확인하세요.

안전 피드백

generateContent는 안전 피드백을 포함하는 GenerateContentResponse를 반환합니다.

프롬프트 피드백은 promptFeedback에 포함되어 있습니다. promptFeedback.blockReason가 설정되면 메시지 콘텐츠가 차단됩니다.

응답 후보 의견은 finishReason 및 safetyRatings에 포함됩니다. 응답 콘텐츠가 차단되고 finishReason가 SAFETY이면 safetyRatings를 검사하여 자세한 내용을 확인할 수 있습니다. 차단된 콘텐츠는 반환되지 않습니다.

안전 설정 조정

이 섹션에서는 Google AI Studio와 코드에서 안전 설정을 조정하는 방법을 설명합니다.

Google AI Studio

Google AI Studio에서 안전 설정을 조정할 수 있지만 사용 중지할 수는 없습니다.

Run settings(실행 설정) 패널에서 Edit safety settings(안전 설정 수정)를 클릭하여 Run safety settings(안전 설정 실행) 모달을 엽니다. 모달에서 슬라이더를 사용하여 안전 카테고리별로 콘텐츠 필터링 수준을 조정할 수 있습니다.

요청을 보내는 경우 (예: 모델에 질문) 요청의 콘텐츠가 차단되면 warning 콘텐츠 없음 메시지가 표시됩니다. 자세한 내용을 보려면 포인터를 콘텐츠 없음 텍스트 위로 가져가고 warning 안전을 클릭합니다.

Gemini API SDK

다음 코드 스니펫은 GenerateContent 호출에서 안전 설정을 지정하는 방법을 보여줍니다. 이렇게 하면 괴롭힘 (HARM_CATEGORY_HARASSMENT) 및 증오심 표현 (HARM_CATEGORY_HATE_SPEECH) 카테고리가 BLOCK_LOW_AND_ABOVE로 설정되어 괴롭힘 또는 증오심 표현일 가능성이 낮거나 높은 콘텐츠를 차단합니다.

from google.generativeai.types import HarmCategory, HarmBlockThreshold

model = genai.GenerativeModel(model_name='gemini-1.5-flash')
response = model.generate_content(
    ['Do these look store-bought or homemade?', img],
    safety_settings={
        HarmCategory.HARM_CATEGORY_HATE_SPEECH: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
        HarmCategory.HARM_CATEGORY_HARASSMENT: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
    }
)

model := client.GenerativeModel("gemini-1.5-flash")

model.SafetySettings = []*genai.SafetySetting{
  {
    Category:  genai.HarmCategoryHarassment,
    Threshold: genai.HarmBlockOnlyLowAndAbove,
  },
  {
    Category:  genai.HarmCategoryHateSpeech,
    Threshold: genai.HarmBlockOnlyLowAndAbove,
  },
}

import { HarmBlockThreshold, HarmCategory } from "@google/generative-ai";

// ...

const safetySetting = [
  {
    category: HarmCategory.HARM_CATEGORY_HARASSMENT,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
  {
    category: HarmCategory.HARM_CATEGORY_HATE_SPEECH,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
];

const model = genAi.getGenerativeModel({ model: "gemini-1.5-flash", safetySettings });

import { HarmBlockThreshold, HarmCategory } from "@google/generative-ai";

// ...

const safetySetting = [
  {
    category: HarmCategory.HARM_CATEGORY_HARASSMENT,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
  {
    category: HarmCategory.HARM_CATEGORY_HATE_SPEECH,
    threshold: HarmBlockThreshold.BLOCK_LOW_AND_ABOVE,
  },
];

const model = genAi.getGenerativeModel({ model: "gemini-1.5-flash", safetySettings });

final safetySettings = [
  SafetySetting(HarmCategory.harassment, HarmBlockThreshold.low),
  SafetySetting(HarmCategory.hateSpeech, HarmBlockThreshold.low),
];
final model = GenerativeModel(
  model: 'gemini-1.5-flash',
  apiKey: apiKey,
  safetySettings: safetySettings,
);

val harassmentSafety = SafetySetting(HarmCategory.HARASSMENT, BlockThreshold.LOW_AND_ABOVE)

val hateSpeechSafety = SafetySetting(HarmCategory.HATE_SPEECH, BlockThreshold.LOW_AND_ABOVE)

val generativeModel = GenerativeModel(
    modelName = "gemini-1.5-flash",
    apiKey = BuildConfig.apiKey,
    safetySettings = listOf(harassmentSafety, hateSpeechSafety)
)

SafetySetting harassmentSafety = new SafetySetting(HarmCategory.HARASSMENT,
    BlockThreshold.LOW_AND_ABOVE);

SafetySetting hateSpeechSafety = new SafetySetting(HarmCategory.HATE_SPEECH,
    BlockThreshold.LOW_AND_ABOVE);

GenerativeModel gm = new GenerativeModel(
    "gemini-1.5-flash",
    BuildConfig.apiKey,
    null, // generation config is optional
    Arrays.asList(harassmentSafety, hateSpeechSafety)
);

GenerativeModelFutures model = GenerativeModelFutures.from(gm);

다음 단계

• 전체 API에 대해 자세히 알아보려면 API 참조를 확인하세요.
• LLM으로 개발할 때 안전 고려사항에 관한 일반적인 내용은 안전 안내를 참조하세요.
• 확률과 심각도를 비교하는 Jigsaw팀 자세히 알아보기
• Perspective API와 같이 안전 솔루션에 기여하는 제품에 관해 자세히 알아보세요. * 이러한 안전 설정을 사용하여 유해 분류 기준을 만들 수 있습니다. 시작하려면 분류 예를 참고하세요.