AgentToolActivityEvent

One tool request or tool result in an agent's saved conversation.

  • invocation_id
    Type: string
    required

    Ties a tool request to its result within the same agent message.

  • kind
    Type: enum
    required

    tool_called for a tool request, tool_result for its result.

    values
    task_startedtool_calledtool_resulttask_finished
  • sequence
    Type: integer
    min:  
    0
    required

    The recorded order of this event within this activity, from 0.

  • occurred_at
    Type: stringFormat: date-timenullable

    When the event happened, only when the record holds that time. Never the time the agent state was saved.

  • outcome
    Type: enumnullable

    returned or error when the recorded result says so; otherwise null.

    values
    returnederrortimeoutcancelled
  • payload_state
    Type: enum

    How much of the payload payload_text shows.

    values
    fullredactedtruncatedredacted_truncatedunavailable
  • payload_text
    Type: stringnullable

    A sanitized preview of the tool input or the tool result. Credential fields show as [redacted]. Null when no preview is available or the whole payload was withheld.

  • tool_name
    Type: stringnullable

    The tool that was called. Null when a recorded result has no recorded request.

  • turn
    Type: integernullable

    The index of the last visible transcript message before this event, when it can be placed.