通过智能体使用 Humanbased

https://docs.humanbased.ai/markdown/zh/api/api-fields.md

以 Markdown 阅读 Humanbased 数据读取接口参考：
https://docs.humanbased.ai/markdown/zh/api/api-fields.md
参考副本：文档版本 <版本>，取得日期 <日期>。
使用这份 Markdown 文本，不使用 HTML 页面。读不到时，先索取文档再执行。

使用 https://api.humanbased.ai。
HB_API_KEY 和 HB_SUBSCRIPTION_ID 由运行环境提供。不得输出密钥。

只请求 GET /v1/live/pull 的一页数据：
subscription_id：已提供的订阅
from：beginning
limit：5

HB_AGENT_OUTPUT_PARENT 是获准的输出目录。
在它下面新建一个目录，把完整响应保存在里面，其他位置一律不写。
变量未设置或目录不存在时，停止并报告，不要另选位置。

不要继续分页、切换增量模式、创建密钥、修改订阅、接受协议或修改 Campaign。

报告 HTTP 状态、success、条目数、是否有下一页，以及保存文件的完整路径。
报告中不要包含原始记录内容。
访问被拒绝或响应不完整时，停止并报告错误，不尝试更换凭证或扩大范围。

if [ -z "${HB_AGENT_OUTPUT_PARENT:-}" ] || [ ! -d "$HB_AGENT_OUTPUT_PARENT" ]; then
  printf 'Stop: HB_AGENT_OUTPUT_PARENT must name the approved, existing output directory.\n' >&2
else
  HB_AGENT_OUTPUT="$(mktemp -d "$HB_AGENT_OUTPUT_PARENT/hb-read.XXXXXX")" &&
    printf 'Response directory: %s\n' "$HB_AGENT_OUTPUT" &&
    curl --silent --show-error --get \
      'https://api.humanbased.ai/v1/live/pull' \
      --header "Authorization: Bearer $HB_API_KEY" \
      --data-urlencode "subscription_id=$HB_SUBSCRIPTION_ID" \
      --data-urlencode 'from=beginning' \
      --data-urlencode 'limit=5' \
      --output "$HB_AGENT_OUTPUT/page.json" \
      --write-out 'HTTP %{http_code}\n'
fi

case "$HB_AGENT_OUTPUT" in
  "$HB_AGENT_OUTPUT_PARENT"/*) ls -l "$HB_AGENT_OUTPUT/page.json" ;;
  *) printf 'Outside the approved directory: %s\n' "$HB_AGENT_OUTPUT" >&2 ;;
esac

环境：production
操作：订阅从头读取，只读一页
HTTP 状态：200
API success：true
保存条目数：5
还有下一页：true
获准目录：<HB_AGENT_OUTPUT_PARENT 的值>
响应文件：<获准目录>/hb-read.Ab12Cd/page.json
覆盖范围：只读取了一页，没有继续分页
参考：api-fields.md，文档版本 <版本>，取得日期 <日期>

mkdir -p "$HB_AGENT_OUTPUT/tmp"
TMPDIR="$HB_AGENT_OUTPUT/tmp" HB_API_KEY="$HB_API_KEY" hb campaign records pull <campaign-id> \
  --subscription "$HB_SUBSCRIPTION_ID" \
  --limit 5 --json > "$HB_AGENT_OUTPUT/records-page.json"