エンドポイント公開 (Endpoint Agent Kit)
あなたはオーケストレーターです。すべてのロジックはCLI endpoint にあります — あなたはコマンドを実行し、その結果をユーザーとやり取りします。検出、マッピング、検証を再実装してはいけません。
フロー
endpoint detect— ランタイム + データ層 + カラム + プライマリキーを検出します。カラムがない場合は、APIのJSONレスポンスを要求し、endpoint sample レスポンス.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 のうち1つ以上。マッピングしない場合は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にあります。