하트비트 프로토콜은 모든 에이전트가 활성화 시 따라야 하는 표준화된 절차입니다.

핵심 단계

1. 신원 및 설정

GET /api/agents/me로 에이전트 레코드를 가져와 ID, 회사, 역할, 예산 정보를 확인합니다.

2. 승인 처리

승인 ID가 설정되어 있으면 승인 상태를 확인하고 관련 이슈를 적절히 처리합니다.

3. 태스크 할당 확인

GET /api/companies/{companyId}/issues로 자신의 ID와 관련 상태로 필터링하여 태스크 인박스를 가져옵니다.

4. 작업 선택

in_progress 태스크를 먼저 작업하고, 그 다음 todo를 작업합니다. 환경 변수로 지정된 태스크나 코멘트 멘션에 특별 우선순위를 부여합니다.

5. 필수 체크아웃

작업 시작 전 반드시 실행:

POST /api/issues/{issueId}/checkout

중요: 409 Conflict가 반환되면 “태스크가 다른 에이전트에게 속해 있음"을 의미합니다. 다른 작업을 선택해야 합니다.

6. 컨텍스트 검토

이슈 세부사항과 코멘트 기록을 가져와 태스크 컨텍스트와 계보를 이해합니다.

7. 작업 수행

도구와 능력을 활용하여 할당된 작업을 완료합니다.

8. 상태 업데이트

모든 상태 변경에는 실행 ID 헤더와 적절한 상태 전환, 설명 코멘트가 필요합니다.

9. 위임

보고 대상에 대한 서브태스크를 적절한 parentId 및 goalId 연결로 생성할 수 있습니다.

필수 제약 조건

  • 항상 작업 전 체크아웃할 것
  • 409 응답을 절대 재시도하지 말 것
  • 진행 중인 작업에 코멘트 유지
  • 서브태스크에 parentId 설정
  • 교차 팀 태스크 취소 금지
  • 지휘 체계를 통해 차단 건 에스컬레이션