Add Nova Text PHP example

Author: DennisTraub

php/example_code/bedrock-runtime/Models/AmazonNova/Text/Converse.php

@@ -0,0 +1,62 @@
+<?php
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+namespace BedrockRuntime\Models\AmazonNova\Text;
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// snippet-start:[php.example_code.bedrock-runtime.service.Converse_AmazonNovaText]
+// Use the Conversation API to send a text message to Amazon Nova.
+
+use Aws\BedrockRuntime\BedrockRuntimeClient;
+use Aws\Exception\AwsException;
+use RuntimeException;
+
+class Converse
+{
+    public function converse(): string
+    {
+        // Create a Bedrock Runtime client in the AWS Region you want to use.
+        $client = new BedrockRuntimeClient([
+            'region' => 'us-east-1',
+            'profile' => 'default'
+        ]);
+
+// Set the model ID, e.g., Amazon Nova Lite.
+        $modelId = 'amazon.nova-lite-v1:0';
+
+// Start a conversation with the user message.
+        $userMessage = "Describe the purpose of a 'hello world' program in one line.";
+        $conversation = [
+            [
+                "role" => "user",
+                "content" => [["text" => $userMessage]]
+            ]
+        ];
+
+        try {
+            // Send the message to the model, using a basic inference configuration.
+            $response = $client->converse([
+                'modelId' => $modelId,
+                'messages' => $conversation,
+                'inferenceConfig' => [
+                    'maxTokens' => 512,
+                    'temperature' => 0.5
+                ]
+            ]);
+
+            // Extract and return the response text.
+            $responseText = $response['output']['message']['content'][0]['text'];
+            return $responseText;
+
+        } catch (AwsException $e) {
+            echo "ERROR: Can't invoke {$modelId}. Reason: {$e->getAwsErrorMessage()}";
+            throw new RuntimeException("Failed to invoke model: " . $e->getAwsErrorMessage(), 0, $e);
+        }
+    }
+}
+
+$demo = new Converse();
+echo $demo->converse();
+
+// snippet-end:[php.example_code.bedrock-runtime.service.Converse_AmazonNovaText]

php/example_code/bedrock-runtime/composer.json

@@ -1,6 +1,6 @@
 {
     "require": {
-        "aws/aws-sdk-php": "^3.336",
+        "aws/aws-sdk-php": "^3.343",
         "guzzlehttp/guzzle": "^7.9.2"
     },
     "autoload": {
@@ -11,5 +11,8 @@
             "BedrockRuntime\\": "../bedrock-runtime/",
             "AwsUtilities\\": "../aws_utilities/"
         }
+    },
+    "scripts": {
+        "Models/AmazonNova/Text/Converse": "php Models/AmazonNova/Text/Converse.php"
     }
 }