Skip to content

Commit ab85eb9

Browse files
DennisTraubDennisTraub
authored
PHP: Add example for Amazon Nova text models, remove example for Jurassic-2 (#7445)
* Add .local config * Add Nova Text PHP example * Remove PHP examples for Jurassic-2 (deprecated) * Regenerate docs * Revert add .gitattributes * Fix formatting
1 parent 0f43381 commit ab85eb9

File tree

9 files changed

+1909
-113
lines changed

9 files changed

+1909
-113
lines changed

‎.doc_gen/metadata/bedrock-runtime_metadata.yaml‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,14 @@ bedrock-runtime_Converse_AmazonNovaText:
124124
genai: some
125125
snippet_tags:
126126
- Bedrock.ConverseTool.dotnetv3.SendConverseRequest
127+
PHP:
128+
versions:
129+
- sdk_version: 3
130+
github: php/example_code/bedrock-runtime
131+
excerpts:
132+
- description: Send a text message to Amazon Nova, using Bedrock's Converse API.
133+
snippet_tags:
134+
- php.example_code.bedrock-runtime.service.Converse_AmazonNovaText
127135
Python:
128136
versions:
129137
- sdk_version: 3
@@ -792,14 +800,6 @@ bedrock-runtime_InvokeModel_Ai21LabsJurassic2:
792800
snippet_tags:
793801
- gov2.bedrock-runtime.InvokeModelWrapper.struct
794802
- gov2.bedrock-runtime.InvokeJurassic2
795-
PHP:
796-
versions:
797-
- sdk_version: 3
798-
github: php/example_code/bedrock-runtime
799-
excerpts:
800-
- description: Use the Invoke Model API to send a text message.
801-
snippet_tags:
802-
- php.example_code.bedrock-runtime.service.invokeJurassic2
803803
services:
804804
bedrock-runtime: {InvokeModel}
805805

‎php/example_code/bedrock-runtime/BedrockRuntimeService.php‎

Lines changed: 0 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -63,36 +63,6 @@ public function invokeClaude($prompt)
6363
}
6464
// snippet-end:[php.example_code.bedrock-runtime.service.invokeClaude]
6565

