Add Bedrock agent retrieval samples in Python and .Net (microsoft#10857)

### Motivation and Context

<!-- Thank you for your contribution to the semantic-kernel repo!
Please help reviewers and future users, providing the following
information:
  1. Why is this change required?
  2. What problem does it solve?
  3. What scenario does it contribute to?
  4. If it fixes an open issue, please link to the issue here.
-->
We are missing samples for how to retrieve an existing Bedrock agent in
Python and .Net.

### Description

<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->
1. Add two samples on how to retrieve existing Bedrock agents, one for
Python, one for .Net.
2. Modify Python sample comments to follow our latest sample guide.

### Contribution Checklist

<!-- Before submitting this PR, please make sure: -->

- [x] The code builds clean without any errors or warnings
- [x] The PR follows the [SK Contribution
Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
and the [pre-submission formatting
script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts)
raises no violations
- [x] All unit tests pass, and I have added new tests where possible
- [x] I didn't break anyone 😄

Co-authored-by: Evan Mattson <[email protected]>

Author: TaoChenOSU

dotnet/samples/GettingStartedWithAgents/BedrockAgent/Step01_BedrockAgent.cs

@@ -37,6 +37,27 @@ public async Task UseNewAgentAsync()
         }
     }
 
+    /// <summary>
+    /// Demonstrates how to use an existing <see cref="BedrockAgent"/> and interact with it.
+    /// The agent will respond to the user query.
+    /// </summary>
+    [Fact]
+    public async Task UseExistingAgentAsync()
+    {
+        // Retrieve the agent
+        // Replace "bedrock-agent-id" with the ID of the agent you want to use
+        var agentId = "bedrock-agent-id";
+        var getAgentResponse = await this.Client.GetAgentAsync(new() { AgentId = agentId });
+        var bedrockAgent = new BedrockAgent(getAgentResponse.Agent, this.Client);
+
+        // Respond to user input
+        var responses = bedrockAgent.InvokeAsync(BedrockAgent.CreateSessionId(), UserQuery, null);
+        await foreach (var response in responses)
+        {
+            this.Output.WriteLine(response.Content);
+        }
+    }
+
     /// <summary>
     /// Demonstrates how to create a new <see cref="BedrockAgent"/> and interact with it using streaming.
     /// The agent will respond to the user query.

python/samples/concepts/agents/bedrock_agent/bedrock_agent_retrieval.py

@@ -0,0 +1,58 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import asyncio
+
+import boto3
+
+from semantic_kernel.agents.bedrock.bedrock_agent import BedrockAgent
+
+"""
+The following sample demonstrates how to use an already existing
+Bedrock Agent within Semantic Kernel. This sample requires that you
+have an existing agent created either previously in code or via the
+AWS Console.
+This sample uses the following main component(s):
+- a Bedrock agent
+You will learn how to retrieve a Bedrock agent and talk to it.
+"""
+
+# Replace "your-agent-id" with the ID of the agent you want to use
+AGENT_ID = "your-agent-id"
+
+
+async def main():
+    client = boto3.client("bedrock-agent")
+    agent_model = client.get_agent(agentId=AGENT_ID)["agent"]
+    bedrock_agent = BedrockAgent(agent_model)
+    session_id = BedrockAgent.create_session_id()
+
+    try:
+        while True:
+            user_input = input("User:> ")
+            if user_input == "exit":
+                print("\n\nExiting chat...")
+                break
+
+            # Invoke the agent
+            # The chat history is maintained in the session
+            async for response in bedrock_agent.invoke(
+                session_id=session_id,
+                input_text=user_input,
+            ):
+                print(f"Bedrock agent: {response}")
+    except KeyboardInterrupt:
+        print("\n\nExiting chat...")
+        return False
+    except EOFError:
+        print("\n\nExiting chat...")
+        return False
+
+    # Sample output (using anthropic.claude-3-haiku-20240307-v1:0):
+    # User:> Hi, my name is John.
+    # Bedrock agent: Hello John. How can I help you?
+    # User:> What is my name?
+    # Bedrock agent: Your name is John.
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

python/samples/concepts/agents/bedrock_agent/bedrock_agent_simple_chat.py

@@ -4,10 +4,12 @@
 
 from semantic_kernel.agents.bedrock.bedrock_agent import BedrockAgent
 
-# This sample shows how to interact with a Bedrock agent in the simplest way.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# You will learn how to create a new Bedrock agent and talk to it.
+"""
+This sample shows how to interact with a Bedrock agent in the simplest way.
+This sample uses the following main component(s):
+- a Bedrock agent
+You will learn how to create a new Bedrock agent and talk to it.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_agent_simple_chat_streaming.py

@@ -4,10 +4,12 @@
 
 from semantic_kernel.agents.bedrock.bedrock_agent import BedrockAgent
 
-# This sample shows how to interact with a Bedrock agent via streaming in the simplest way.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# You will learn how to create a new Bedrock agent and talk to it.
+"""
+This sample shows how to interact with a Bedrock agent via streaming in the simplest way.
+This sample uses the following main component(s):
+- a Bedrock agent
+You will learn how to create a new Bedrock agent and talk to it.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_agent_with_code_interpreter.py

@@ -7,12 +7,14 @@
 from semantic_kernel.contents.binary_content import BinaryContent
 from semantic_kernel.contents.chat_message_content import ChatMessageContent
 
