태그 및 사용자 정의 메타데이터

접근 태그(Access Tags)는 누가 볼 수 있는지 결정합니다. 사용자 정의 메타데이터(Custom Metadata)는 문서가 무엇에 관한 것인지 기술합니다. 둘은 UI에서 비슷해 보이지만 다른 문제를 해결합니다 — 접근 태그를 메타데이터의 대체재로 사용하지 마세요(그 반대도 마찬가지).

전제 조건

작업	필요한 것
팀 태그 생성	My Account → Tags 접근 (태그 카탈로그의 팀 관리자 경로)
사람에게 태그 할당	Team Management에서 멤버 편집 권한
문서에 접근 태그 적용	지식 베이스 리소스 편집 권한
문서의 사용자 정의 메타데이터 편집	리소스 편집 권한
에이전트가 검색 가능한 메타데이터로 필터링하게 하기	Custom Metadata Filtering이 활성화된 Knowledge Base 툴킷이 있는 에이전트

접근 태그

무엇인가

태그는 누가 문서를 볼 수 있는지를 제어합니다 — 배지 시스템입니다. 문서는 배지를 요구하여 열 수 있게 하거나, 특정 배지를 가진 사람을 차단할 수 있습니다.

태그는 가시성과 접근 통제를 위해 존재합니다. 태그는 부서나 주제로 이름을 붙일 수 있지만, 그저 레이블일 뿐입니다 — 유일한 실제 효과는 누가 그 문서를 (볼 수 있고 또는) 볼 수 없는지입니다. 사용자 정의 메타데이터처럼 문서를 정리하거나, 분류하거나, 필터링하지 않습니다.

처음부터 끝까지의 설정

1. My Account → Tags에서 태그 카탈로그를 만듭니다 (예: HR-Only, Sales-Team, Finance-Confidential).
2. 팀 멤버를 편집할 때 멤버에게 태그를 할당합니다 (역할을 변경하는 바로 그곳). 각 멤버는 하나 이상의 태그를 가질 수 있습니다.
3. 리소스 세부 정보 페이지 → Access Tags → Edit Access Tags에서 문서에 태그를 적용합니다 (Document Access Control이 열림).

문서에서의 모드

모드	UI 레이블	효과
허용	Allow Only	사용자는 문서를 보려면 나열된 태그 중 최소 하나를 보유해야 함
차단	Allow None	나열된 태그 중 어느 하나라도 보유한 사용자는 차단됨 — 다른 경우에는 접근 가능했더라도

경험 규칙:

• 문서에 접근 태그가 없으면 프로젝트에 접근할 수 있는 모든 사람이 볼 수 있습니다 — 태그는 적용될 때만 제한합니다
• 두 모드가 같은 사람에게 모두 적용될 수 있을 때, 차단은 언제나 허용보다 우선합니다
• 문서 모달이 상기시킵니다: 카탈로그가 비어 있으면 My Account → Tags에서 태그를 만드세요

예제: 급여 검토 문서를 업로드하고 Allow Only: HR-Only를 설정하세요. HR-Only 태그를 가진 사용자는 그것을 열고 검색할 수 있지만, 그 태그가 없는 사람은 검색 결과나 채팅 답변에서 보지 못합니다.

참고: 접근 태그는 AI 기반 검색과 채팅 답변에 무엇이 나타나는지를 관장합니다(EKB Runtime의 search_knowledge와 해당 사용자로서의 ask_* 포함). 올바른 프로젝트 수준 접근 위에 추가된 계층으로 취급하세요 — 대체재가 아니라.

언제 접근 태그를 사용할지

• 기밀이거나 민감한 문서 (인사 기록, 급여, 법률, 재무 데이터)
• 같은 프로젝트 안에서 회사 전체에 보이면 안 되는 부서 전용 자료
• 특정 역할 또는 보안 등급만을 위한 문서

일상적인 정리 — 부서, 주제, 타입별 정렬 — 에는 아래의 사용자 정의 메타데이터를 사용하세요.

