- 자동화를 트리거하는 이벤트
- 이벤트가 발생할 때 ARIA가 받는 프롬프트
W&B Multi-tenant Cloud에서만 지원됩니다.ARIA는 개인 entity가 아닌 팀 프로젝트에서 동작합니다. 또한 organization admin이 Smart features를 활성화해야 합니다. 거버넌스 및 보안을 참고하세요.
Requirements
- 조직에서 ARIA가 활성화되어 있어야 합니다. Action type 목록에 Trigger ARIA가 표시되지 않는다면 해당 조직, 범위 또는 deployment에서는 ARIA를 사용할 수 없습니다. 이 경우 목록에서 별도의 설명 없이 해당 옵션이 생략됩니다. 거버넌스 및 보안을 참조하세요.
- 자동화의 범위로 지정할 프로젝트, 레지스트리 또는 컬렉션에 대한 쓰기 액세스 권한이 있어야 합니다.
- W&B 자동화의 범위를 레지스트리로 지정하고 ARIA에 프롬프트를 전송하려면 같은 조직 내의 팀에 속해 있어야 합니다. 각 ARIA 대화는 팀과 연결되므로, 해당 조직의 팀에 속해 있지 않으면 레지스트리 범위의 자동화를 만들 수 없습니다.
만들기
자동화를 더 넓은 범위에 적용하려면 전역 Automations 허브에서 자동화를 만들고 Team 또는 Organization 범위를 선택하세요. 단계는 아래 설명과 동일합니다. 이러한 범위에서는 W&B가 아티팩트 및 컬렉션 이벤트만 지원합니다. Automations 허브를 참조하세요.
- Registry
- Project
레지스트리 관리자는 해당 레지스트리에서 자동화를 만들 수 있습니다.
- W&B에 로그인합니다.
- 레지스트리 이름을 클릭하여 세부 정보를 확인합니다.
- 레지스트리 범위의 자동화를 만들려면 Automations 탭을 클릭한 다음 Create automation을 클릭합니다. 레지스트리 범위로 지정된 자동화는 해당 레지스트리의 모든 컬렉션(향후 생성되는 컬렉션 포함)에 자동으로 적용됩니다.
- 감시할 이벤트를 선택합니다. 이벤트에 따라 추가로 표시되는 필드를 입력합니다. 예를 들어 An artifact alias is added를 선택한 경우 Alias regex를 지정해야 합니다. Next step을 클릭합니다.
- ARIA 대화를 호스팅할 팀을 선택합니다. 자동화로 생성된 대화 보기를 참조하세요.
- Action type을 Trigger ARIA로 설정합니다.
- Prompt 필드에 ARIA로 전송할 프롬프트를 작성합니다. 프롬프트 작성을 참조하세요. Next step을 클릭합니다.
- 자동화의 이름을 입력합니다. 필요에 따라 설명도 입력합니다.
- Create automation을 클릭합니다.
ARIA로 자동화 만들기 및 관리하기
프롬프트 작성하기
- 프롬프트는 필수이며 최대 4,000자까지 입력할 수 있습니다. W&B는 템플릿 변수를 치환한 후 길이를 다시 확인하므로, 저장에 성공한 프롬프트라도 치환된 값이 길면 자동화 실행 시 실패할 수 있습니다. 이 검사에 실패한 프롬프트는 자동화의 실행 이력에 실패한 실행으로 기록됩니다.
- 해당 이벤트에 적용되지 않는 템플릿 변수은 변수 이름이 아니라 empty string으로 처리됩니다. 사용 중인 이벤트에 나열된 변수만 사용하세요.
- ARIA는 자동화가 실행될 때마다 새 대화를 시작합니다. 이전 대화를 이어가지 않으며, 동일한 자동화의 이전 실행 내용도 기억하지 않습니다.
템플릿 변수
${variable_name} 구문을 사용합니다. 프롬프트에서 사용할 수 있는 변수는 자동화가 감시하는 이벤트에 따라 달라집니다.
모든 이벤트에서 다음 변수를 사용할 수 있습니다.
이벤트에 따라 위 변수 외에 다음 변수도 사용할 수 있습니다.
개별 변수에는 다음 사항이 적용됩니다.
${artifact_version}은wandb-artifact://_id/QXJ0aWZhY3Q6NTE3ODg5ODg3와 같은 아티팩트 인스턴스로 확인됩니다. 버전을 이름으로 참조하려면${artifact_version_string}을 사용하세요.${artifact_metadata.KEY}는 이벤트를 트리거한 아티팩트 버전에서 custom metadata 값을 조회합니다.KEY는 원하는 메타데이터 키로 바꾸세요. top-level 메타데이터 키만 지원됩니다.
자동화가 생성한 대화 보기
${event_author}를 포함하세요.
대화가 저장되는 위치는 자동화의 범위에 따라 달라집니다.
- 프로젝트 범위 및 팀 범위 자동화: 이벤트가 발생한 프로젝트에 대화가 생성됩니다.
-
레지스트리 범위 자동화: 레지스트리는 팀이 아니라 조직에 속하지만, ARIA 대화는 반드시 팀에 속해야 합니다. 따라서 자동화를 만들 때 선택한 팀의
wandb_agent_default_project라는 프로젝트에 대화가 생성됩니다. 레지스트리가 아니라 이곳에서 확인하세요.wandb_agent_default_project는 사용자가 연 프로젝트와 연결되지 않은 대화를 보관하기 위해 W&B가 각 팀마다 유지하는 자리 표시자 프로젝트입니다. 직접 만들 필요가 없으며, 이러한 대화를 제외하면 일반적으로 비어 있습니다.
thread_id가 포함된 응답 본문이 표시됩니다. W&B는 실행에서 대화로 연결되는 링크를 제공하지 않으며, 자동화로 생성된 대화가 채팅 이력에서 별도로 구분되어 표시되지도 않습니다.
자동화 보기 및 관리
제한 사항
- ARIA 자동화는 W&B Multi-tenant Cloud의 팀 프로젝트에서, 조직 관리자가 Smart features를 활성화한 경우에만 사용할 수 있습니다.
- 각 자동화는 분당 최대 3개의 ARIA 대화를 시작할 수 있습니다. 이 한도를 초과한 실행은 자동화 이력에 Skipped 상태로 기록되며, 이는 자동화가 이벤트와 일치했지만 해당 액션을 실행하지 않았음을 의미합니다.
- 자동화를 만든 사용자가 해당 프로젝트에 대한 쓰기 액세스를 잃거나 계정이 비활성화되면 이후의 모든 실행이 실패합니다. 실패 내역은 자동화의 실행 이력에 표시됩니다.
- 자동화는 생성자만 편집할 수 있습니다.
wandbPython 라이브러리는 ARIA 자동화를 지원하지 않습니다. API로 자동화 관리를 참조하세요.