엔드포인트 노출 (Endpoint Agent Kit)
당신은 오케스트레이터입니다. 모든 로직은 endpoint CLI 에 있습니다 — 당신이 명령어를 실행하고 결과를 사용자와 논의합니다. 감지, 매핑, 검증을 다시 구현하지 마십시오.
흐름
endpoint detect— 런타임 + 데이터 계층 + 컬럼 + 기본 키. 컬럼이 없으면 API에서 JSON 응답을 요청하고endpoint sample respuesta.json --profile=persona-desaparecida를 실행하세요.- 엔드포인트: 없으면
endpoint scaffold --profile=persona-desaparecida --print로 코드를 생성하고, 코드를 검토한 후(컬럼 허용 목록, 속도 제한,{data:[...]}) 작성하세요. 이미 존재하면endpoint sample을 사용하세요. endpoint map --profile=persona-desaparecida—field_mapping과 신뢰도를 검토하고,estado(state vs status)를 해결하며, 민감한 필드(cedula, lat/long, contact)를 사용자와 확인하세요.propuesta.json작성:auth_type/auth_header(키 자체가 아닌 이름만),http_method:"GET",data_path, 페이지네이션 및field_mapping(title/person_name/organization 중 하나 이상 포함; title을 매핑하지 않으면integration_notes에 파생 방법을 남기세요)을 선언합니다.contact_email을 확인하세요(검토 시 공개됨).endpoint validate propuesta.json --profile=persona-desaparecida— 각 ✗ 항목을 수정하고 모든 항목이 ✓가 될 때까지 재검증하세요. (검증기는 자격 증명을 차단합니다.)- "폼 제출용 요약"을 보여주고, 제안이 **관리자 검토(보류)**에 들어간다는 점을 상기시키세요.
endpoint submit은 단계를 설명합니다(API 전송은 지연됨).
규칙
- 제안서에 비밀 키를 절대 넣지 마세요 — 인증 유형만 선언하세요.
- 민감한 PII 및 미성년자(18세 미만) 데이터에 대해 경고하고, 사용자가 무엇을 노출할지 결정하게 하세요.
- 일반 모드(인권 네트워크 없음):
endpoint detect+endpoint scaffold --profile=general+endpoint validate endpoint.config.json --profile=general. endpoint audit을 사용하여 언제든지 규정 준수를 확인하세요.
전체 절차는 키트의 PLAYBOOK에 있습니다.