66-
// snippet-start:[php.example_code.bedrock-runtime.service.invokeJurassic2]
67-
public function invokeJurassic2($prompt)
68-
{
69-
# The different model providers have individual request and response formats.
70-
# For the format, ranges, and default values for AI21 Labs Jurassic-2, refer to:
71-
# https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-jurassic2.html
72-
73-
$completion = "";
74-
try {
75-
$modelId = 'ai21.j2-mid-v1';
76-
$body = [
77-
'prompt' => $prompt,
78-
'temperature' => 0.5,
79-
'maxTokens' => 200,
80-
];
81-
$result = $this->bedrockRuntimeClient->invokeModel([
82-
'contentType' => 'application/json',
83-
'body' => json_encode($body),
84-
'modelId' => $modelId,
85-
]);
86-
$response_body = json_decode($result['body']);
87-
$completion = $response_body->completions[0]->data->text;
88-
} catch (Exception $e) {
89-
echo "Error: ({$e->getCode()}) - {$e->getMessage()}\n";
90-
}
91-
92-
return $completion;
93-
}
94-
// snippet-end:[php.example_code.bedrock-runtime.service.invokeJurassic2]
95-
9666
// snippet-start:[php.example_code.bedrock-runtime.service.invokeStableDiffusion]
9767
public function invokeStableDiffusion(string $prompt, int $seed, string $style_preset)
9868
{

‎php/example_code/bedrock-runtime/GettingStartedWithBedrockRuntime.php‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,6 @@ public function runExample()
2525
echo "\nPrompt: " . $prompt;
2626
echo "\n\nAnthropic Claude:\n";
2727
echo $bedrockRuntimeService->invokeClaude($prompt);
28-
echo "\n\nAI21 Labs Jurassic-2:\n";
29-
echo $bedrockRuntimeService->invokeJurassic2($prompt);
3028
echo "\n---------------------------------------------------------------------\n";
3129
$image_prompt = 'stylized picture of a cute old steampunk robot';
3230
echo "\nImage prompt: " . $image_prompt;

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

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
<?php
2+
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3+
// SPDX-License-Identifier: Apache-2.0
4+
5+
namespace BedrockRuntime\Models\AmazonNova\Text;
6+
7+
require_once __DIR__ . '/../../../vendor/autoload.php';
8+
9+
// snippet-start:[php.example_code.bedrock-runtime.service.Converse_AmazonNovaText]
10+
// Use the Conversation API to send a text message to Amazon Nova.
11+
12+
use Aws\BedrockRuntime\BedrockRuntimeClient;
13+
use Aws\Exception\AwsException;
14+
use RuntimeException;
15+
16+
class Converse
17+
{
18+
public function converse(): string
19+
{
20+
// Create a Bedrock Runtime client in the AWS Region you want to use.
21+
$client = new BedrockRuntimeClient([
22+
'region' => 'us-east-1',
23+
'profile' => 'default'
24+
]);
25+
26+
// Set the model ID, e.g., Amazon Nova Lite.
27+
$modelId = 'amazon.nova-lite-v1:0';
28+
29+
// Start a conversation with the user message.
30+
$userMessage = "Describe the purpose of a 'hello world' program in one line.";
31+
$conversation = [
32+
[
33+
"role" => "user",
34+
"content" => [["text" => $userMessage]]
35+
]
36+
];
37+
38+
try {
39+
// Send the message to the model, using a basic inference configuration.
40+
$response = $client->converse([
41+
'modelId' => $modelId,
42+
'messages' => $conversation,
43+
'inferenceConfig' => [
44+
'maxTokens' => 512,
45+
'temperature' => 0.5
46+
]
47+
]);
48+
49+
// Extract and return the response text.
50+
$responseText = $response['output']['message']['content'][0]['text'];
51+
return $responseText;
52+
} catch (AwsException $e) {
53+
echo "ERROR: Can't invoke {$modelId}. Reason: {$e->getAwsErrorMessage()}";
54+
throw new RuntimeException("Failed to invoke model: " . $e->getAwsErrorMessage(), 0, $e);
55+
}
56+
}
57+
}
58+
59+
$demo = new Converse();
60+
echo $demo->converse();
61+
62+
// snippet-end:[php.example_code.bedrock-runtime.service.Converse_AmazonNovaText]

‎php/example_code/bedrock-runtime/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,21 +42,21 @@ functions within the same service.
4242

4343
- [Invoke multiple foundation models on Amazon Bedrock](GettingStartedWithBedrockRuntime.php)
4444

45-
### AI21 Labs Jurassic-2
45+
### Amazon Nova
4646

47-
- [InvokeModel](BedrockRuntimeService.php#L66)
47+
- [Converse](Models/AmazonNova/Text/Converse.php#L9)
4848

4949
### Amazon Titan Image Generator
5050

51-
- [InvokeModel](BedrockRuntimeService.php#L133)
51+
- [InvokeModel](BedrockRuntimeService.php#L103)
5252

5353
### Anthropic Claude
5454

5555
- [InvokeModel](BedrockRuntimeService.php#L31)
5656

5757
### Stable Diffusion
5858

59-
- [InvokeModel](BedrockRuntimeService.php#L96)
59+
- [InvokeModel](BedrockRuntimeService.php#L66)
6060

6161

6262
<!--custom.examples.start-->

‎php/example_code/bedrock-runtime/composer.json‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"require": {
3-
"aws/aws-sdk-php": "^3.336",
3+
"aws/aws-sdk-php": "^3.343",
44
"guzzlehttp/guzzle": "^7.9.2"
55
},
66
"autoload": {
@@ -11,5 +11,8 @@
1111
"BedrockRuntime\\": "../bedrock-runtime/",
1212
"AwsUtilities\\": "../aws_utilities/"
1313
}
14+
},
15+
"scripts": {
16+
"Models/AmazonNova/Text/Converse": "php Models/AmazonNova/Text/Converse.php"
1417
}
1518
}

0 commit comments

Comments
 (0)