Method: memories.ingestEvents

Full name: projects.locations.reasoningEngines.memories.ingestEvents

Ingests events for a Memory Bank.

Endpoint

post https://{service-endpoint}/v1beta1/{parent}/memories:ingestEvents

Where {service-endpoint} is one of the supported service endpoints.

Path parameters

parent string

Required. The resource name of the ReasoningEngine to ingest events to. Format: projects/{project}/locations/{location}/reasoningEngines/{reasoningEngine}

Request body

The request body contains data with the following structure:

Fields
streamId string

Optional. The id of the stream to ingest events into. If not provided, a new one will be created.

generationTriggerConfig object (MemoryGenerationTriggerConfig)

Optional. Configuration for triggering memory generation from this ingestion. If not set, then the stream will be force flushed immediately.

scope map (key: string, value: string)

Required. The scope of the memories that should be generated from the stream. Memories will be consolidated across memories with the same scope. scope values cannot contain the wildcard character '*'.

forceFlush boolean

Optional. Forces a flush of all pending events in the stream and triggers memory generation immediately bypassing any conditions configured in the generationTriggerConfig.

source Union type
Source of the events to ingest. source can be only one of the following:
directContentsSource object (IngestionDirectContentsSource)

Ingest events directly from the request.

Response body

If successful, the response body contains an instance of Operation.

IngestionDirectContentsSource

Ingest events directly from the request.

Fields
events[] object (Event)

Required. The events to ingest.

JSON representation 
{
  "events": [
    {
      object (Event)
    }
  ]
}

Event

A single event to ingest.

Fields
content object (Content)

Required. The content of the event.

eventId string

Optional. A unique identifier for the event. If an event with the same eventId is ingested multiple times, it will be de-duplicated.

eventTime string (Timestamp format)

Optional. The time at which the event occurred. If provided, this timestamp will be used for ordering events within a stream. If not provided, the server-side ingestion time will be used.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

JSON representation 
{
  "content": {
    object (Content)
  },
  "eventId": string,
  "eventTime": string
}