에이전트 분석 개인정보 보호 모드
에이전트 분석 개인정보 보호 모드는 프롬프트 및 응답 텍스트가 인프라에서 벗어나는지 여부를 제어합니다. 세 가지 모드가 있습니다. full은(는) 메시지 콘텐츠를 전송하고, metadata_only은(는) 아무것도 전송하지 않으며, customer_enriched은(는) 아무것도 전송하지 않지만 사용자가 직접 계산한 품질 레이블을 사용합니다. 모든 모드는 여전히 토큰, 비용, 지연 시간, 모델 이름 및 세션 그룹화를 전송합니다.
Wide 롤아웃 전에 모드를 선택하십시오. 이 모드에 따라 법률 검토에서 다루어야 할 내용이 결정됩니다. Amplitude는 full AI SDK의 기본 PII 수정을 권장합니다. 내장 신호, 주제 및 LLM 평가자는 메시지 텍스트를 읽으므로 다른 두 모드에서는 이를 끕니다.
각 모드가 전송하는 것
full (기본값) | metadata_only | customer_enriched | |
|---|---|---|---|
메시지 콘텐츠($llm_message.text) | 전송됨 | 전송되지 않음 | 전송되지 않음 |
| 시스템 프롬프트 | 전송됨 | 전송되지 않음 | 전송되지 않음 |
| 도구 입력 및 출력 | 전송됨 | 전송되지 않음 | 전송되지 않음 |
| 점수 코멘트 | 전송됨 | 전송되지 않음 | 전송되지 않음 |
| 토큰, 비용, 지연 시간, 모델, 세션 그룹화 | 전송됨 | 전송됨 | 전송됨 |
실험 키 및 변형([Agent] Experiment*) | 전송됨 | 전송됨 | 전송됨 |
| 메시지 텍스트를 읽는 내장 신호와 평가기 | 실행 | 실행되지 않음 | 실행되지 않음 |
| 데이터 품질 문제 및 코드 평가 도구 | 실행 | 실행 | 실행 |
trackSessionEnrichment()을(를) 통해 자체 보강 | 사용 가능 | 사용 가능 | 사용 가능 |
실험 키, 변형 및 공급자는 콘텐츠가 아닌 식별자이므로 모든 모드가 이를 전송하며 PII 편집은 이를 스크러빙하지 않습니다. 플래그와 변형 이름을 사용하고 사용자 데이터를 사용하지 마십시오.
대부분의 내장 신호, 주제 및 프롬프트 기반 평가기는 메시지 텍스트를 읽습니다. 세션에 텍스트가 없는 경우, Amplitude는 추측하는 대신 [Agent] Session Record에서 결과를 제외합니다. 데이터 품질 문제 신호와 사용자가 추가한 모든 코드 평가기는 여전히 실행됩니다. 비용, 지연 시간, 토큰, 오류 및 모델 지표는 모든 모드에서 작동합니다. 각 신호가 읽는 내용에 대해서는 에이전트 분석 내장 신호를 참조하십시오.
full
메시지 콘텐츠, 시스템 프롬프트, 도구 입력 및 출력, 점수 주석은 모두 Amplitude에 도달합니다. Amplitude의 내장 보강 기능은 실행되며 가장 완전한 신호 세트를 생성합니다.
- 시스템 프롬프트는 선택 사항이므로 생략할 수 있습니다.
- AI SDK는 기본적으로 PII를 편집합니다. 이벤트가 프로세스를 떠나기 전에 이메일, 전화 번호, SSN, 신용 카드 번호, IP 주소 및 base64 이미지를 제거합니다. 패턴과 자리 표시자의 전체 목록은 PII 편집이 제거하는 내용을 참조하십시오.
metadata_only
메시지 콘텐츠, 시스템 프롬프트, 도구 페이로드 또는 점수 주석은 프로세스에 남아 있지 않습니다. 토큰, 비용, 지연 시간, 모델 이름 및 세션 그룹화는 여전히 제공되므로 콘텐츠가 필요하지 않은 분석도 여전히 작동합니다.
customer_enriched
어떤 콘텐츠도 프로세스를 떠나지 않으며, metadata_only와 동일합니다. 인프라에서 자체적으로 평가를 실행하고 trackSessionEnrichment()(Node) 또는 track_session_enrichment()(Python)을(를) 통해 결과를 전송합니다. Amplitude는 사용자가 전송한 대로 이러한 레이블을 [Agent] Session Enrichment 이벤트에 저장합니다.
모든 모드에서 세션 강화 이벤트를 전송할 수 있습니다. customer_enriched은(는) Amplitude의 콘텐츠 기반 신호에는 읽을 수 있는 텍스트가 없으므로 레이블이 세션 수준 품질 데이터의 주요 소스인 모드입니다. 자체 세션 강화 제공을 참조하십시오.
PII 삭제 기능이 제거하는 항목
full 모드에서 AI SDK는 전송되는 모든 콘텐츠 채널(메시지 텍스트, 시스템 프롬프트, 도구 입력 및 출력, 도구 정의, 추론 콘텐츠, 점수 코멘트)을 스캔하고, 이벤트가 프로세스를 벗어나기 전에 각 일치 항목을 고정된 자리 표시자로 교체합니다. Redaction은 기본적으로 활성화되어 있습니다: Node의 경우 redactPii, 버전 1.17.0부터는 Python의 경우 redact_pii입니다. 자리 표시자에는 따옴표나 백슬래시가 포함되지 않으므로 JSON 내에서 유효합니다.
| 감지된 값 | 형식이 일치합니다. | 교체 |
|---|---|---|
| 이메일 주소 | name@domain.tld 주소(악센트가 있거나 라틴 문자가 아닌 로컬 부분 포함) | [email] |
| 전화번호 | 괄호, 점, 대시 또는 스페이스를 포함할 수 있는 미국 10자리 숫자와 E.164 형식의 국제 숫자(+ 뒤에 7~15자리 숫자) | [phone] |
| 신용카드 번호 | 4개씩 그룹화된 16자리 숫자(선택적으로 대시 또는 스페이스 포함) | [credit_card] |
| 사회 보장 번호 | 하이픈(123-45-6789) 또는 공백(123 45 6789)으로 구분된 형식의 미국 사회보장번호(SSN) | [ssn] |
| IP 주소입니다. | IPv4 및 IPv6(포함: ::1 및 괄호로 묶인 URL 형식 예: http://[::1]:8080) | [ip_address] |
| Base64 이미지 | 전체 값은 data: base64 URL이거나 이미지로 사용될 만큼 충분히 긴 raw base64여야 합니다 | [base64 image redacted] |
테스트 및 보안 검토에서 예상되는 동작:
- 감지는 패턴 기반입니다. SDK는 명명된 엔티티(named-entity) 모델을 실행하지 않으므로 이름, 도로명 주소 또는 생년월일은 편집하지 않습니다. 이러한 경우에는
customRedactionPatterns또는customRedactionFn(Node) 또는custom_redaction_patterns또는custom_redaction_fn(Python)을(를) 추가하거나, Presidio와 같은 자체 스크러버를 사용하십시오. - 전화 및 SSN 감지는 미국 형식을 대상으로 합니다. 국제 전화번호는 선행
+기호가 있는 E.164 형식으로만 일치합니다. - 코드 스타일
::토큰(예:std::vector,a[::2],::Module)은 IPv6 주소로 취급되지 않습니다. - Base64 redaction은 전체 값에 적용됩니다. SDK는 원시 base64 문자열이 20자 이상이고 길이가 4의 배수이며
+,/또는=을(를) 포함하는 경우에만 마스킹하므로, ULID, 16진 토큰 및 대시가 없는 UUID는 그대로 통과합니다. 더 긴 문장에 포함된 base64 이미지는 그대로 유지됩니다. - 사용자 지정 패턴과 사용자 지정 함수는 내장 패턴 후에 실행됩니다. 사용자 지정 함수가 예외를 던지거나 비문자열을 반환하면 SDK는 전체 값을
[content redacted](으)로 바꿉니다.
편집 소스는 Node SDK에 있습니다. 편집된 요청을 전송하지 않고 검사하려면 SDK에서 검토 모드를 설정하십시오.
모드 적용
모드를 적용하는 방법은 계측 경로에 따라 다릅니다.
- AI SDK(Node, Python):
contentMode(Node) 또는content_mode(Python)을(를)AIConfig에 한 번 설정합니다. SDK는 모든 콘텐츠 포함 채널을 하나의 게이트를 통해 라우팅합니다. SDK 참조에서 개인정보 보호 모드 선택을 참조하십시오. - OpenTelemetry: OpenTelemetry 계측에서 콘텐츠 캡처를 켜거나 끕니다. 개인정보 보호 모드 적용을 참조하십시오.
- HTTP API, Batch, S3, OpenTelemetry 또는 웨어하우스 import: Amplitude는 수신 후 콘텐츠를 스크러빙(scrub)하지 않습니다.
redactPii는 AI SDK를 로드하는 프로세스 내에서만 실행됩니다. 데이터가 인프라를 떠나기 전에 패턴 마스킹, 메타데이터 전용 또는 자체 콜백, SQL, Collector 프로세서를 선택합니다. 공유 패턴은 개인정보 보호 가이드에 있으며 PII 편집이 제거하는 내용의 표와 일치합니다. Collectorreplace_pattern규칙은 더 간단한 패턴을 유사하게 구현할 수 있습니다. 이메일, IPv6 및 base64에 대한 정확한 패리티에는 이러한 공유 기능이 필요합니다.
데이터 상주
Agent Analytics는 Amplitude의 미국 및 EU 데이터 센터에서 실행됩니다. 프로젝트를 호스팅하는 데이터 센터로 이벤트를 보냅니다. 개인정보 보호 모드는 두 가지 모두에서 동일한 방식으로 적용됩니다.
| 경로 | 미국 | EU |
|---|---|---|
| AI SDK | 기본값 | EU용으로 구성된 Amplitude 클라이언트를 전달하십시오. |
| OpenTelemetry | https://api.amplitude.com/otlp/v1/traces | https://api.eu.amplitude.com/otlp/v1/traces |
| HTTP API | https://api2.amplitude.com/2/httpapi | https://api.eu.amplitude.com/2/httpapi |
amplitude-ai-register-catalog | 기본값 | 추가 --eu |
AI SDK는 표준 Amplitude 클라이언트를 통해 이벤트를 전송합니다. EU 프로젝트의 경우 해당 클라이언트를 EU에 맞게 구성하고 API 키 대신 전달하십시오:
import * as amplitude from "@amplitude/analytics-node";
import { AmplitudeAI } from "@amplitude/ai";
amplitude.init(process.env.AMPLITUDE_AI_API_KEY!, { serverZone: "EU" });
const ai = new AmplitudeAI({ amplitude });
이 내용이 도움이 되었나요?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.