DevOpsAgentService / Client / update_recommendation

update_recommendation

DevOpsAgentService.Client.update_recommendation(**kwargs)

Updates an existing recommendation with new content, status, or metadata

See also: AWS API Documentation

Request Syntax

response = client.update_recommendation(
    agentSpaceId='string',
    recommendationId='string',
    status='PROPOSED'|'ACCEPTED'|'REJECTED'|'CLOSED'|'COMPLETED'|'UPDATE_IN_PROGRESS',
    additionalContext='string',
    clientToken='string'
)
Parameters:
  • agentSpaceId (string) –

    [REQUIRED]

    The unique identifier for the agent space containing the recommendation

  • recommendationId (string) –

    [REQUIRED]

    The unique identifier for the recommendation to update

  • status (string) – Current status of the recommendation

  • additionalContext (string) – Additional context for recommendation

  • clientToken (string) –

    A unique token that ensures idempotency of the request

    This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'recommendation': {
        'agentSpaceArn': 'string',
        'recommendationId': 'string',
        'taskId': 'string',
        'goalId': 'string',
        'title': 'string',
        'content': {
            'summary': 'string',
            'spec': 'string'
        },
        'status': 'PROPOSED'|'ACCEPTED'|'REJECTED'|'CLOSED'|'COMPLETED'|'UPDATE_IN_PROGRESS',
        'priority': 'HIGH'|'MEDIUM'|'LOW',
        'goalVersion': 123,
        'additionalContext': 'string',
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1),
        'version': 123
    }
}

Response Structure

  • (dict) –

    Response structure containing the updated recommendation

    • recommendation (dict) –

      The updated recommendation

      • agentSpaceArn (string) –

        ARN of the agent space this recommendation belongs to

      • recommendationId (string) –

        The unique identifier for this recommendation

      • taskId (string) –

        ID of the task that generated the recommendation

      • goalId (string) –

        ID of the goal this recommendation is associated with

      • title (string) –

        The title of the recommendation

      • content (dict) –

        Content of the recommendation

        • summary (string) –

          A brief summary of the recommendation.

        • spec (string) –

          Agent-ready specification with detailed implementation steps

      • status (string) –

        Current status of the recommendation

      • priority (string) –

        Priority level of the recommendation

      • goalVersion (integer) –

        Version of the goal at the time this recommendation was generated

      • additionalContext (string) –

        Additional context for recommendation

      • createdAt (datetime) –

        Timestamp when this recommendation was created

      • updatedAt (datetime) –

        Timestamp when this recommendation was last updated

      • version (integer) –

        Version number for optimistic locking

Exceptions

  • DevOpsAgentService.Client.exceptions.ValidationException

  • DevOpsAgentService.Client.exceptions.ContentSizeExceededException

  • DevOpsAgentService.Client.exceptions.ServiceQuotaExceededException

  • DevOpsAgentService.Client.exceptions.ConflictException

  • DevOpsAgentService.Client.exceptions.InternalServerException

  • DevOpsAgentService.Client.exceptions.AccessDeniedException

  • DevOpsAgentService.Client.exceptions.ResourceNotFoundException

  • DevOpsAgentService.Client.exceptions.ThrottlingException

  • DevOpsAgentService.Client.exceptions.InvalidParameterException