3.3. 에이전트 프로필¶

Backend.AI GO는 커뮤니티가 공유하는 사전 구성된 프로필을 검색하고 설치하거나, 직접 만들 수 있는 에이전트 프로필 시스템을 제공합니다.

에이전트 프로필이란?¶

에이전트 프로필은 Cowork 에이전트의 동작 방식을 정의하는 구성입니다. 각 프로필에는 다음이 포함됩니다:

시스템 프롬프트: 에이전트의 성격과 전문성을 형성하는 지침
도구 구성: 활성화된 도구와 해당 권한 설정
모델 선호도: 프로필의 사용 사례에 권장되는 모델
설정 오버라이드: 온도, 최대 토큰 수, 서브 에이전트 제한 등의 사용자 정의 설정

프로필 접근하기¶

사이드바에서 Cowork 아이콘을 클릭합니다.
Cowork 패널에서 프로필 선택기를 엽니다.
로컬 또는 커뮤니티 탭에서 프로필을 탐색합니다.

프로필 선택기는 사용 가능한 모든 프로필을 표시합니다. 로컬 탭에는 설치 및 사용자 정의 프로필이, 커뮤니티 탭에는 활성화된 레지스트리 소스의 프로필이 표시됩니다.

커뮤니티 프로필 설치하기¶

레지스트리에서 프로필을 설치하려면:

Community 탭에서 사용 가능한 프로필을 탐색합니다.
프로필 설명과 태그를 읽고 필요에 맞는 프로필을 찾습니다.
프로필 카드의 Install 버튼을 클릭합니다.
설치가 완료될 때까지 대기합니다.

설치가 완료되면 프로필이 커뮤니티 배지 표시와 함께 로컬 탭에 나타납니다.

프로필 정보¶

각 프로필 카드는 다음을 표시합니다:

이름: 프로필의 표시 이름
설명: 프로필이 수행하도록 설계된 작업
태그: 카테고리 및 기능 (예: "research", "coding", "web-search")
소스: 프로필이 제공되는 레지스트리 소스
설치 상태: 프로필이 이미 설치되었는지 여부

여러 소스가 활성화된 경우 Community 탭 헤더의 필터 칩을 사용하여 소스별로 프로필을 필터링할 수 있습니다.

레지스트리 새로고침¶

레지스트리 인덱스는 네트워크 요청을 줄이기 위해 1시간 동안 로컬에 캐시됩니다. 목록을 강제로 새로고침하려면:

Community 탭 헤더의 Refresh 버튼을 클릭합니다.
레지스트리가 최신 인덱스를 가져올 때까지 대기합니다.

레지스트리 소스 관리¶

Backend.AI GO는 여러 레지스트리 소스를 지원하여 다양한 GitHub 저장소에서 프로필을 검색하고 설치할 수 있습니다.

기본 소스¶

기본적으로 Backend.AI GO는 다음 공식 커뮤니티 레지스트리를 포함합니다:

https://github.com/lablup/agent-catalog

이 소스는 제거할 수 없으며 검증된 커뮤니티 기여 프로필을 제공합니다.

사용자 정의 소스 추가¶

사용자 정의 레지스트리 소스를 추가하려면:

Settings (사이드바의 톱니바퀴 아이콘)으로 이동합니다.
설정 메뉴에서 Agent Registry Sources를 선택합니다.
Add Source를 클릭합니다.
GitHub 저장소 세부 정보를 입력합니다:
- Repository Owner: GitHub 사용자 이름 또는 조직 (예: lablup)
- Repository Name: 저장소 이름 (예: agent-catalog)
- Branch: 브랜치 이름 (예: main)
- Label: 이 소스의 표시 이름 (예: "My Custom Profiles")
Add를 클릭하여 검증 및 저장합니다.

소스는 추가되기 전에 검증됩니다. 저장소 루트에 유효한 index.json 파일이 있어야 합니다.

소스 관리¶

Agent Registry Sources 설정 페이지에서 다음을 수행할 수 있습니다:

소스 토글: 소스를 제거하지 않고 활성화 또는 비활성화
소스 편집: 사용자 정의 소스의 레이블 또는 브랜치 업데이트
소스 제거: 사용자 정의 소스 삭제 (기본 소스는 제거할 수 없음)

비활성화된 소스의 프로필은 Community 탭에 표시되지 않습니다.

사용자 정의 레지스트리 형식¶

사용자 정의 레지스트리는 에이전트 프로필 레지스트리 형식을 따라야 합니다.

오프라인 동작¶

각 레지스트리 소스는 stale-while-revalidate 캐싱 전략을 사용합니다:

온라인: 첫 번째 액세스 시 최신 인덱스를 가져온 다음 1시간 동안 캐시 사용
오프라인: 사용 가능한 경우 마지막 캐시된 인덱스 사용
캐시 누락: 캐시된 데이터가 없고 네트워크를 사용할 수 없는 경우 오류 표시

여러 소스가 구성된 경우 실패한 소스는 경고 배너를 표시하지만 성공적으로 가져온 소스는 계속 작동합니다.

개인정보 보호 및 보안¶

커뮤니티 프로필은 공개 GitHub 저장소에서 가져옵니다
프로필 설치는 로컬 전용입니다(원격 측정 또는 추적 없음)
설치하기 전에 항상 프로필 설명과 권한을 검토하세요
공식 레지스트리의 프로필은 유지 관리자가 검토합니다

프로필 기여하기

커뮤니티 레지스트리에 자신의 에이전트 프로필을 기여하려면 agent-catalog 저장소에 풀 리퀘스트를 제출하세요.

문제 해결¶

프로필 설치 실패¶

해결 방법: 에이전트 프로필 디렉터리에 대한 쓰기 권한이 있는지 확인하세요. 자세한 내용은 오류 메시지를 확인하세요.

레지스트리 인덱스 로드 실패¶

해결 방법: 네트워크 연결을 확인하세요. 오프라인인 경우 앱은 사용 가능한 캐시된 데이터를 사용하려고 시도합니다. 일부 소스만 실패하는 경우 Community 탭의 경고 배너에서 소스별 오류 세부 정보를 확인하세요.

사용자 정의 소스 검증 실패¶

해결 방법: GitHub 저장소가 존재하고 공개되어 있으며 지정된 브랜치의 저장소 루트에 유효한 index.json 파일이 있는지 확인하세요.

설치 후 프로필이 나타나지 않음¶

해결 방법: 로컬 탭으로 이동하여 새로고침을 클릭하여 로컬 프로필 목록을 새로고침하세요.