:doc:`NovaActService <../../nova-act>` / Client / invoke_act_step

***************
invoke_act_step
***************



.. py:method:: NovaActService.Client.invoke_act_step(**kwargs)

  

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

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/nova-act-2025-08-22/InvokeActStep>`_  


  **Request Syntax**
  ::

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

    The name of the workflow definition containing the act.

    

  
  :type workflowRunId: string
  :param workflowRunId: **[REQUIRED]** 

    The unique identifier of the workflow run containing the act.

    

  
  :type sessionId: string
  :param sessionId: **[REQUIRED]** 

    The unique identifier of the session containing the act.

    

  
  :type actId: string
  :param actId: **[REQUIRED]** 

    The unique identifier of the act to invoke the next step for.

    

  
  :type callResults: list
  :param callResults: **[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.

            

          
        
    
    

  :type previousStepId: string
  :param previousStepId: 

    The identifier of the previous step, used for tracking execution flow.

    

  
  
  :rtype: 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** (:ref:`document<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**
  
  *   :py:class:`NovaActService.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`NovaActService.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`NovaActService.Client.exceptions.ConflictException`

  
  *   :py:class:`NovaActService.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`NovaActService.Client.exceptions.ThrottlingException`

  
  *   :py:class:`NovaActService.Client.exceptions.InternalServerException`

  
  *   :py:class:`NovaActService.Client.exceptions.ValidationException`

  