Tasks 도구
Tasks 도구 (Tasks Tool)
에이전트가 세션을 넘어 유지되는 영구 작업 데이터베이스를 사용하는 방법을 설명해요. 우선순위와 의존성을 지원해요.
출처: 문서
본문
tasks 도구는 에이전트 세션을 넘어 유지되는 영구 작업 데이터베이스를 제공해요. 현재 세션의 메모리 내 작업 목록만 유지하는 Todo 도구와 달리, tasks 도구는 작업을 디스크의 JSON 파일에 저장해서 여러 세션에서 접근하고 갱신할 수 있어요. 작업은 우선순위와 의존성을 지원해요 — 작업은 의존하는 모든 작업이 done이 될 때까지 차단돼요.
구성
toolsets:
- type: tasks
path: ./tasks.json # 선택: 커스텀 데이터베이스 경로
옵션
| 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|
path |
string | tasks.json |
JSON 작업 데이터베이스 경로. 상대 경로는 에이전트 구성 디렉터리 기준(--working-dir 설정 시 그 기준) |
사용 가능한 도구
tasks 도구셋은 다음 도구를 노출해요:
| 도구 이름 | 설명 |
|---|---|
create_task |
제목, 설명(또는 markdown 파일 경로), 선택적 우선순위, 선택적 의존성으로 새 작업 생성 |
get_task |
ID로 단일 작업의 전체 세부 정보 얻기. 유효 상태(blocked, 의존성이 done이 아니면) 포함 |
update_task |
작업의 제목, 설명, 우선순위, 상태, 의존성 목록 갱신 |
delete_task |
ID로 작업 삭제. 다른 작업의 의존성 목록에서도 제거 |
list_tasks |
우선순위별(중요한 것 먼저)로 작업 나열하고 차단된 작업은 마지막에. 상태나 우선순위로 선택적 필터 |
next_task |
가장 높은 우선순위의 실행 가능한 작업 반환 — 차단되지 않고 done이 아닌 것. "무엇을 해야 하지?"에 좋음 |
add_dependency |
의존성 추가: 작업은 의존하는 작업이 done이 될 때까지 차단 |
remove_dependency |
작업에서 의존성 제거 |
예시
agents:
root:
model: openai/gpt-4o
toolsets:
- type: tasks
path: ./project-tasks.json
팁 Tasks vs. Todo 세션을 넘어 유지, 우선순위, 의존성이 필요할 때(예: 장기 프로젝트, 반복 작업) tasks 도구를 사용하세요. 일시적이고 세션 범위의 작업 목록에는 todo 도구를 사용하세요.