acts

Creates, updates, deletes, gets or lists an acts resource.

Overview

Name	acts
Type	Resource
Id	aws.nova_act.acts

Fields

The following fields are returned by SELECT queries:

list_acts

Name	Datatype	Description
act_id	string	The unique identifier of the act. (pattern: <code>[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}</code>)
ended_at	string (date-time)	The timestamp when the act completed execution, if applicable.
session_id	string	The unique identifier of the session containing this act. (pattern: <code>[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}</code>)
started_at	string (date-time)	The timestamp when the act started execution.
status	string	The current execution status of the act. (RUNNING, PENDING_CLIENT_ACTION, PENDING_HUMAN_ACTION, SUCCEEDED, FAILED, TIMED_OUT)
trace_location	object	The location where trace information for this act is stored.
workflow_run_id	string	The unique identifier of the workflow run containing this act. (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_acts	select	workflow_definition_name, region	workflowRunId, sessionId, maxResults, nextToken	Lists all acts within a specific session with their current status and execution details.
create_act	insert	workflow_definition_name, workflow_run_id, session_id, region, task		Creates a new AI task (act) within a session that can interact with tools and perform specific actions.
update_act	update	workflow_definition_name, workflow_run_id, session_id, act_id, region, status		Updates an existing act's configuration, status, or error information.
invoke_act_step	exec	workflow_definition_name, workflow_run_id, session_id, act_id, region, callResults		Executes the next step of an act, processing tool call results and returning new tool calls if needed.

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

SELECT examples

list_acts

Lists all acts within a specific session with their current status and execution details.

SELECT
act_id,
ended_at,
session_id,
started_at,
status,
trace_location,
workflow_run_id
FROM aws.nova_act.acts
WHERE workflow_definition_name = '{{ workflow_definition_name }}' -- required
AND region = '{{ region }}' -- required
AND workflowRunId = '{{ workflowRunId }}'
AND sessionId = '{{ sessionId }}'
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

INSERT examples

create_act

Creates a new AI task (act) within a session that can interact with tools and perform specific actions.

INSERT INTO aws.nova_act.acts (
task,
toolSpecs,
clientToken,
workflow_definition_name,
workflow_run_id,
session_id,
region
)
SELECT 
'{{ task }}' /* required */,
'{{ toolSpecs }}',
'{{ clientToken }}',
'{{ workflow_definition_name }}',
'{{ workflow_run_id }}',
'{{ session_id }}',
'{{ region }}'
RETURNING
act_id,
status
;

Manifest

# Description fields are for documentation purposes
- name: acts
props:
  - name: workflow_definition_name
    value: "{{ workflow_definition_name }}"
    description: Required parameter for the acts resource.
  - name: workflow_run_id
    value: "{{ workflow_run_id }}"
    description: Required parameter for the acts resource.
  - name: session_id
    value: "{{ session_id }}"
    description: Required parameter for the acts resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the acts resource.
  - name: task
    value: "{{ task }}"
  - name: toolSpecs
    value:
      - name: "{{ name }}"
        description: "{{ description }}"
        inputSchema:
          json: "{{ json }}"
  - name: clientToken
    value: "{{ clientToken }}"

UPDATE examples

update_act

Updates an existing act's configuration, status, or error information.

UPDATE aws.nova_act.acts
SET 
status = '{{ status }}',
error = '{{ error }}'
WHERE 
workflow_definition_name = '{{ workflow_definition_name }}' --required
AND workflow_run_id = '{{ workflow_run_id }}' --required
AND session_id = '{{ session_id }}' --required
AND act_id = '{{ act_id }}' --required
AND region = '{{ region }}' --required
AND status = '{{ status }}' --required;

Lifecycle Methods

invoke_act_step

Executes the next step of an act, processing tool call results and returning new tool calls if needed.

EXEC aws.nova_act.acts.invoke_act_step 
@workflow_definition_name='{{ workflow_definition_name }}' --required, 
@workflow_run_id='{{ workflow_run_id }}' --required, 
@session_id='{{ session_id }}' --required, 
@act_id='{{ act_id }}' --required, 
@region='{{ region }}' --required 
@@json=
'{
"callResults": "{{ callResults }}", 
"previousStepId": "{{ previousStepId }}"
}'
;