GitLab Duo 에이전트 플랫폼 개발을 위한 에이전트 상호작용 패턴

GitLab Duo 에이전트 플랫폼 개발을 위한 에이전트 상호작용 패턴에 대해 설명합니다.

이 가이드는 GitLab 내 에이전트 및 플로우를 위한 상호작용 패턴과 규칙을 설명합니다. 이 패턴들은 인프라 부하를 관리하고 높은 수준의 사용자 경험을 유지하면서 일관되고 사용자 친화적인 동작을 보장합니다. 이 가이드는 GitLab이 관리하는 에이전트와 플로우를 대상으로 합니다. AI 카탈로그에서 생성된 커스텀 에이전트에도 이 패턴이 적용되어야 합니다. 핵심 사용자 경험 원칙 # 알림 소음 최소화: 에이전트는 사용자에게 알림과 코멘트로 부담을 주지 않으면서 필요한 업데이트를 제공해야 합니다. 투명성 유지: 사용자는 에이전트의 진행 상황을 추적하고 어떤 조치가 취해지고 있는지 이해할 수 있어야 합니다. 인프라 제약 존중: 에이전트 동작은 확장성을 고려하여 설계되어야 하며, 과도한 데이터베이스 부하를 발생시키는 패턴을 피해야 합니다. 인간 감독 허용: 사용자는 에이전트 작업을 검토하고, 승인하거나, 개입하기 위한 명확한 진입점이 필요합니다. 상호작용 패턴 # 코멘트 관리 # 이슈 또는 MR에 최초 코멘트: 초기 코멘트 작성 # 동작 패턴: 플로우 또는 에이전트가 이슈 또는 MR 작업을 시작할 때, 활동을 알리기 위해 초기 코멘트를 작성합니다. 에이전트 활동을 해당 항목의 모든 협력자에게 표시합니다 세션 UI를 넘어서는 영구적인 기록을 제공합니다 진행 상황 업데이트로 갱신할 수 있는 코멘트를 만듭니다 리소스: To do: 예시 템플릿 추가 To do: 프롬프트에 예시 방법 추가 To do: 스크린샷(디자인) 추가 세션 진행 중 업데이트 추가: 동일한 코멘트에서 작업 # 동작 패턴: 에이전트가 작업을 활발히 진행하는 동안, 새 코멘트를 여러 개 만들기보다 하나의 코멘트를 업데이트해야 합니다. 데이터베이스 부하와 알림 스팸을 줄입니다 에이전트 진행 상황의 명확하고 통합된 보기를 제공합니다 AI 생성 콘텐츠로 이슈와 MR이 복잡해지는 것을 방지합니다 리소스: To do: 예시 템플릿 추가 To do: 프롬프트에 예시 방법 추가 To do: 스크린샷(디자인) 추가 플로우 완료 또는 검토 필요 시 업데이트 추가: 새 코멘트 추가 # 동작 패턴: 에이전트가 작업을 완료하거나 인간 검토 및 후속 조치가 필요한 경우, 요약과 다음 단계가 포함된 새 코멘트를 작성하고 관련 사용자를 언급합니다. 언급이 포함된 새 코멘트는 사용자에게 할 일이나 이메일을 생성하여 익숙한 알림 패턴으로 참여를 유도합니다 "에이전트 작업 중"에서 "인간 조치 필요"로의 명확한 전환을 신호합니다 업데이트된 내용에서 중요한 이정표가 사라지지 않도록 보장합니다 리소스: To do: 예시 템플릿 추가 To do: 프롬프트에 예시 방법 추가 To do: 스크린샷(디자인) 추가 플로우 완료 시: 항상 최종 요약 제공 # 동작 패턴: 플로우가 완료되면(성공 또는 오류와 함께), 항상 작업 항목에 요약 코멘트를 게시합니다. 리소스: To do: 성공과 실패에 대한 예시 템플릿 추가 To do: 프롬프트에 예시 방법 추가 To do: 성공과 실패에 대한 스크린샷(디자인) 추가 사용자 언급 # 동작