Waafir
이 페이지는 사람의 검토를 기다리는 기계 번역입니다. 오류가 있을 수 있습니다.

waafir-redact 참조

waafir-redact 서버는 연결된 AI 클라이언트에 Waafir의 가림 처리 기능을 두 가지 형태로 제공합니다.

  • redact_text — 텍스트 블록을 인라인으로 가림 처리하여 즉시 반환합니다.
  • redact_file / redact_file_status — 데이터룸의 문서 전체에서 PII를 분석하고 사람의 검토를 위해 준비합니다.

문서에 가림 처리를 적용하는 기능은 의도적으로 MCP에서 제공하지 않습니다. 적용하면 다른 모든 당사자가 파일을 열 때 보는 내용이 바뀌므로, 사람이 AI 가림 처리 검토 화면에서 승인해야 합니다. 이 서버의 어떤 도구도 독자에게 보이는 내용을 바꾸지 않습니다.

연결: https://app.waafir.io/api/mcp/waafir 또는 영역 서버 https://app.waafir.io/api/mcp/waafir-redact. 도구 이름은 두 곳에서 동일합니다. 설정을 참조하세요. redact_text에는 read 범위(또는 그 이상)의 PAT만 있으면 됩니다. 데이터룸을 다루지 않으므로 파일별 또는 데이터룸별 검사를 통과할 필요가 없습니다(단, 모델을 실행하는 모든 도구와 마찬가지로 유료 플랜과 AI 활성화는 여전히 필요합니다).

두 문서 도구는 모두 딜 팀 전용입니다. redact_file에는 write 범위와 해당 데이터룸의 딜 팀 구성원 자격이 필요합니다. redact_file_status 역시 읽기만 하지만 마찬가지입니다. read 범위의 PAT는 필요 조건이지만 충분 조건은 아닌데, 가림 처리 작업이 존재한다는 사실 자체가 문서에 관한 정보이기 때문입니다. 딜 팀 외부의 호출자는 토큰의 범위와 관계없이 FORBIDDEN을 받습니다. 토큰 범위는 토큰의 상한이고, 딜 팀 구성원 자격은 사람의 상한입니다. 두 가지를 모두 충족해야 합니다.

redact_text

텍스트 블록에서 PII를 가림 처리합니다. 텍스트는 조직의 가림 처리 에이전트가 처리하며, 도구는 가림 처리된 텍스트와 식별한 엔터티 목록을 함께 반환합니다. 필요하면 결과를 특정 엔터티 유형으로 좁힐 수 있습니다.

입력

필드유형필수설명
textstring예가림 처리할 텍스트(비어 있으면 안 됨).
typesstring[]아니요가림 처리를 이 PII 유형으로 제한합니다. 생략하면 감지된 모든 항목을 가림 처리합니다.

출력

{ redacted_text, entities, truncated, processed_chars, total_chars, max_chars,
  filtered_out_count, unclassified_redacted_count, unclassified_types,
  filter_exact }
  • redacted_text — 분석된 텍스트로, 민감한 부분이 검게 가려져 있습니다.
  • entities — 제거된 PII. type은 가림 처리 모델이 사용한 레이블이고, canonical_type은 이에 대응하는 표준 유형이며 분류할 수 없는 경우 null입니다.
  • truncated / processed_chars / total_chars / max_chars — 크기 제한을 참조하세요.
  • filtered_out_count / unclassified_redacted_count / unclassified_types / filter_exact — 유형별 필터링을 참조하세요.

가림 처리는 조직 자체의 가림 처리 구성에 따라 실행되므로, 결과는 제품에서 사용하는 것과 동일한 에이전트를 반영합니다. 이 인터페이스의 모든 작업과 마찬가지로 호출은 토큰 소유자로서 실행되며 해당 조직으로 범위가 제한됩니다.

크기 제한

처음 80,000자만 분석됩니다. 이는 항상 그래 왔으며, 이제 결과에서 이를 알려 줍니다. truncated가 true이면 processed_chars 이후의 텍스트는 전혀 검사되지 않은 것이므로, 응답을 전체 입력에 대한 가림 처리로 간주하지 마세요. 나머지 부분은 후속 호출로 보내세요.

유형별 필터링

types는 다음 값만 허용합니다.

name, email, phone, ssn, account, address, financial, confidential, url, username

