API Reference

Beta

Agent Data

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Aggregate Agent Data

client.Beta.AgentData.Aggregate(ctx, params) (*PaginatedCursorPost[BetaAgentDataAggregateResponse], error)

POST/api/v1/beta/agent-data/:aggregate

Aggregate agent data with grouping and optional counting/first item retrieval.

ParametersExpand Collapse

params BetaAgentDataAggregateParams

DeploymentName param.Field[string]

Body param: The agent deployment’s name to aggregate data for

OrganizationID param.Field[string]optional

Query param

formatuuid

ProjectID param.Field[string]optional

Query param

formatuuid

Collection param.Field[string]optional

Body param: The logical agent data collection to aggregate data for

Count param.Field[bool]optional

Body param: Whether to count the number of items in each group

Filter param.Field[map[string, BetaAgentDataAggregateParamsFilter]]optional

Body param: A filter object or expression that filters resources listed in the response.

Eq BetaAgentDataAggregateParamsFilterEqUnionoptional

One of the following:

float64

string

Time

Excludes []BetaAgentDataAggregateParamsFilterExcludeUnionoptional

One of the following:

float64

string

Time

Gt BetaAgentDataAggregateParamsFilterGtUnionoptional

One of the following:

float64

string

Time

Gte BetaAgentDataAggregateParamsFilterGteUnionoptional

One of the following:

float64

string

Time

Includes []BetaAgentDataAggregateParamsFilterIncludeUnionoptional

One of the following:

float64

string

Time

Lt BetaAgentDataAggregateParamsFilterLtUnionoptional

One of the following:

float64

string

Time

Lte BetaAgentDataAggregateParamsFilterLteUnionoptional

One of the following:

float64

string

Time

Ne BetaAgentDataAggregateParamsFilterNeUnionoptional

One of the following:

float64

string

Time

First param.Field[bool]optional

Body param: Whether to return the first item in each group (Sorted by created_at)

GroupBy param.Field[[]string]optional

Body param: The fields to group by. If empty, the entire dataset is grouped on. e.g. if left out, can be used for simple count operations

Offset param.Field[int64]optional

Body param: The offset to start from. If not provided, the first page is returned

maximum1000

minimum0

OrderBy param.Field[string]optional

Body param: A comma-separated list of fields to order by, sorted in ascending order. Use ‘field_name desc’ to specify descending order.

PageSize param.Field[int64]optional

Body param: The maximum number of items to return. The service may return fewer than this value. If unspecified, a default page size will be used. The maximum value is typically 1000; values above this will be coerced to the maximum.

PageToken param.Field[string]optional

Body param: A page token, received from a previous list call. Provide this to retrieve the subsequent page.

ReturnsExpand Collapse

type BetaAgentDataAggregateResponse struct{…}

API Result for a single group in the aggregate response

GroupKey map[string, any]

Count int64optional

FirstItem map[string, any]optional

Aggregate Agent Data

Go

HTTP

TypeScript

Python

Java

Go

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/run-llama/llama-parse-go"
  "github.com/run-llama/llama-parse-go/option"
)

func main() {
  client := llamacloudprod.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.Beta.AgentData.Aggregate(context.TODO(), llamacloudprod.BetaAgentDataAggregateParams{
    DeploymentName: "deployment_name",
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

200 example

{
  "items": [
    {
      "group_key": {
        "foo": "bar"
      },
      "count": 0,
      "first_item": {
        "foo": "bar"
      }
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "group_key": {
        "foo": "bar"
      },
      "count": 0,
      "first_item": {
        "foo": "bar"
      }
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}