-# This sample shows how to interact with a Bedrock agent that is capable of writing and executing code.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# You will learn how to create a new Bedrock agent and ask it a question that requires coding to answer.
-# After running this sample, a bar chart will be generated and saved to a file in the same directory
-# as this script.
+"""
+This sample shows how to interact with a Bedrock agent that is capable of writing and executing code.
+This sample uses the following main component(s):
+- a Bedrock agent
+You will learn how to create a new Bedrock agent and ask it a question that requires coding to answer.
+After running this sample, a bar chart will be generated and saved to a file in the same directory
+as this script.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_agent_with_code_interpreter_streaming.py

@@ -7,12 +7,14 @@
 from semantic_kernel.contents.binary_content import BinaryContent
 from semantic_kernel.contents.streaming_chat_message_content import StreamingChatMessageContent
 
-# This sample shows how to interact with a Bedrock agent that is capable of writing and executing code.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# You will learn how to create a new Bedrock agent and ask it a question that requires coding to answer.
-# After running this sample, a bar chart will be generated and saved to a file in the same directory
-# as this script.
+"""
+This sample shows how to interact with a Bedrock agent that is capable of writing and executing code.
+This sample uses the following main component(s):
+- a Bedrock agent
+You will learn how to create a new Bedrock agent and ask it a question that requires coding to answer.
+After running this sample, a bar chart will be generated and saved to a file in the same directory
+as this script.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_agent_with_kernel_function.py

@@ -7,12 +7,14 @@
 from semantic_kernel.functions.kernel_function_decorator import kernel_function
 from semantic_kernel.kernel import Kernel
 
-# This sample shows how to interact with a Bedrock agent that is capable of using kernel functions.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# - a kernel function
-# - a kernel
-# You will learn how to create a new Bedrock agent and ask it a question that requires a kernel function to answer.
+"""
+This sample shows how to interact with a Bedrock agent that is capable of using kernel functions.
+This sample uses the following main component(s):
+- a Bedrock agent
+- a kernel function
+- a kernel
+You will learn how to create a new Bedrock agent and ask it a question that requires a kernel function to answer.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_agent_with_kernel_function_simple.py

@@ -6,14 +6,16 @@
 from semantic_kernel.agents.bedrock.bedrock_agent import BedrockAgent
 from semantic_kernel.functions.kernel_function_decorator import kernel_function
 
-# This sample shows how to interact with a Bedrock agent that is capable of using kernel functions.
-# Instead of creating a kernel and adding plugins to it, you can directly pass the plugins to the
-# agent when creating it.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# - a kernel function
-# - a kernel
-# You will learn how to create a new Bedrock agent and ask it a question that requires a kernel function to answer.
+"""
+This sample shows how to interact with a Bedrock agent that is capable of using kernel functions.
+Instead of creating a kernel and adding plugins to it, you can directly pass the plugins to the
+agent when creating it.
+This sample uses the following main component(s):
+- a Bedrock agent
+- a kernel function
+- a kernel
+You will learn how to create a new Bedrock agent and ask it a question that requires a kernel function to answer.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_agent_with_kernel_function_streaming.py

@@ -7,12 +7,14 @@
 from semantic_kernel.functions.kernel_function_decorator import kernel_function
 from semantic_kernel.kernel import Kernel
 
-# This sample shows how to interact with a Bedrock agent that is capable of using kernel functions.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# - a kernel function
-# - a kernel
-# You will learn how to create a new Bedrock agent and ask it a question that requires a kernel function to answer.
+"""
+This sample shows how to interact with a Bedrock agent that is capable of using kernel functions.
+This sample uses the following main component(s):
+- a Bedrock agent
+- a kernel function
+- a kernel
+You will learn how to create a new Bedrock agent and ask it a question that requires a kernel function to answer.
+"""
 
 AGENT_NAME = "semantic-kernel-bedrock-agent"
 INSTRUCTION = "You are a friendly assistant. You help people find information."

python/samples/concepts/agents/bedrock_agent/bedrock_mixed_chat_agents.py

@@ -10,13 +10,15 @@
 from semantic_kernel.contents.utils.author_role import AuthorRole
 from semantic_kernel.kernel import Kernel
 
-# This sample shows how to use a bedrock agent in a group chat that includes multiple agents of different roles.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# - a ChatCompletionAgent
-# - an AgentGroupChat
-# You will learn how to create a new or connect to an existing Bedrock agent and put it in a group chat with
-# another agent.
+"""
+This sample shows how to use a bedrock agent in a group chat that includes multiple agents of different roles.
+This sample uses the following main component(s):
+- a Bedrock agent
+- a ChatCompletionAgent
+- an AgentGroupChat
+You will learn how to create a new or connect to an existing Bedrock agent and put it in a group chat with
+another agent.
+"""
 
 # This will be a chat completion agent
 REVIEWER_NAME = "ArtDirector"

python/samples/concepts/agents/bedrock_agent/bedrock_mixed_chat_agents_streaming.py

@@ -10,13 +10,15 @@
 from semantic_kernel.contents.utils.author_role import AuthorRole
 from semantic_kernel.kernel import Kernel
 
-# This sample shows how to use a bedrock agent in a group chat that includes multiple agents of different roles.
-# This sample uses the following main component(s):
-# - a Bedrock agent
-# - a ChatCompletionAgent
-# - an AgentGroupChat
-# You will learn how to create a new or connect to an existing Bedrock agent and put it in a group chat with
-# another agent.
+"""
+This sample shows how to use a bedrock agent in a group chat that includes multiple agents of different roles.
+This sample uses the following main component(s):
+- a Bedrock agent
+- a ChatCompletionAgent
+- an AgentGroupChat
+You will learn how to create a new or connect to an existing Bedrock agent and put it in a group chat with
+another agent.
+"""
 
 # This will be a chat completion agent
 REVIEWER_NAME = "ArtDirector"