Postman용 AI 에이전트
Monmo AI 에이전트는 문서 작성까지 맡는 API 테스터처럼 Postman에서 일합니다. 컬렉션에 테스트를 추가하고 배포할 때마다 스테이징 환경에서 실행하며, 요청이 실패한 이유를 설명하고 API 명세에 맞춰 문서를 업데이트합니다. 고객의 Postman API 키를 사용하며, 실제 운영 API에 데이터를 쓰거나 공유 컬렉션을 수정하기 전에는 승인을 요청합니다.
업데이트: 2026-11-13 · 무료로 시작하세요. 유료 요금제는 월 $15부터입니다.
Postman에서 에이전트가 하는 일
컬렉션 테스트 작성
각 요청에 상태 코드, 응답 스키마, 응답 시간을 확인하는 테스트를 추가하고 스테이징 환경에서 실행해 통과한 테스트를 보여줍니다. 팀 워크스페이스에 저장하기 전에는 승인을 요청합니다.
요청하기Orders 컬렉션의 모든 요청에 상태 코드, 스키마, 800 ms 미만 응답 시간을 확인하는 테스트를 추가해 주세요.
배포 후 컬렉션 실행
CircleCI 또는 GitLab에서 스테이징 배포가 이뤄질 때마다 자체 컴퓨터의 명령줄에서 컬렉션을 실행합니다. 실패한 요청은 요청 내용, 예상값, 실제 응답과 함께 보고합니다.
요청하기스테이징에 배포할 때마다 Smoke 컬렉션을 실행하고, 실패한 항목이 있으면 Slack으로 보내 주세요.
실패한 요청 분석
요청과 선택한 환경, 응답을 살펴보고 만료된 토큰, 잘못된 호스트를 가리키는 변수, 이름이 바뀐 필드 등의 원인을 찾습니다. API에 문제가 있으면 Jira 티켓 초안도 작성합니다.
요청하기스테이징 환경에서 Create invoice 요청이 401을 반환합니다. 이유가 뭔가요?
명세에 맞춰 문서 업데이트
컬렉션을 GitHub의 OpenAPI 파일과 비교해 누락되거나 이름 또는 내용이 바뀐 엔드포인트를 정리하고, 각각에 대한 설명과 예시 초안을 작성합니다.
요청하기공개 API 컬렉션을 main의 openapi.yaml과 비교해 오래된 내용을 모두 정리해 주세요.
명세로 컬렉션 만들기
OpenAPI 파일을 바탕으로 리소스별 폴더와 요청 본문 예시, 스테이징 환경을 갖춘 컬렉션을 만듭니다. 공유 워크스페이스에 생성하기 전에는 승인을 요청합니다.
요청하기이 결제 명세로 리소스별로 그룹화된 Postman 컬렉션과 스테이징 환경을 만들어 주세요.
환경 변수의 비밀 정보 노출 확인
실제 운영 키나 비밀번호로 보이는 값이 있는 공유 환경을 정리하고, 해당 값을 비밀 정보로 표시하거나 공유 워크스페이스 밖으로 옮기도록 제안합니다. 변경하기 전에는 승인을 요청합니다.
요청하기팀 워크스페이스의 모든 환경에서 실제 API 키로 보이는 값을 찾아 주세요.
모니터 결과 검토
매주 월요일 지난주의 모니터 실행 결과를 확인해 실제 실패와 간헐적 실패를 구분하고, 응답이 느려진 엔드포인트를 정리해 팀에 짧은 보고서로 전달합니다.
요청하기매주 월요일 9시에 지난주 Postman 모니터 실행 결과를 요약해 주세요. 실제 실패, 간헐적으로 실패하는 테스트, 느려진 엔드포인트를 포함해 주세요.
연결 방법
- 1고객 계정의 API 키로 Postman을 연결합니다. 이 키는 고객의 권한으로 작동하므로 에이전트는 고객이 열 수 있는 워크스페이스에 접근합니다. 뷰어 권한이 있는 계정의 키를 사용하면 읽기만 할 수 있습니다.
- 2Postman을 사용할 에이전트를 직접 선택합니다. 엔지니어링 또는 QA 에이전트에 필요한 연결입니다. 스테이징 환경을 제공하고, 업무에 필요하지 않다면 운영 환경 키에는 접근하지 못하도록 설정하세요.
- 3컬렉션을 읽거나 테스트 환경에서 읽기 전용 요청을 실행할 때는 승인을 요청하지 않습니다. 실제 운영 시스템에서 데이터를 생성, 변경, 삭제하는 요청을 보내거나 공유 컬렉션과 환경을 수정하기 전에는 승인을 요청합니다.
개발·IT의 다른 앱
에이전트가 사용하는 같은 유형의 다른 앱입니다. 각 앱의 개별 페이지에서 자세히 알아보세요.
자주 묻는 질문
AI 에이전트가 Postman 테스트를 작성할 수 있나요?
네. AI 에이전트는 각 요청과 응답을 읽고 상태 코드, 스키마, 필수 필드, 응답 시간을 확인하는 테스트를 작성하고 실행합니다. 테스트하지 않은 스크립트가 아닌 실제 결과를 확인할 수 있습니다. 공유 컬렉션에 테스트를 저장하기 전에는 승인을 요청합니다. Postman 연결을 사용하며, 연결로 처리할 수 없는 작업은 자체 브라우저에서 수행합니다.
운영 API에도 요청을 보내나요?
허용한 경우에만 보냅니다. 테스트 환경에서는 읽기 전용 요청을 별도 승인 없이 실행합니다. 실제 운영 시스템에서 데이터를 생성, 변경, 삭제하는 작업은 먼저 메서드, 주소, 본문이 담긴 카드를 보여주므로 의도하지 않은 DELETE 요청이 실제 고객에게 영향을 주지 않습니다.
API 문서를 최신 상태로 유지할 수 있나요?
네. AI 에이전트가 컬렉션을 OpenAPI 명세 및 GitHub의 코드와 비교해 달라진 내용을 정리하고, 새로운 설명과 예시, 오류 응답 초안을 작성합니다. 팀 외부에서 보는 문서에 게시하기 전에 변경 사항을 검토할 수 있습니다.
AI 에이전트가 Postman 앱을 사용해야 하나요?
아니요. AI 에이전트는 개발 도구가 설치된 자체 컴퓨터를 가지고 있어, 예를 들어 배포 후 명령줄에서 컬렉션을 실행하고 결과를 확인할 수 있습니다. 화면에서 작업해야 할 때는 자체 브라우저에서 Postman을 열 수도 있습니다.