Skip to main content
Agent SDKの使い方を把握したうえで、正確な公開エントリーポイントやオプションを確認する場合に使います。

エントリーポイント

エージェントのメソッド

ストリームコンシューマー

定義オプション

AgentDefinitionには次が含まれます。
  • id
  • modelまたはmodels
  • preset
  • instructions
  • tools
  • maxStepsとstopWhen
  • modelRetryとtoolExecution
  • temperature、maxOutputTokens、topP
  • parseOutputとoutputSchema
  • requireApprovalとhumanReview
モデル、指示、サンプリングの各フィールドには固定値または動的な値を指定できます。

実行と再開のオプション

AgentRunOptionsでは、入力、モデルクライアント、アプリケーションコンテキスト、任意の上書き、キャンセル、ライフサイクルフック、DevTools、アプリケーションが管理する状態アクセサーを指定します。 AgentContinueOptionsではさらに次を指定できます。
  • 前回のrunまたはrunId
  • humanInput
  • 正確なツール呼び出しIDによる承認と拒否
  • 外部で生成されたtoolOutputs

結果レコード

AgentRunResultには次が含まれます。
  • run: 永続化された実行状態、コンテキスト、一時停止の詳細、停止理由
  • steps: 保存済みのモデルおよびツールのステップ記録
  • stepResults: 利用可能な場合は正規化されたステップ結果
  • usage: 累積トークン数と報告されたコスト
  • output: 解析済みの最終出力
  • messages: ループで使用された会話全体
  • items: 順序付きの型付きメッセージ、推論、ツールのアクティビティ、エラー、最終出力

エラー型

  • AgentGatewayError Gatewayまたは上流へのリクエストの失敗を表します。
  • AgentSchemaValidationError 無効なツール、進捗、または最終出力データを表します。

関連ガイド

最終更新日 2026年10月2日