Quickstart

最初の agent run を 3 ステップで。task を送ってストリーミング結果を読み取るだけ——あとはすべてプラットフォームが処理します。

1. API キーを取得する

アプリで Settings → API keys を開き、キーを作成します。キーはワークスペースに紐づきます（sk-ws-…）。API 経由で作成することもできます：

POST/v1/workspaces/{workspace_id}/api-keys —

このワークスペースに紐づく新しい API キーを作成します。

bash

export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"

2. task を送る

これが連携のすべてです。フィールドは 1 つ——task。プラットフォームがモデルを選び、タスクに必要なツールを呼び出し、結果をストリーミングします。

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task": "Find the 3 largest cross-border payment providers in SE Asia and summarize each in one line."}'
# -> {"run_id": "…", "trace_id": "…"}

{run_id, trace_id} を返します。run はすでに実行中です——接続を維持する必要はありません。

3. 結果を読み取る

bash

curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
  -H "Authorization: Bearer $NEXEVO_API_KEY"

各行の data: がイベントです——step_start、tool_call、tool_result、llm_delta（ストリーミングテキスト）、そして最後に run_end（final_text を含む）。ストリームは終端フレームのあとに終了します。

以上です——完全な連携を終えました。プラットフォームがモデル選択、ウェブ検索、結果の統合を自動で処理しました。あなたは task 以外、何も設定していません。他のシナリオ（OpenAI SDK、ナレッジベースの Q&A、定期レポート）は Cookbook を参照してください。

次のステップ

仕組み——auto-routing + built-in tools を理解する
Agent runs——完全な API サーフェス
Cookbook——コピペできるレシピ