:doc:`LexModelsV2 <../../lexv2-models>` / Client / start_bot_resource_generation

*****************************
start_bot_resource_generation
*****************************



.. py:method:: LexModelsV2.Client.start_bot_resource_generation(**kwargs)

  

  Starts a request for the descriptive bot builder to generate a bot locale configuration based on the prompt you provide it. After you make this call, use the ``DescribeBotResourceGeneration`` operation to check on the status of the generation and for the ``generatedBotLocaleUrl`` when the generation is complete. Use that value to retrieve the Amazon S3 object containing the bot locale configuration. You can then modify and import this configuration.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/StartBotResourceGeneration>`_  


  **Request Syntax**
  ::

    response = client.start_bot_resource_generation(
        generationInputPrompt='string',
        botId='string',
        botVersion='string',
        localeId='string'
    )
    
  :type generationInputPrompt: string
  :param generationInputPrompt: **[REQUIRED]** 

    The prompt to generate intents and slot types for the bot locale. Your description should be both *detailed* and *precise* to help generate appropriate and sufficient intents for your bot. Include a list of actions to improve the intent creation process.

    

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

    The unique identifier of the bot for which to generate intents and slot types.

    

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

    The version of the bot for which to generate intents and slot types.

    

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

    The locale of the bot for which to generate intents and slot types.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'generationInputPrompt': 'string',
          'generationId': 'string',
          'botId': 'string',
          'botVersion': 'string',
          'localeId': 'string',
          'generationStatus': 'Failed'|'Complete'|'InProgress',
          'creationDateTime': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **generationInputPrompt** *(string) --* 

        The prompt that was used generate intents and slot types for the bot locale.

        
      

      - **generationId** *(string) --* 

        The unique identifier of the generation request.

        
      

      - **botId** *(string) --* 

        The unique identifier of the bot for which the generation request was made.

        
      

      - **botVersion** *(string) --* 

        The version of the bot for which the generation request was made.

        
      

      - **localeId** *(string) --* 

        The locale of the bot for which the generation request was made.

        
      

      - **generationStatus** *(string) --* 

        The status of the generation request.

        
      

      - **creationDateTime** *(datetime) --* 

        The date and time at which the generation request was made.

        
  
  **Exceptions**
  
  *   :py:class:`LexModelsV2.Client.exceptions.ThrottlingException`

  
  *   :py:class:`LexModelsV2.Client.exceptions.ServiceQuotaExceededException`

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

  
  *   :py:class:`LexModelsV2.Client.exceptions.PreconditionFailedException`

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

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

  