SuperAPI AI 工具集

expose-endpoint

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

用途:Expose Endpoint 属于 hainrixz/enpoint-agentkit,用于生成并对外暴露只读 REST 端点;面向失踪人员公民网络时,把字段映射到通用 IndexedRecord 模式并准备提交提案。使用者充当编排者,逻辑由 endpoint CLI 承载,不自行重现检测、映射或校验。

主要流程:先运行 endpoint detect 检测运行时、数据层、列与主键;若无列,则提供 API 的 JSON 响应并运行 endpoint sample respuesta.json --profile=persona-desaparecida。缺少 endpoint 时用 endpoint scaffold --profile=persona-desaparecida --print 生成骨架并检查列白名单、限流与 {data:[...]} 结构;已有则用 endpoint sample。随后运行 endpoint map --profile=persona-desaparecida 检查 field_mapping 与置信度,处理 state 与 status 差异,并就 cedula、经纬度、联系方式等敏感字段与用户确认。

编写 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 与未成年人(age<18),由用户决定暴露内容。通用模式(非公民网络)使用 endpoint detect 与 endpoint scaffold --profile=general,再用 endpoint validate endpoint.config.json --profile=general;可用 endpoint audit 检查合规性。完整流程见该套件的 PLAYBOOK。