Go: Add Bedrock Runtime Converse example for Amazon Nova (#7877)

Author: haidargit

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -91,6 +91,14 @@ bedrock-runtime_Converse_AmazonNovaText:
             - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
               snippet_tags:
                 - python.example_code.bedrock-runtime.Converse_AmazonNovaText
+    Go:
+      versions:
+        - sdk_version: 2
+          github: gov2/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Amazon Nova, using Bedrock's Converse API.
+              snippet_tags:
+                - gov2.bedrock-runtime.ConverseNova
     Swift:
       versions:
         - sdk_version: 1

.github/workflows/lint-golang.yml

@@ -21,13 +21,13 @@ jobs:
         uses: tj-actions/changed-files@e9772d140489982e0e3704fea5ee93d536f1e275
         with:
           files: "gov2/**/*.go"
-      - uses: actions/setup-go@v3
+      - uses: actions/setup-go@v5
         if: steps.changed-files.outputs.any_changed == 'true'
         with:
-          go-version: 1.21
+          go-version: 1.24
       - name: install golangci-lint
         if: steps.changed-files.outputs.any_changed == 'true'
-        run: curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.61.0
+        run: curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.64.8
       - name: run golangci-lint
         if: steps.changed-files.outputs.any_changed == 'true'
         run: |  # If you get a linting error of "File is not `goimports`-ed", the solution is to run "gofmt -w ./<folder>".

.tools/readmes/requirements_freeze.txt

@@ -1,5 +1,5 @@
 aws_doc_sdk_examples_tools @ git+https://github.com/awsdocs/aws-doc-sdk-examples-tools@2025.41.0
-black==26.3.1
+black==25.11.0
 certifi==2025.1.31
 charset-normalizer==3.4.1
 click==8.1.8
@@ -20,9 +20,9 @@ pluggy==1.5.0
 pycodestyle==2.11.1
 pyflakes==3.1.0
 Pygments==2.19.1
-pytest==9.0.3
+pytest==8.4.2
 PyYAML==6.0.1
-requests==2.33.0
+requests==2.32.5
 rich==13.9.4
 shellingham==1.5.4
 typer==0.15.1

gov2/bedrock-runtime/README.md

@@ -40,6 +40,10 @@ functions within the same service.
 
 - [Invoke multiple foundation models on Amazon Bedrock](scenarios/scenario_invoke_models.go)
 
+### Amazon Nova
+
+- [Converse](actions/converse.go#L53)
+
 ### Amazon Titan Image Generator
 
 - [InvokeModel](actions/invoke_model.go#L7)

gov2/bedrock-runtime/actions/converse.go

@@ -49,4 +49,32 @@ func (wrapper ConverseWrapper) ConverseClaude(ctx context.Context, prompt string
 }
 
 // snippet-end:[gov2.bedrock-runtime.ConverseClaude]
+
+// snippet-start:[gov2.bedrock-runtime.ConverseNova]
+
+func (wrapper ConverseWrapper) ConverseNova(ctx context.Context, prompt string) (string, error) {
+	var content = types.ContentBlockMemberText{
+		Value: prompt,
+	}
+	var message = types.Message{
+		Content: []types.ContentBlock{&content},
+		Role:    "user",
+	}
+	modelId := "amazon.nova-lite-v1:0"
+	var converseInput = bedrockruntime.ConverseInput{
+		ModelId:  aws.String(modelId),
+		Messages: []types.Message{message},
+	}
+	response, err := wrapper.BedrockRuntimeClient.Converse(ctx, &converseInput)
+	if err != nil {
+		ProcessError(err, modelId)
+	}
+
+	responseText, _ := response.Output.(*types.ConverseOutputMemberMessage)
+	responseContentBlock := responseText.Value.Content[0]
+	text, _ := responseContentBlock.(*types.ContentBlockMemberText)
+	return text.Value, nil
+}
+
+// snippet-end:[gov2.bedrock-runtime.ConverseNova]
 // snippet-end:[gov2.bedrock-runtime.Converse.complete]

gov2/bedrock-runtime/actions/converse_test.go

@@ -17,6 +17,7 @@ import (
 )
 
 const CONVERSE_CLAUDE_MODEL_ID = "anthropic.claude-3-haiku-20240307-v1:0"
+const CONVERSE_NOVA_MODEL_ID = "amazon.nova-lite-v1:0"
 const CONVERSE_PROMPT = "Converse test prompt"
 
 func CallConverseActions(sdkConfig aws.Config) {
@@ -36,6 +37,12 @@ func CallConverseActions(sdkConfig aws.Config) {
 	}
 	log.Println(claudeCompletion)
 
+	novaCompletion, err := wrapper.ConverseNova(ctx, CONVERSE_PROMPT)
+	if err != nil {
+		panic(err)
+	}
+	log.Println(novaCompletion)
+
 	log.Printf("Thanks for watching!")
 }
 
@@ -71,6 +78,7 @@ func stubConverse(modelId string) testtools.Stub {
 func (scenTest *ConverseActionsTest) SetupDataAndStubs() []testtools.Stub {
 	var stubList []testtools.Stub
 	stubList = append(stubList, stubConverse(CONVERSE_CLAUDE_MODEL_ID))
+	stubList = append(stubList, stubConverse(CONVERSE_NOVA_MODEL_ID))
 
 	return stubList
 }

gov2/bedrock-runtime/scenarios/scenario_converse.go

@@ -17,7 +17,7 @@ import (
 )
 
 // ConverseScenario demonstrates how to use the Amazon Bedrock Runtime client
-// to Converse with Anthropic Claude
+// to Converse with Anthropic Claude, Amazon Nova
 type ConverseScenario struct {
 	sdkConfig       aws.Config
 	questioner      demotools.IQuestioner
@@ -56,6 +56,10 @@ func (scenario ConverseScenario) Run(ctx context.Context) {
 	log.Printf("Invoking Claude with prompt: %v\n", text2textPrompt)
 	scenario.ConverseClaude(ctx, text2textPrompt)
 
+	log.Println(strings.Repeat("-", 77))
+	log.Printf("Invoking Amazon Nova with prompt: %v\n", text2textPrompt)
+	scenario.ConverseNova(ctx, text2textPrompt)
+
 	log.Println(strings.Repeat("=", 77))
 	log.Println("Thanks for watching!")
 	log.Println(strings.Repeat("=", 77))
@@ -69,4 +73,12 @@ func (scenario ConverseScenario) ConverseClaude(ctx context.Context, prompt stri
 	log.Printf("\nClaude     : %v\n", strings.TrimSpace(completion))
 }
 
+func (scenario ConverseScenario) ConverseNova(ctx context.Context, prompt string) {
+	completion, err := scenario.converseWrapper.ConverseNova(ctx, prompt)
+	if err != nil {
+		panic(err)
+	}
+	log.Printf("\nAmazon Nova: %v\n", strings.TrimSpace(completion))
+}
+
 // snippet-end:[gov2.bedrock-runtime.Scenario_Converse]

gov2/s3/README.md

@@ -188,4 +188,4 @@ in the `gov2` folder.
 
 Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 
-SPDX-License-Identifier: Apache-2.0
+SPDX-License-Identifier: Apache-2.0