Event
Session の Event の全種類。
Event はそれぞれ 1 つの JSON オブジェクトで、シーケンス番号 seq、作成時刻 created_at、種類 type、その種類固有のフィールドを持ちます。読み方は Event のストリーム を参照してください。
Session とメッセージ
| 種類 | フィールド | |
|---|---|---|
session_created |
agent_id、agent_version_id |
Session の最初の Event です。 |
message_user |
message、source |
入力です。source は client か、Run の実行中に送られた場合は steer です。 |
message_assistant |
message |
モデルが書いた内容です。テキスト、Thinking、モデルが行った Tool の呼び出しを含みます。 |
session_display_name_changed |
display_name、author |
名前が変更されました。変更したのは user か agent です。 |
error |
message |
どの Run の結果にも属さない、Session のエラーです。 |
custom |
kind、payload |
エンジン内部の記録です。表示するときは読み飛ばしてください。 |
message は role と、ブロックの配列である content を持ちます。
| ブロック | |
|---|---|
{"type": "text", "data": {"text"}} |
Markdown 形式のテキスト |
{"type": "thinking", "data": {"thinking", "redacted"}} |
モデルが考えた内容。Model Provider が報告する場合だけ含まれます |
{"type": "tool_call", "data": {"id", "name", "arguments"}} |
モデルが行った呼び出し |
{"type": "image", "data": {"media_type", "sha256"}} |
画像。バイト列は GET /v1/sessions/{id}/images/{sha256} で取得できます |
Run
| 種類 | フィールド | |
|---|---|---|
run_queued |
run_id |
入力によって Run が始まりました。 |
run_started |
run_id |
Run が処理を始めました。 |
run_completed |
run_id |
Run がターンを終えました。 |
run_failed |
run_id、error |
Run がエラーで止まりました。 |
run_cancelled |
run_id |
Run が停止されました。 |
Run は、最後の 3 つのうちちょうど 1 つで終わります。
Tool
| 種類 | フィールド | |
|---|---|---|
tool_call |
call_id、name、arguments |
呼び出しです。name はモデルが使った名前 <kind>__<name>__<tool> です (Tool を参照)。 |
tool_result |
call_id、content、is_error |
呼び出しの結果です。 |
承認とフォーム
| 種類 | フィールド | |
|---|---|---|
approval_requested |
call_id、server、tool、arguments、args_hash |
呼び出しが人の判断を待っています。 |
approval_resolved |
call_id、decision、deny_message、resolved_by |
allow か deny です。 |
input_requested |
call_id、request |
Agent がフォームを提示しました。質問は request.questions にあります。 |
input_resolved |
call_id、resolution、resolved_by |
submitted、declined、expired のいずれかです。 |
resolved_by は誰が決めたかを表します。値は user:<id>、api_key:<id>、Session token による場合は session:<id>、24 時間でタイムアウトした場合は system です。詳しくは 承認とフォーム を参照してください。
Client
| 種類 | フィールド | |
|---|---|---|
client_registered |
client_id、name、lifetime、tools |
Client が、付けられた名前で参加しました。 |
client_tools_updated |
client_id、tools |
Client が自分の Tool を置き換えました。 |
client_left |
client_id、reason |
departed か timed_out です。 |
client_tool_dispatched |
call_id、client_id、tool、arguments |
Client に送られた呼び出しです。tool は Tool 自身の名前です。 |
client_tool_acked |
call_id、client_id |
Client が呼び出しを受け取ったことを通知しました。 |
client_tool_failed |
call_id、client_id、reason |
client_gone、ack_timeout、result_timeout、run_gone のいずれかです。 |
詳しくは Client tool を参照してください。