한 줄 요약
이슈스티커를 연결하면 에이전트가 다음 도구를 쓸 수 있게 됩니다. 어떤 도구가 있는지 알면 요청이 원하는 대로 풀리지 않을 때 어디를 짚어야 할지 알 수 있습니다.
이 문서가 필요한 경우
- 에이전트가 이슈스티커에서 어떤 작업을 할 수 있는지 한눈에 확인하고 싶은 경우
- 기대와 다른 결과가 나왔을 때 어떤 도구를 사용했는지 이해하고 싶은 경우
도구 목록
| 도구 | 하는 일 |
|---|---|
| search_issues | 프로젝트, 기간, 검색어, 필터 조건으로 원하는 이슈를 찾습니다. |
| list_issue_fields | 해당 프로젝트에서 사용할 수 있는 필터와 각 필드의 값을 알려줍니다. |
| get_issue | 이슈의 전체 정보를 읽습니다. 제목, 설명, 발생 위치, 환경 정보, 로그, 첨부 목록, 외부 연동 정보를 포함합니다. |
| get_issue_screenshot | 이슈에 첨부된 스크린샷을 이미지로 가져옵니다. |
| get_session_replay | 세션 리플레이를 시간순으로 읽습니다. 콘솔 로그와 네트워크 요청도 같은 시간축에서 함께 확인할 수 있습니다. |
에이전트는 보통 search_issues → get_issue → 필요 시 get_issue_screenshot 또는 get_session_replay 순서로 사용합니다.
알아두면 좋은 것
- 필터를 사용하기 전에는
list_issue_fields를 먼저 호출합니다. 사용할 수 있는 필터는 프로젝트마다 다르므로, 먼저 확인해야 정확하게 검색할 수 있습니다. - 스크린샷과 세션 리플레이는 별도로 요청해야 가져옵니다.
get_issue는 첨부 여부만 알려주므로, 내용까지 확인하려면 "스크린샷도 확인해줘", "리플레이도 분석해줘"처럼 함께 요청하세요. - 세션 리플레이가 길면 최근 구간부터 확인합니다. 필요한 경우 앞부분도 이어서 읽을 수 있도록 안내합니다.
도구가 보이지 않을 때
에이전트가 이슈스티커 도구를 하나도 인식하지 못한다면 아직 연결이 완료되지 않은 상태입니다. 연결하기 문서의 로그인 단계를 다시 진행해 주세요.