할 일 목록 도구 (write_todos)

이 문서는 Gemini CLI의 write_todos 도구에 대해 설명합니다.

설명

write_todos 도구를 사용하면 Gemini 에이전트가 복잡한 사용자 요청에 대한 하위 작업 목록을 생성하고 관리할 수 있습니다. 이를 통해 사용자는 에이전트의 계획과 현재 진행 상황을 더 잘 볼 수 있습니다. 또한 에이전트가 현재 목표를 잃어버릴 가능성을 줄여 정렬에 도움이 됩니다.

인수

write_todos는 하나의 인수를 받습니다:

• todos (array of objects, 필수): 전체 할 일 항목 목록입니다. 이는 기존 목록을 대체합니다. 각 항목에는 다음이 포함됩니다:
  • description (string): 작업 설명입니다.
  • status (string): 현재 상태 (pending, in_progress, completed, 또는 cancelled).

동작

에이전트는 이 도구를 사용하여 복잡한 다단계 요청을 명확한 계획으로 나눕니다.

• 진행 상황 추적: 에이전트는 작업을 진행하면서 이 목록을 업데이트하고 완료 시 작업을 completed로 표시합니다.
• 단일 초점: 한 번에 하나의 작업만 in_progress로 표시되어 에이전트가 현재 작업 중인 내용을 정확하게 나타냅니다.
• 동적 업데이트: 에이전트가 새로운 정보를 발견함에 따라 계획이 발전하여 새 작업이 추가되거나 불필요한 작업이 취소될 수 있습니다.

활성화되면 현재 in_progress 작업이 입력 상자 위에 표시되어 즉각적인 조치를 알 수 있습니다. Ctrl+T를 눌러 언제든지 할 일 목록의 전체 보기를 토글할 수 있습니다.

사용 예시 (내부 표현):

write_todos({
  todos: [
    { description: '새 React 프로젝트 초기화', status: 'completed' },
    { description: '상태 관리 구현', status: 'in_progress' },
    { description: 'API 서비스 생성', status: 'pending' },
  ],
});

중요 참고 사항

• 활성화: 이 도구는 기본적으로 활성화되어 있습니다. settings.json 파일에서 "useWriteTodos": false로 설정하여 비활성화할 수 있습니다.

• 의도된 사용: 이 도구는 주로 에이전트가 복잡한 다중 턴 작업에 사용합니다. 일반적으로 간단한 단일 턴 질의에는 사용되지 않습니다.