Skip to content

Commit 1282d01

Browse files
Add AGENT_RESPONSE event type and view (#1761)
* Add AGENT_RESPONSE event type and view * Update docs/integrations/bigquery-agent-analytics.md --------- Co-authored-by: Kristopher Overholt <koverholt@google.com>
1 parent a3dd940 commit 1282d01

1 file changed

Lines changed: 22 additions & 1 deletion

File tree

docs/integrations/bigquery-agent-analytics.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,7 @@ shows the BigQuery view optionally created when
8585
| `HITL_CONFIRMATION_REQUEST_COMPLETED` | User provides confirmation response | synthetic tool name, result | *(base table only)* |
8686
| `HITL_INPUT_REQUEST_COMPLETED` | User provides input response | synthetic tool name, result | *(base table only)* |
8787
| `A2A_INTERACTION` | Remote A2A call completes | response, task ID, context ID, request/response | `v_a2a_interaction` |
88+
| `AGENT_RESPONSE` | Final agent response is yielded | response (content), source event ID/author/branch (attributes) | `v_agent_response` |
8889

8990
## Quickstart
9091

@@ -468,7 +469,7 @@ Every view includes these **common columns**: `timestamp`, `event_type`,
468469
`agent`, `session_id`, `invocation_id`, `user_id`, `trace_id`, `span_id`,
469470
`parent_span_id`, `status`, `error_message`, `is_truncated`.
470471

471-
The following table lists all 16 auto-created views and their event-specific
472+
The following table lists all auto-created views and their event-specific
472473
columns:
473474

474475
| View Name | Event-Specific Columns |
@@ -489,6 +490,7 @@ columns:
489490
| **`v_hitl_confirmation_request`** | `tool_name` (STRING), `tool_args` (JSON) |
490491
| **`v_hitl_input_request`** | `tool_name` (STRING), `tool_args` (JSON) |
491492
| **`v_a2a_interaction`** | `response_content` (JSON), `a2a_task_id` (STRING), `a2a_context_id` (STRING), `a2a_request` (JSON), `a2a_response` (JSON) |
493+
| **`v_agent_response`** | `response_text` (STRING), `source_event_id` (STRING), `source_event_author` (STRING), `source_event_branch` (STRING) |
492494

493495
## Event types and payloads {#event-types}
494496

@@ -698,6 +700,25 @@ updated by tools).
698700
| `AGENT_STARTING` | `"You are a helpful agent..."` |
699701
| `AGENT_COMPLETED` | `{}` |
700702
| `USER_MESSAGE_RECEIVED` | `{"text_summary": "Help me book a flight."}` |
703+
| `AGENT_RESPONSE` | `{"response": "Here are the flights..."}` |
704+
705+
**AGENT_RESPONSE**
706+
707+
Logged when the agent yields a final response to the user. The response text is stored in `content`, while the source event metadata is stored in `attributes`.
708+
709+
```json
710+
{
711+
"event_type": "AGENT_RESPONSE",
712+
"content": {
713+
"response": "Here are the available flights..."
714+
},
715+
"attributes": {
716+
"source_event_id": "evt-abc123",
717+
"source_event_author": "flight_agent",
718+
"source_event_branch": "main"
719+
}
720+
}
721+
```
701722

702723
### Human-in-the-Loop (HITL) Events {#hitl-events}
703724

0 commit comments

Comments
 (0)