⚠️ 호환성이 깨지는 변경(2026년 8월). types는 이전에는 모든 문자열을 허용했습니다. 이제는 위의 값만 허용하며, 그 밖의 값("emails", "PII", "credit-card" 또는 "EMAIL"처럼 대소문자가 다른 값)은 모두 유효성 검사 오류를 반환합니다.

이는 조용한 실패를 눈에 띄는 실패로 바꾼 것입니다. 이전에는 인식할 수 없는 값이 아무것과도 일치하지 않았기 때문에, 도구가 아무것도 가림 처리하지 않고 성공 응답 안에 원본 텍스트를 redacted_text로 반환했습니다. types를 전달하는 경우 값을 위 목록에 맞게 매핑하세요. types를 생략한 호출은 영향을 받지 않습니다.

요청하지 않았는데도 가림 처리되는 엔터티 유형이 하나 있습니다. 가림 처리 모델이 우리가 인식할 수 없는 유형으로 레이블을 지정한 경우, 해당 엔터티는 제외되지 않고 그대로 가림 처리됩니다. 그것이 요청한 범위를 벗어난다는 것을 증명할 수 없고, 텍스트에 PII를 남기는 것이 더 큰 실수이기 때문입니다. 이 경우:

  • filter_exact는 false입니다(필터가 정확히 적용되면 항상 true).
  • unclassified_redacted_count는 영향을 받은 엔터티 수를 나타냅니다.
  • unclassified_types는 관련된 레이블을 나열합니다.

의도적으로 필터링해 제외한 엔터티는 filtered_out_count에 별도로 집계됩니다.

요구 사항: 유료 플랜이어야 하며 조직의 AI 기능이 활성화되어 있어야 합니다(기본값은 켜짐이며, 조직 관리자가 설정 → AI & 통합에서 끌 수 있습니다). 조직이 일일 AI 사용 한도에 도달했거나 Waafir가 해당 기능을 일시 중지한 동안에도 호출이 거부되며, 오류 메시지에 어떤 경우인지 표시됩니다.

redact_file

데이터룸의 문서 전체에서 PII를 분석합니다. 이 도구는 분석만 합니다. 문서는 변경되지 않으며, 누구에게 보이는 내용도 바뀌지 않습니다. 분석은 비동기식이므로 redact_file_status를 폴링하세요.

입력

필드유형필수설명
file_idstring예파일의 UUID.
override_redactedboolean아니요이미 가림 처리된 문서를 다시 분석합니다. 지정하지 않으면 이미 가림 처리된 파일은 거부됩니다.

출력

{ file_id, job_id, status: "analysis_started", applied: false,
  review_required: true, review_with, apply_via }

설계상 auto_apply 옵션은 없습니다. 이 페이지 상단의 안내를 참조하세요. 이미지 파일은 지원되지 않습니다.

요구 사항: write 범위의 PAT, 해당 데이터룸의 딜 팀 구성원 자격, 유료 플랜, 그리고 조직의 AI 기능 활성화(기본값은 켜짐이며, 조직 관리자가 설정 → AI & 통합에서 끌 수 있습니다).

아직 검사 중인 파일. 파일이 Waafir가 아직 검사를 마치지 않은 새 업로드 또는 새 버전이면 redact_file과 redact_apply는 error.reason: "ACTIVATION_PENDING" 및 메시지 This file is still being checked. Try again shortly.와 함께 UNAVAILABLE을 반환합니다. 아무것도 분석되거나 적용되지 않으므로 잠시 기다린 후 다시 호출하세요.

redact_file_status

문서 가림 처리 분석 상태를 확인합니다.

입력

필드유형필수설명
file_idstring예파일의 UUID.

출력

{ file_id, status, entity_count?, applied: false, apply_via }
  • status — idle, analyzing, applying, review_ready, completed, failed, error 중 하나. applying과 completed는 사람이 Waafir UI에서 가림 처리를 적용하고 있음을 나타냅니다. MCP에서는 이 상태로 만들 수 없지만, 폴링하는 동안 누군가 검토를 승인하면 이 상태를 보게 됩니다.
  • entity_count — 검토가 준비되었을 때 분석이 제안한 PII 엔터티 수.
  • applied는 항상 false입니다. 가림 처리의 승인과 적용은 Waafir UI에서 이루어집니다.

