使用 AWS AppConfig提供的用戶端評估

將 Evidently 用戶端評估 Lambda 層新增至 Lambda 函數並進行設定

1. 如果您尚未建立 Lambda 函數，請進行建立。

2. 將用戶端評估層新增至函數。如果您尚未指定其 ARN，您可以從 AWS 圖層清單中選取它。如需詳細資訊，請參閱設定函數以使用層和 Lambda AWS AppConfig 延伸的可用版本。

3. 建立名為 EvidentlyAppConfigCachingAgentPolicy 且包含以下內容的 IAM 政策，並將其連接到函數的執行角色。如需詳細資訊，請參閱 Lambda 執行角色。

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "VisualEditor0",
               "Effect": "Allow",
               "Action": [
                   "appconfig:GetLatestConfiguration",
                   "appconfig:StartConfigurationSession",
                   "evidently:PutProjectEvents"
               ],
               "Resource": "*"
           }
       ]
   }

4. 將所需的環境變數 AWS_APPCONFIG_EXTENSION_EVIDENTLY_CONFIGURATIONS 新增至 Lambda 函數。此環境變數指定 Evidently 專案與 AWS AppConfig 資源之間的映射。

   如果您將此函數用於某個 Evidently 專案，請將環境變數的值設定為：applications/APP_ID/environments/ENVIRONMENT_ID/configurations/PROJECT_NAME

   如果您將此函數用於多個 Evidently 專案，請使用逗號來分隔值，如下列範例所示：applications/APP_ID_1/environments/ENVIRONMENT_ID_1/configurations/PROJECT_NAME_1, applications/APP_ID_2/environments/ENVIRONMENT_ID_2/configurations/PROJECT_NAME_2

5. (選用) 設定其他環境變數。如需詳細資訊，請參閱設定 AWS AppConfig Lambda 延伸模組。

6. 在應用程式中，透過將 EvaluateFeature 傳送至 localhost 以在本機取得 Evidently 評估。

   Python 範例：

   import boto3
   from botocore.config import Config
           
   def lambda_handler(event, context):
       local_client = boto3.client(
           'evidently',
           endpoint_url="http://localhost:2772",
           config=Config(inject_host_prefix=False)
       )
       response = local_client.evaluate_feature(
           project=event['project'],
           feature=event['feature'],
           entityId=event['entityId']
       )
       print(response)

   Node.js 範例：

   const AWS = require('aws-sdk');
   const evidently = new AWS.Evidently({
       region: "us-west-2",
       endpoint: "http://localhost:2772",
       hostPrefixEnabled: false
   });
   
   exports.handler = async (event) => {
       
       const evaluation = await evidently.evaluateFeature({
           project: 'John_ETCProject_Aug2022',
           feature: 'Feature_IceCreamFlavors',
           entityId: 'John'
       }).promise()
       
       console.log(evaluation)
       const response = {
           statusCode: 200,
           body: evaluation,
       };
       return response;
   };

   Kotlin 範例：

   String localhostEndpoint = "http://localhost:2772/"
   public AmazonCloudWatchEvidentlyClient getEvidentlyLocalClient() {
       return AmazonCloudWatchEvidentlyClientBuilder.standard()
           .withEndpointConfiguration(AwsClientBuilder.EndpointConfiguration(localhostEndpoint, region))
           .withClientConfiguration(ClientConfiguration().withDisableHostPrefixInjection(true))
           .withCredentials(credentialsProvider)
           .build();
   }
   
   AmazonCloudWatchEvidentlyClient evidently = getEvidentlyLocalClient();
   
   // EvaluateFeature via local client.
   EvaluateFeatureRequest evaluateFeatureRequest = new EvaluateFeatureRequest().builder()
      .withProject(${YOUR_PROJECT}) //Required.
      .withFeature(${YOUR_FEATURE}) //Required.
      .withEntityId(${YOUR_ENTITY_ID}) //Required.
      .withEvaluationContext(${YOUR_EVAL_CONTEXT}) //Optional: a JSON object of attributes that you can optionally pass in as part of the evaluation event sent to Evidently.
      .build();
      
   EvaluateFeatureResponse evaluateFeatureResponse = evidently.evaluateFeature(evaluateFeatureRequest);
   
   // PutProjectEvents via local client. 
   PutProjectEventsRequest putProjectEventsRequest = new PutProjectEventsRequest().builder()
       .withData(${YOUR_DATA})
       .withTimeStamp(${YOUR_TIMESTAMP})
       .withType(${YOUR_TYPE})
       .build();
       
   PutProjectEvents putProjectEventsResponse = evidently.putProjectEvents(putProjectEventsRequest);