クイックスタート

アカウントの作成から、実行の完了、自分のサーバーからの API 呼び出しまでを説明します。所要時間は約 5 分です。

1. アカウントを作成してクレジットをチャージする

   アカウントを作成します。作成すると、新しい組織のオーナーになります。実行はプリペイド制のため、請求を開き、クレジットをチャージしてください。最初は $10 で十分です。

   クレジットは、Stripe が支払いを確認するとすぐに反映されます。通常は数秒以内です。

2. プレイグラウンドで実行を開始する

   ダッシュボードでプレイグラウンドを開き、実行ページのサンプルを試すを選ぶか、独自のプロンプトを入力します。⌘↵ を押すと開始します。右側に、ワーカーの各ステップと並んで出力がストリーミングされます。

   各実行には、出力、イベントのタイムライン、コストを確認できるページがあります。

3. API キーを作成する

   API キーを開き、メンバーキーを作成します。キーは 1 度だけ表示され、環境変数にそのまま貼り付けられるスニペットが付いています。キーはサーバー上で保管してください。

   ターミナル

   export EPHEMERAL_URL=https://app.ephemer.al
   export EPHEMERAL_API_KEY=eak_…

4. 同じ実行をコードから開始する

   cURLNode.jsCLI

   curl $EPHEMERAL_URL/v1/runs \
     -H "Authorization: Bearer $EPHEMERAL_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{
       "prompt": "Summarize the input in one sentence",
       "input": { "text": "The export finished but two invoices are missing." },
       "max_cost_micros": 500000
     }'

   レスポンスは 202 Accepted で、実行の id が返ります。実行はキューに入り、空いているワーカーがあればすぐに開始されます。

5. 結果を取得する

   ステータスが最終状態（succeeded, failed, cancelled, timed_out、interrupted）になるまで GET /v1/runs/{id} をポーリングします。その後、コストが精算されるように billing_pending が false になるのを待ちます。成功した実行の答えは output に入り、それ以外の最終ステータスでは理由が error に入ります。

   cURLNode.jsCLI

   RUN_ID=run_4abb0f420c6623a12d2889610eb67284   # 前のステップで返された id
   
   while true; do
     RUN=$(curl -sf "$EPHEMERAL_URL/v1/runs/$RUN_ID" \
       -H "Authorization: Bearer $EPHEMERAL_API_KEY") || exit 1
     case $(jq -r .status <<<"$RUN") in
       succeeded|failed|cancelled|timed_out|interrupted)
         [ "$(jq -r .billing_pending <<<"$RUN")" = false ] && break ;;
     esac
     sleep 2
   done
   
   jq '{status, output, error, cost_micros}' <<<"$RUN"

   cost_micros がない場合は 0 を意味します。CLI の --wait はステータスが最終状態になった時点で戻るため、精算後のコストが必要なら ephemeral runs get でもう一度取得してください。GET /v1/runs/{id}/events からイベントをストリーミングすることもできます。長時間の実行では、リクエストにコールバックを指定すると完了時に Ephemeral から通知されるため、ポーリングは不要です。

   完了した実行のレスポンスは次のようになります。

   GET /v1/runs/run_…

   {
     "id": "run_4abb0f420c6623a12d2889610eb67284",
     "status": "succeeded",
     "output": "Two invoices are missing from an otherwise complete export.",
     "cost_micros": 3120,
     "max_cost_micros": 500000,
     "billing_pending": false
   }

次のステップ

• ファイル、接続、Web アクセスを使って、実際の調査を実行します。
• プロンプトをワークフローとして保存し、名前で開始します。
• 実行に、読み取れるファイルと呼び出せる接続を与えます。
• 予算によって、すべての実行が上限内に収まる仕組みを確認します。