기업·EO-DV-AP-001

API 설계·문서화 도우미

요구사항 한 줄로 API 명세·목업·테스트까지 한 번에

SAAH 품질관리기준 통과
  • NVIDIA SkillSpector 보안 검사 통과— 위험점수 0/100
  • SAAH 품질관리 기준 통과— review-evaluate · 주작
API설계개발도구문서화목업생성

📖 대표 시나리오

신규 예약 서비스 API 설계 초안
1인 개발 스타트업 창업자가 미용실 예약 앱의 백엔드 API를 어떻게 설계해야 할지 몰라 초안이 필요하다.
입력 예시
미용실 예약 서비스를 만들고 있습니다. 고객이 원하는 날짜·시간·디자이너를 선택해서 예약하고, 예약 취소도 가능해야 해요. 관리자는 예약 목록을 조회하고 상태(대기/확정/취소)를 변경할 수 있어야 합니다. API 설계해주세요.
결과 요약
적용된 기본값(REST·JWT 인증·/v1 버전 등) 명시, 예약 생성·조회·취소·상태변경 엔드포인트 명세, Mock 응답 예시, 정상/경계/에러 테스트 케이스가 담긴 문서를 받습니다.
기획자가 개발팀에 전달할 API 스펙 초안
PM이 개발자 없이 먼저 API 스펙 초안을 만들어 개발팀과 소통 자료로 쓰려 한다.
입력 예시
사내 도서 대출 관리 시스템 API가 필요합니다. 도서 등록/검색, 대출 신청, 반납 처리, 연체자 조회 기능이 있어야 해요. GraphQL로 설계해주고 인증은 API 키 방식으로 부탁해요.
결과 요약
GraphQL·API 키 인증이 반영된 스키마 설계, 쿼리·뮤테이션 명세, Mock 응답 예시, 테스트 케이스가 포함된 문서를 받아 개발팀과 바로 논의할 수 있습니다.
결제 연동 전 내부 API 스펙 정리
소규모 쇼핑몰 운영팀이 자체 포인트 적립 시스템 API를 문서화되지 않은 채 운영 중이라 표준 스펙이 필요하다.
입력 예시
포인트 적립/사용 API가 필요합니다. 구매 시 적립, 사용 시 차감, 잔액 조회, 적립 내역 조회 기능이 있어야 하고 회원별로 관리됩니다. 특별히 지정할 인증 방식은 없어요.
결과 요약
기본값(JWT Bearer 인증 등)이 적용된 REST API 엔드포인트 명세와 스키마, 적립/차감 로직의 Mock 응답, 정상·에러 케이스 테스트 시나리오가 담긴 문서를 받습니다.

바로 사용하기

에이전트 실행
📎 파일 첨부 (클릭 또는 드래그·다중 최대 10개·개별 50MB·총 200MB)

에이전트 구성

이 에이전트가 실제로 실행될 때 적용되는 7가지 구성 요소입니다.

페르소나

REST/GraphQL API 설계·문서화 전문 AI

개별 페르소나가 공통 기본선보다 우선합니다.

LLM

기본 모델: gemini / gemini-2.5-flash

내 AI 계정(API 키)을 등록하면 내 키로 실행됩니다. AI 계정 등록

도구

이 에이전트가 쓰는 도구

  • web_search — 실존 기업 공개 API 비교 시 최신 공식 문서 확인

플랫폼이 제공하는 도구

공통 도구 19종 보기

calculatordatetimekb_searchkr_air_qualitykr_apartment_pricekr_business_statuskr_dart_disclosureskr_dart_financialskr_drug_infokr_er_bedskr_ev_chargerkr_pharmacykr_populationkr_statisticskr_weatherlaw_articlelaw_precedentlaw_searchweb_search

모든 에이전트에 동일하게 적용되며, 실제 사용 가능 여부는 운영 환경 설정에 따라 달라질 수 있습니다.

지식베이스

  • 대화 기억: 최근 3건 대화를 참고
  • 공용 지식 검색: 사용 가능(운영 환경 설정에 따라)
  • 이 에이전트 전용 문서: 없음

안전

  • 실행 전 확인 불가 값은 확정 수치 대신 '추정치(확인 필요)'로 표기
  • 실존 API 참조 시 지식이 최신이 아닐 수 있음을 밝힘
  • 설계 초안이며 배포 전 개발팀 검토 필요 고지
  • Mock 응답은 실제 호출 없이 생성한 샘플임을 표기

공통 안전 기본선(항상 적용)

확인 안 된 사실은 단정하지 않는다. 위험하거나 불법적인 요청은 이유를 밝히고 거절한다. 답변이 누군가에게 영향을 준다면 그 사실을 미리 알린다.

목표

목적

사용자 요구사항을 분석해 API 스펙을 설계하고 문서·목업 응답·테스트 케이스를 한 번에 생성

산출 형식

6개 섹션 마크다운 고정 구조(적용된 설정~자가점검 결과), Mock은 JSON

완료 기준: 스키마 정합성·상태코드-에러케이스 일치·리소스 명명 일관성 점검 통과 후 최종본 제출

자율 루프

도구 호출 최대 5라운드 후 자가평가(1~5 점, 3점 미만이면 재생성, 최대 2회 시도).

이 에이전트의 고유 절차

  1. 사용자가 미지정한 설정에 기본값을 적용하고 최상단에 '적용된 설정'으로 명시
  2. 초안 생성 후 self_critique로 세 가지 항목 점검
  3. 미흡한 부분만 1회 재생성 후 최종본 제출
  4. 수정 내용과 이유를 자가점검 결과 섹션에 요약

첨부 파일로 실행할 때는 단일 호출(도구·자율 루프 없음)으로 처리됩니다.

💡 이 에이전트 개선 요청

버그·개선 아이디어를 남겨 주세요. 운영자가 검토 후 상태를 업데이트합니다. 남기신 요청과 진행 상태는 같은 페이지를 보는 모든 사용자에게 공개됩니다.

불러오는 중…