인식할 수 없는 status는 오류가 아니라 "계속 폴링"으로 취급하세요. 최종 상태는 작업 마커가 정리되기 전까지 잠시만 유지되므로, 늦게 도착한 폴러는 기다리던 상태 대신 idle(또는 재구성된 review_ready)을 보게 됩니다. 또한 idle은 "진행 중인 작업이 없음"을 뜻하며 "아무 일도 없었음"을 뜻하지 않습니다. 값이 고정된 목록 중 하나라고 단정하지 말고, 기한을 정해 원하는 상태를 폴링하세요.

redact_history

파일의 최신 가림 처리 분석을 엔터티 유형별 개수로 반환합니다. 가림 처리된 텍스트 자체는 절대 반환되지 않습니다.

  • 범위: read. 딜 팀 구성원이 내용을 읽을 수 있는 파일에 대해 사용합니다.
  • 입력: file_id(필수).
  • 출력: { file_id, analysis }. analysis는 { history_id, analysed_at, entities: { total, by_type } }이며, 파일이 한 번도 분석되지 않았다면 null입니다.

redact_list_terms

데이터룸의 가림 처리 용어: 항상 가림 처리하는 문구(always)와 절대 가림 처리하지 않는 문구(never).

  • 범위: read. 딜 팀 구성원.
  • 입력: dataroom_id(필수).
  • 출력: { terms }, 각 항목은 { id, term, kind, created_at }.

redact_add_term

데이터룸에 용어를 추가합니다. 데이터룸에 있는 파일의 다음 가림 처리부터 적용되며, 지금 당장은 어떤 파일도 변경하지 않습니다.

  • 범위: write. 유료 플랜의 딜 팀 구성원.
  • 입력: dataroom_id, term(모두 필수), kind(always 또는 never, 기본값 always).
  • 출력: { term }.

redact_remove_term

데이터룸에서 용어를 제거합니다. 지금 당장은 어떤 파일도 변경하지 않으며, 용어를 다시 추가하면 되돌릴 수 있습니다.

  • 범위: write. 딜 팀 구성원.
  • 입력: dataroom_id, term_id(모두 필수).
  • 출력: { removed, term_id }.

redact_revert

파일의 가림 처리를 해제합니다. 투자자를 포함한 모든 독자에게 즉시 원본 문서가 다시 제공됩니다. 가림 처리된 버전은 보관되므로 다시 적용할 수 있습니다.

  • 범위: write. 딜 팀 구성원이 편집할 수 있는 파일에 대해 사용합니다.
  • 입력: file_id(필수), confirm_token.
  • 두 단계. confirm_token 없이 호출하면 아무것도 바뀌지 않고 미리보기와 토큰을 받습니다. 같은 인수와 토큰으로 다시 호출하면 되돌립니다.
  • 가림 처리되지 않은 파일은 거부됩니다(409). 분석이나 영구 적용 작업이 실행 중인 파일도 거부됩니다(409). 이는 미리보기 단계에서 안내되므로 실행할 수 없는 되돌리기에 대해서는 토큰이 발급되지 않으며, 확인할 때 검사가 다시 실행됩니다.

redact_apply

redact_file로 수행한 파일의 최신 분석을 적용합니다. 제외한 엔터티 유형은 빼고, 데이터룸의 항상 가림 처리 용어는 더합니다. 이후 투자자를 포함한 모든 독자에게 가림 처리된 문서가 제공됩니다. redact_revert로 되돌릴 수 있습니다.

  • 범위: write. 유료 플랜의 딜 팀 구성원이 내용을 읽을 수 있는 파일에 대해 사용합니다.
  • 입력: file_id(필수), exclude_types, confirm_token.
  • 두 단계. confirm_token 없이 호출하면 아무것도 바뀌지 않고 미리보기(대상의 유형별 개수만 포함하며 텍스트는 절대 포함하지 않음)와 토큰을 받습니다. 같은 인수와 토큰으로 다시 호출하면 영구 적용 작업이 시작됩니다. 그 사이에 분석, 파일, 데이터룸의 용어 또는 대상이 바뀌면 호출이 거부되며 다시 미리보기를 해야 합니다.
  • 조직에서 AI가 꺼져 있으면 Waafir에서와 마찬가지로 데이터룸에 저장된 항상 가림 처리 용어만 적용할 수 있습니다.