NovaActService / Client / invoke_act_step

invoke_act_step¶

NovaActService.Client.invoke_act_step(**kwargs)¶

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

Request Syntax

response = client.invoke_act_step(
    workflowDefinitionName='string',
    workflowRunId='string',
    sessionId='string',
    actId='string',
    callResults=[
        {
            'callId': 'string',
            'content': [
                {
                    'text': 'string'
                },
            ]
        },
    ],
    previousStepId='string'
)

Parameters:

workflowDefinitionName (string) –
[REQUIRED]

The name of the workflow definition containing the act.
workflowRunId (string) –
[REQUIRED]

The unique identifier of the workflow run containing the act.
sessionId (string) –
[REQUIRED]

The unique identifier of the session containing the act.
actId (string) –
[REQUIRED]

The unique identifier of the act to invoke the next step for.
callResults (list) –
[REQUIRED]

The results from previous tool calls that the act requested.
- (dict) –
  
  The result returned from executing a tool call.
  - callId (string) –
    
    The identifier of the tool call that this result corresponds to.
  - content (list) – [REQUIRED]
    
    The content returned by the tool execution, which can include text or other media types.
    - (dict) –
      
      Content returned from a tool call execution.
      
      Note
      This is a Tagged Union structure. Only one of the following top level keys can be set: text.
      - text (string) –
        
        Text content returned from the tool execution.
previousStepId (string) – The identifier of the previous step, used for tracking execution flow.

Return type:

dict

Returns:

Response Syntax

{
    'calls': [
        {
            'callId': 'string',
            'input': {...}|[...]|123|123.4|'string'|True|None,
            'name': 'string'
        },
    ],
    'stepId': 'string'
}

Response Structure

(dict) –
- calls (list) –
  
  A list of tool calls that the act wants to execute in this step.
  - (dict) –
    
    A request for the client to execute a specific tool with given parameters.
    - callId (string) –
      
      A unique identifier for this tool call, used to match results back to requests.
    - input (document) –
      
      The input parameters for the tool call, formatted according to the tool’s schema.
    - name (string) –
      
      The name of the tool to invoke, following the pattern ‘tool.{toolName}’ or ‘browser.{browserAction}’.
- stepId (string) –
  
  The unique identifier for this execution step.

Exceptions

NovaActService.Client.exceptions.ServiceQuotaExceededException
NovaActService.Client.exceptions.AccessDeniedException
NovaActService.Client.exceptions.ConflictException
NovaActService.Client.exceptions.ResourceNotFoundException
NovaActService.Client.exceptions.ThrottlingException
NovaActService.Client.exceptions.InternalServerException
NovaActService.Client.exceptions.ValidationException