AIP Assist 콘텐츠 등록

등록은 콘텐츠를 Assist에서 사용할 수 있게 수집하는 단계입니다. 등록 후 기본 Assist 응답에 제공하려면 Control Panel 노출 설정이 추가로 필요합니다. Notepad는 Workshop 등에 삽입하기 쉬워 일반적으로 권장됩니다. 플랫폼 내 사용자 정의 문서가 더 적합하지만 기능이 없다면 Palantir 담당자에게 활성화를 요청합니다.

Notepad 등록

1. + New Document로 만들거나 기존 문서를 엽니다. 문서는 프로젝트에 속해야 합니다.
2. 오른쪽 위 Actions > Add to AIP Assist를 선택합니다. 새 문서가 검색 가능해질 때까지 메뉴가 나타나는 데 시간이 걸릴 수 있습니다.
3. 대화상자의 Add to AIP Assist를 켜고 구체적인 Documentation title과 Description을 적습니다.
4. Save를 선택하고 수집 성공 메시지를 확인합니다.

그다음 Control Panel에서 문서를 찾아 노출 범위를 정합니다. 사용자와 그룹의 Notepad 접근 권한을 먼저 구성해야 합니다. Assist도 기존 권한을 따릅니다. 이 기능은 모든 플랫폼 인스턴스에 제공되지 않을 수 있으므로 메뉴가 없으면 사용 가능 여부를 담당자에게 확인합니다.

문서 저장소 등록

Code Repositories에 documentation 유형 저장소가 필요합니다. 기능 활성화 또는 생성한 저장소의 허용 목록 등록은 Palantir 담당자에게 요청합니다.

1. Documentation 템플릿으로 저장소를 초기화합니다.
2. docs 아래에 제품을 나타내는 폴더를 만듭니다.
3. 해당 폴더에 overview.md를 만들고 @name, @description 다음에 Markdown 본문을 작성합니다.
4. 저장소 최상위의 _aip-assist.json을 aip-assist.json으로 이름을 바꿉니다. 기존 이름의 파일이 나중에 재생성되어도 별도 작업은 필요하지 않습니다.
5. aip-assist.json에 Assist에서 사용할 제품 폴더와 설명을 지정합니다. 설명은 어떤 질문에 문서를 검색해야 하는지 판단할 수 있도록 간결하면서도 범위를 충분히 담아야 합니다.
6. 변경을 커밋하고 검사 과정에서 문서 게시가 완료되는지 확인합니다.

갱신과 이미지

Notepad나 플랫폼 내 문서의 내용 변경은 자동으로 Assist 데이터베이스에 전파됩니다. 콘텐츠를 고칠 때마다 재등록할 필요는 없습니다.

Assist 응답에는 Palantir 공개 문서와 플랫폼 내 사용자 정의 문서의 이미지를 표시할 수 있지만 Notepad 이미지는 현재 지원하지 않습니다. 이미지 아래에 내용을 설명하는 텍스트를 적으면 검색과 응답에 사용할 수 있습니다. 응답의 인라인 인용을 선택하면 원래 문서를 열어 이미지를 확인할 수 있습니다.

Notepad 메뉴가 보이지 않을 때

빈 문서는 등록할 수 없습니다. 내용을 넣고, 특히 큰 문서를 붙여 넣었다면 전파될 시간을 둡니다. AIP가 활성화되었는지, 문서가 프로젝트에 속하는지, 프로젝트에 조직 보안 표지(Marking)가 있는지 확인합니다. 이 조건을 갖췄는데도 메뉴가 없다면 해당 플랫폼 인스턴스의 기능 제공 여부를 확인합니다.