Swift: code examples for Anthropic Claude to use Converse and ConverseStream, Amazon Bedrock (#7433)

* Converse and ConverseStream code examples added

* Regenerate documentation

Author: monadierickx

.doc_gen/metadata/bedrock-runtime_metadata.yaml

@@ -327,6 +327,14 @@ bedrock-runtime_Converse_AnthropicClaude:
             - description: Use statements, Error utility, and constants.
               snippet_tags:
                 - rust.bedrock-runtime.Converse_AnthropicClaude.supporting
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Anthropic Claude, using Bedrock's Converse API.
+              snippet_tags:
+                - swift.example_code.bedrock-runtime.Converse_AnthropicClaude
   services:
     bedrock-runtime: {Converse}
 
@@ -610,6 +618,14 @@ bedrock-runtime_ConverseStream_AnthropicClaude:
             - description: Use statements, Error utility, and constants.
               snippet_tags:
                 - rust.bedrock-runtime.ConverseStream_AnthropicClaude.supporting
+    Swift:
+      versions:
+        - sdk_version: 1
+          github: swift/example_code/bedrock-runtime
+          excerpts:
+            - description: Send a text message to Anthropic Claude, using Bedrock's Converse API and process the response stream in real-time.
+              snippet_tags:
+                - swift.example_code.bedrock-runtime.ConverseStream_AnthropicClaude
   services:
     bedrock-runtime: {ConverseStream}
 

swift/example_code/bedrock-runtime/README.md

@@ -33,6 +33,11 @@ For prerequisites, see the [README](../../README.md#Prerequisites) in the `swift
 - [Converse](models/amazon-nova/amazon-nova-text/Sources/Converse/main.swift#L4)
 - [ConverseStream](models/amazon-nova/amazon-nova-text/Sources/ConverseStream/main.swift#L4)
 
+### Anthropic Claude
+
+- [Converse](models/anthropic_claude/Sources/Converse/main.swift#L4)
+- [ConverseStream](models/anthropic_claude/Sources/ConverseStream/main.swift#L4)
+
 
 <!--custom.examples.start-->
 <!--custom.examples.end-->

swift/example_code/bedrock-runtime/models/anthropic_claude/Package.swift

@@ -0,0 +1,38 @@
+// swift-tools-version: 6.1
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+// 
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "AnthropicClaudeText",
+    // Let Xcode know the minimum Apple platforms supported.
+    platforms: [
+        .macOS(.v13),
+        .iOS(.v15)
+    ],
+    dependencies: [
+        // Dependencies declare other packages that this package depends on.
+        .package(url: "https://github.com/awslabs/aws-sdk-swift", from: "1.2.61")
+    ],
+    targets: [
+        // Targets are the basic building blocks of a package, defining a module or a test suite.
+        // Targets can depend on other targets in this package and products from dependencies.
+        .executableTarget(
+            name: "Converse",
+            dependencies: [
+                .product(name: "AWSBedrockRuntime", package: "aws-sdk-swift"),
+            ],
+            path: "Sources/Converse"
+        ),
+        .executableTarget(
+            name: "ConverseStream",
+            dependencies: [
+                .product(name: "AWSBedrockRuntime", package: "aws-sdk-swift"),
+            ],
+            path: "Sources/ConverseStream"
+        )
+    ]
+)

swift/example_code/bedrock-runtime/models/anthropic_claude/Sources/Converse/main.swift

@@ -0,0 +1,65 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+//
+// snippet-start:[swift.example_code.bedrock-runtime.Converse_AnthropicClaude]
+// An example demonstrating how to use the Conversation API to send 
+// a text message to Anthropic Claude.
+
+import AWSBedrockRuntime
+
+func converse(_ textPrompt: String) async throws -> String {
+
+    // Create a Bedrock Runtime client in the AWS Region you want to use.
+    let config =
+        try await BedrockRuntimeClient.BedrockRuntimeClientConfiguration(
+            region: "us-east-1"
+        )
+    let client = BedrockRuntimeClient(config: config)
+
+    // Set the model ID.
+    let modelId = "anthropic.claude-3-haiku-20240307-v1:0"
+
+    // Start a conversation with the user message.
+    let message = BedrockRuntimeClientTypes.Message(
+        content: [.text(textPrompt)],
+        role: .user
+    )
+
+    // Optionally use inference parameters
+    let inferenceConfig =
+        BedrockRuntimeClientTypes.InferenceConfiguration(
+            maxTokens: 512,
+            stopSequences: ["END"],
+            temperature: 0.5,
+            topp: 0.9
+        )
+
+    // Create the ConverseInput to send to the model
+    let input = ConverseInput(
+        inferenceConfig: inferenceConfig, messages: [message], modelId: modelId)
+
+    // Send the ConverseInput to the model
+    let response = try await client.converse(input: input)
+
+    // Extract and return the response text.
+    if case let .message(msg) = response.output {
+        if case let .text(textResponse) = msg.content![0] {
+            return textResponse
+        } else {
+            return "No text response found in message content"
+        }
+    } else {
+        return "No message found in converse output"
+    }
+}
+
+// snippet-end:[swift.example_code.bedrock-runtime.Converse_AnthropicClaude]
+
+do {
+    let reply = try await converse(
+        "Describe the purpose of a 'hello world' program in one line."
+    )
+    print(reply)
+} catch {
+    print("An error occurred: \(error)")
+}

swift/example_code/bedrock-runtime/models/anthropic_claude/Sources/ConverseStream/main.swift

@@ -0,0 +1,75 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+//
+// snippet-start:[swift.example_code.bedrock-runtime.ConverseStream_AnthropicClaude]
+// An example demonstrating how to use the Conversation API to send a text message
+// to Anthropic Claude and print the response stream
+
+import AWSBedrockRuntime
+
+func printConverseStream(_ textPrompt: String) async throws {
+
+    // Create a Bedrock Runtime client in the AWS Region you want to use.
+    let config =
+        try await BedrockRuntimeClient.BedrockRuntimeClientConfiguration(
+            region: "us-east-1"
+        )
+    let client = BedrockRuntimeClient(config: config)
+
+    // Set the model ID.
+    let modelId = "anthropic.claude-3-haiku-20240307-v1:0"
+
+    // Start a conversation with the user message.
+    let message = BedrockRuntimeClientTypes.Message(
+        content: [.text(textPrompt)],
+        role: .user
+    )
+
+    // Optionally use inference parameters.
+    let inferenceConfig =
+        BedrockRuntimeClientTypes.InferenceConfiguration(
+            maxTokens: 512,
+            stopSequences: ["END"],
+            temperature: 0.5,
+            topp: 0.9
+        )
+
+    // Create the ConverseStreamInput to send to the model.
+    let input = ConverseStreamInput(
+        inferenceConfig: inferenceConfig, messages: [message], modelId: modelId)
+
+    // Send the ConverseStreamInput to the model.
+    let response = try await client.converseStream(input: input)
+
+    // Extract the streaming response.
+    guard let stream = response.stream else {
+        print("No stream available")
+        return
+    }
+
+    // Extract and print the streamed response text in real-time.
+    for try await event in stream {
+        switch event {
+        case .messagestart(_):
+            print("\nAnthropic Claude:")
+
+        case .contentblockdelta(let deltaEvent):
+            if case .text(let text) = deltaEvent.delta {
+                print(text, terminator: "")
+            }
+
+        default:
+            break
+        }
+    }
+}
+
+// snippet-end:[swift.example_code.bedrock-runtime.ConverseStream_AnthropicClaude]
+
+do {
+    try await printConverseStream(
+        "Describe the purpose of a 'hello world' program in two paragraphs."
+    )
+} catch {
+    print("An error occurred: \(error)")
+}