sessions

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

Overview

Name	sessions
Type	Resource
Id	aws.nova_act.sessions

Fields

The following fields are returned by SELECT queries:

list_sessions

Name	Datatype	Description
session_id	string	The unique identifier of the session. (pattern: <code>[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_sessions	select	workflow_definition_name, workflow_run_id, region	maxResults, nextToken	Lists all sessions within a specific workflow run.
create_session	insert	workflow_definition_name, workflow_run_id, region		Creates a new session context within a workflow run to manage conversation state and acts.

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
region	string	AWS region (default: us-east-1)
workflow_definition_name	string	The name of the workflow definition containing the workflow run.
workflow_run_id	string	The unique identifier of the workflow run to create the session in.
maxResults	integer	The maximum number of sessions to return in a single response.
nextToken	string	The token for retrieving the next page of results.

SELECT examples

list_sessions

Lists all sessions within a specific workflow run.

SELECT
session_id
FROM aws.nova_act.sessions
WHERE workflow_definition_name = '{{ workflow_definition_name }}' -- required
AND workflow_run_id = '{{ workflow_run_id }}' -- required
AND region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

INSERT examples

create_session

Creates a new session context within a workflow run to manage conversation state and acts.

INSERT INTO aws.nova_act.sessions (
clientToken,
workflow_definition_name,
workflow_run_id,
region
)
SELECT 
'{{ clientToken }}',
'{{ workflow_definition_name }}',
'{{ workflow_run_id }}',
'{{ region }}'
RETURNING
session_id
;

Manifest

# Description fields are for documentation purposes
- name: sessions
props:
  - name: workflow_definition_name
    value: "{{ workflow_definition_name }}"
    description: Required parameter for the sessions resource.
  - name: workflow_run_id
    value: "{{ workflow_run_id }}"
    description: Required parameter for the sessions resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the sessions resource.
  - name: clientToken
    value: "{{ clientToken }}"