API クイックスタート

個人 API キーでサーバーからタスクを送り、イベントで進捗と結果を確認します。製品内の Task Agent API 文書と同じ公開定義を使用します。

URL とキーを準備

API キーを管理画面で個人キーを作成します。送信には prompts:write、セッションとイベントには sessions:read が必要です。完全なキーを保存し、端末に環境変数を設定します。

export HAST_API_BASE='https://backend.hast.so/api/public/v1'
export HAST_API_KEY='<YOUR_PERSONAL_API_KEY>'

最初のタスクを送信

curl --fail-with-body --request POST \
  --url "$HAST_API_BASE/prompts" \
  --header "Authorization: Bearer $HAST_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"request_id":"req_123","prompt":"Summarize the latest workspace files."}'

例ではワークスペースのファイル要約を依頼します。prompt を自分の要件に変更できます。

session_id を省略すると新しいセッションを作成し、後続で同じ ID を送ると継続します。request_id は冪等性のために使い、新しいターンでは新しい値にします。

受け付け後は HTTP 202 が返ります。応答の session_id を保存し、実行結果はイベントで確認します。全項目と応答は API リファレンスを参照してください。

実行過程を取得

返された ID を SESSION_ID に設定します。

export SESSION_ID='<SESSION_ID_FROM_RESPONSE>'
curl -N --fail-with-body \
  "$HAST_API_BASE/sessions/$SESSION_ID/events/stream?after=0" \
  --header "Authorization: Bearer $HAST_API_KEY" \
  --header 'Accept: text/event-stream'

SSE で HAST Event v2 を配信します。種別に応じてメッセージ、ツール進捗、実行結果を表示します。message.completed は 1 メッセージの完了であり、ターン全体の完了は実行イベントで判断します。イベントストリームを参照してください。

接続を続ける

API リファレンスではセッション、ファイル、Skills、メモリ、コネクター、シークレットを扱います。項目を展開して引数と応答を確認するか、OpenAPI JSONをダウンロードして Swagger / OpenAPI 2.0 対応ツールに読み込めます。