사용자 정의 메타데이터

무엇인가

사용자 정의 메타데이터는 문서에 기술적 레이블을 부착합니다 — Department: Engineering, Author: Jane Smith, Version: 2.1 같은 사실들. *"누가 볼 수 있는가?"*가 아니라 *"이 문서는 무엇에 관한 것인가?"*에 답합니다.

리소스의 Details 탭에서 사용자 정의 메타데이터는 두 섹션으로 나타납니다:

섹션	UI 레이블	역할
자동 / 커넥터 필드	AI-Searchable	자동 채워지고(예: SharePoint 라이브러리 열에서) 에이전트 검색을 위해 색인됨
수동 필드	User-Defined	Add Field로 추가 — 참고용일 뿐이며 에이전트가 검색할 수 없음

두 타입 한눈에 보기

	User-Defined (수동)	AI-Searchable (자동 수집)
추가 방식	문서에서 Add Field	이미 열/필드가 있는 연결된 소스에서 가져올 때 수집
검색 결과 필터?	아니오 — 참고용	예 — 검색을 좁힐 수 있는 타입
표시	User-Defined	AI-Searchable

에이전트: 사용자 정의 메타데이터 필터링

에이전트의 Knowledge Base 툴킷 구성에서 Custom Metadata Filtering(enable_metadata_filtering)을 켜면:

• 지식 검색 도구에 metadata_filter 매개변수가 추가됩니다
• 사용 가능한 메타데이터 필드/값을 나열하는 도구가 추가됩니다

에이전트가 의도적으로 검색을 특정 검색 가능한 메타데이터(예: SharePoint 열)를 가진 문서로 제한하는 방식이 이것입니다. 일치는 퍼지가 아닌 정확 일치입니다 — 값을 일관되게 유지하세요 (Eng나 eng. dept가 아니라 Engineering).

플랫 필드만

메타데이터 필드는 플랫하고 단수 레벨의 레이블입니다 — 중첩된 범주가 아닙니다. Department: Engineering은 가질 수 있지만, Department → Team → Sub-team 같은 하나의 중첩 구조는 가질 수 없습니다.

두 번째 세부 레벨이 필요하면 두 번째 필드를 추가하세요 (예: Department 옆에 Sub-Team). 필터링 시 둘은 여전히 조합할 수 있습니다.

빠른 비교

	접근 태그	사용자 정의 메타데이터
목적	누가 문서를 볼 수 있는지 제어	문서가 무엇에 관한 것인지 기술
최적 용도	기밀성 및 접근 통제	정리 및 정밀 검색
검색 / 채팅에 영향	예 — 접근 없는 사용자에게 제한된 문서는 숨김	AI-Searchable 필드만 검색을 좁힘 (에이전트에 필터링 활성화 시)
설정 방법	태그 카탈로그 + 멤버 할당 + 문서 Edit Access Tags	Add Field, 또는 커넥터 가져오기 시 자동 수집
카탈로그 위치	My Account → Tags	문서별 (그리고 소스 시스템 열)

문제 해결

증상	확인할 사항
Edit Access Tags에 태그가 없음	먼저 My Account → Tags에서 태그를 만드세요
사용자가 여전히 제한된 문서를 봄	사용자에게 할당된 태그, 문서의 Allow Only / Allow None, 차단 우선 규칙이 의도와 반대로 뒤집혀 있지 않은지 확인
사용자가 보아야 할 문서를 보지 못함	Allow Only 태그가 부족하거나 Allow None 태그를 보유하고 있을 수 있음
에이전트가 부서로 필터링하지 않음	필드가 AI-Searchable인지, 값이 일관적인지, KB 툴킷에 Custom Metadata Filtering이 활성화됐는지 확인
수동 메타데이터가 답변에 영향을 주지 않음	User-Defined 필드의 예상된 동작 — 참고용일 뿐입니다

관련 문서

• 태그 (팀 카탈로그)
• 지식 베이스 개요
• EKB Runtime