코드베이스

이 문서에서는 리소스 및 컨텍스트 탭 안의 코드베이스 기능을 설명합니다. 소스 코드를 ZIP 파일로 만들어 업로드하면 소스 코드를 워크스페이스에 등록할 수 있으며, AI가 코드 내용을 참조하면서 질문에 답변하거나 워크플로를 실행할 수 있게 됩니다. GitHub 리포지토리와의 연동은 GitHub 연동 참조.

사전 조건

작업

필요한 권한

ZIP 파일 업로드

전체 구성원

코드베이스 삭제

관리자 / 소유자

ZIP 파일로 업로드하기

워크스페이스 페이지에서 리소스 및 컨텍스트 탭을 선택하십시오.
코드베이스를 선택하십시오.
업로드 영역에 ZIP 파일을 드래그 앤 드롭하거나, 영역을 클릭하여 파일을 선택하십시오.
업로드 진행 상황이 백분율로 표시됩니다. 완료 후 자동으로 인덱스 처리가 시작됩니다.
상태가 {n}개 인덱싱됨으로 바뀌면 코드베이스를 사용할 수 있습니다.

지원 형식은 ZIP(.zip)뿐입니다. ZIP 파일은 최대 200 MB, 압축 해제 후 합계 크기는 최대 5 GB, ZIP 안의 파일 수는 100,000개까지입니다.

ZIP 파일 업로드는 AI 사용량을 소비합니다. 사용 한도에 도달하면 업로드할 수 없게 됩니다. 또한 스토리지 사용량이 한도의 80%에 도달하면 경고가 표시되며, 한도를 초과한 경우 신규 업로드가 비활성화됩니다.

지원하는 파일 형식

인덱싱 대상이 되는 파일의 확장자는 다음과 같습니다.

코드 파일: .ts / .tsx / .js / .jsx / .py / .go / .java / .rb / .rs / .c / .h / .cpp / .hpp / .cc / .cxx / .cs / .kt / .kts / .swift / .php / .sh / .sql

설정·문서 파일: .yml / .yaml / .toml / .json / .md / .txt

node_modules/ / .git/ / dist/ / build/ 등의 디렉터리, 테스트 파일·잠금 파일은 자동으로 제외됩니다.

인덱스 상태

상태

설명

준비 완료

추출이 완료된 상태

인덱싱 대기 중

인덱스 처리 시작을 기다리는 상태

인덱싱 중 ({처리됨}/{합계})

파일을 분석·인덱싱하는 중. 처리된 파일 수/전체 파일 수가 표시됩니다

{n}개 인덱싱됨

인덱스 처리가 완료되어 사용 가능한 상태

인덱싱 실패

인덱스 처리에서 오류가 발생한 상태

실패

업로드 또는 압축 해제 처리에서 오류가 발생한 상태

코드베이스 삭제하기

ZIP 아카이브로 등록한 코드베이스를 삭제합니다. GitHub 리포지토리를 사용한 코드베이스의 삭제는 GitHub 연동 참조.

워크스페이스 페이지에서 리소스 및 컨텍스트 탭을 선택하십시오.
코드베이스를 선택하십시오.
삭제할 코드베이스의 오른쪽 끝에 있는 메뉴()를 클릭하십시오.
삭제를 클릭하십시오.

문제 해결

업로드 시 오류

오류 메시지

해결 방법

.zip 파일을 업로드하세요

소스 코드를 .zip 형식으로 압축한 후 업로드하십시오.

File size exceeds maximum allowed size of 200MB

node_modules/나 dist/ 등 불필요한 디렉터리를 제외하여 200 MB 이내가 되도록 ZIP을 다시 생성하십시오.

Failed to fetch

페이지를 새로 고침한 후 다시 업로드하십시오.

스토리지 한도를 초과했습니다

조직의 스토리지 용량이 한도에 도달했습니다. 불필요한 코드베이스를 삭제하여 스토리지를 확보하십시오. 한도 상향이 필요한 경우 조직의 관리자(소유자)에게 문의하십시오.

사용 한도에 도달했습니다. 한도를 늘리려면 관리자에게 문의하세요.

조직의 AI 사용량이 한도에 도달했으므로 조직의 관리자(소유자)에게 문의하십시오.

압축 해제 시 오류

업로드 후 상태가 인덱싱 실패 또는 실패가 되는 경우, 다음 원인을 생각할 수 있습니다. 코드베이스를 한 번 삭제한 후, 원인에 따라 ZIP을 수정하여 다시 업로드하십시오.

원인

해결 방법

ZIP 안의 파일 수가 100,000개를 초과함

테스트 파일이나 캐시 파일을 제외하여 100,000개 이내가 되도록 ZIP을 다시 생성하십시오

ZIP 안에 200 MB를 초과하는 개별 파일이 포함됨

해당 파일을 제외하여 ZIP을 다시 생성하십시오

압축 해제 후 합계 크기가 5 GB를 초과함

코드베이스를 분할하거나 불필요한 파일을 제외하여 ZIP을 다시 생성하십시오

Windows의 ZIP 도구로 생성한 ZIP에 드라이브 문자(C:\ 등)가 포함됨

Unix/Linux 환경 또는 표준적인 ZIP 도구로 다시 생성하십시오

ZIP에 심볼릭 링크가 포함됨

심볼릭 링크를 실체 파일로 교체한 후 ZIP을 다시 생성하십시오

인덱스 처리 오류

상황

원인

해결 방법

상태가 인덱싱 실패인 채로 바뀌지 않음

임베딩 처리 중에 오류가 발생함

코드베이스를 한 번 삭제한 후 다시 업로드하십시오. 반복해서 발생하는 경우 지원팀에 문의하십시오

인덱싱 대기 중이 오랫동안 지속됨

처리 대기열이 혼잡함

잠시 기다린 후 상황을 확인하십시오. 해소되지 않는 경우 지원팀에 문의하십시오

이전리소스 및 컨텍스트 개요 다음파일

마지막 업데이트 1개월 전