memories

Creates, updates, deletes, gets or lists a memories resource.

Overview

Name	memories
Type	Resource
Id	pagerduty.sre_agent.memories

Fields

The following fields are returned by SELECT queries:

list

An array of SRE Agent memories.

Name	Datatype	Description
id	string	The unique identifier for this memory.
attributes	object	Additional attributes associated with this memory.
content	string	The content of the SRE memory.
created_at	string (date-time)	The date and time the memory was created.
updated_at	string (date-time)	The date and time the memory was last updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select		limit, service_id, incident_id, type	Search SRE Agent memories for the account.<br /><br />Memories are knowledge learned by the SRE Agent, including service runbooks, service profiles,<br />incident playbooks, and incident summaries. Filter by service ID, incident ID, or memory type to retrieve<br />relevant memories.<br /><br />Scoped OAuth requires: incident.read<br />
update	update	id, memory		Update an existing SRE Agent memory. Changes to the runbook may not update in a currently ongoing conversation, but will be available to new conversations. To modify the runbook for an in progress conversation update the runbook via the agent instead.<br /><br />Scoped OAuth requires: sre_agent.write<br />
delete	delete	id		Permanently delete an SRE Agent memory. Deleting a runbook may not delete it immediately from a currently running conversation, but will remove it from all future conversations. To modify an in progress conversation ask the agent to delete the runbook instead.<br /><br />Scoped OAuth requires: sre_agent.write<br />

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
id	string	The ID of the resource.
incident_id	string	Filter memories by incident ID
limit	integer	The number of results to return per page.
service_id	string	Filter memories by service ID
type	string	Filter memories by type

SELECT examples

list

Search SRE Agent memories for the account.<br /><br />Memories are knowledge learned by the SRE Agent, including service runbooks, service profiles,<br />incident playbooks, and incident summaries. Filter by service ID, incident ID, or memory type to retrieve<br />relevant memories.<br /><br />Scoped OAuth requires: incident.read<br />

SELECT
id,
attributes,
content,
created_at,
updated_at
FROM pagerduty.sre_agent.memories
WHERE limit = '{{ limit }}'
AND service_id = '{{ service_id }}'
AND incident_id = '{{ incident_id }}'
AND type = '{{ type }}'
;

UPDATE examples

update

Update an existing SRE Agent memory. Changes to the runbook may not update in a currently ongoing conversation, but will be available to new conversations. To modify the runbook for an in progress conversation update the runbook via the agent instead.<br /><br />Scoped OAuth requires: sre_agent.write<br />

UPDATE pagerduty.sre_agent.memories
SET 
memory = '{{ memory }}'
WHERE 
id = '{{ id }}' --required
AND memory = '{{ memory }}' --required
RETURNING
memory;

DELETE examples

delete

Permanently delete an SRE Agent memory. Deleting a runbook may not delete it immediately from a currently running conversation, but will remove it from all future conversations. To modify an in progress conversation ask the agent to delete the runbook instead.<br /><br />Scoped OAuth requires: sre_agent.write<br />

DELETE FROM pagerduty.sre_agent.memories
WHERE id = '{{ id }}' --required
;