Python: Update hosted agent samples with agent manifests (#2240)

* Add agent manifests

* Correct agent manifest

* Correct agent manifest 2

* use resource substitution

* address comments

Author: TaoChenOSU

python/samples/demos/hosted_agents/agent_with_hosted_mcp/.env.example

@@ -0,0 +1,30 @@
+# Unique identifier/name for this agent
+name: agent-with-hosted-mcp
+# Brief description of what this agent does
+description: >
+  An AI agent that uses Azure OpenAI with a Hosted Model Context Protocol (MCP) server.
+  The agent answers questions by searching Microsoft Learn documentation using MCP tools.
+metadata:
+  # Categorization tags for organizing and discovering agents
+  authors:
+    - Microsoft Agent Framework Team
+  tags:
+    - Azure AI AgentServer
+    - Microsoft Agent Framework
+    - Model Context Protocol
+    - MCP
+template:
+  name: agent-with-hosted-mcp
+  # The type of agent - "hosted" for HOBO, "container" for COBO
+  kind: hosted
+  protocols:
+    - protocol: responses
+  environment_variables:
+    - name: AZURE_OPENAI_ENDPOINT
+      value: ${AZURE_OPENAI_ENDPOINT}
+    - name: AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
+      value: "{{chat}}"
+resources:
+  - kind: model
+    id: gpt-4o-mini
+    name: chat

python/samples/demos/hosted_agents/agent_with_hosted_mcp/README.md

@@ -1,14 +1,14 @@
 # Copyright (c) Microsoft. All rights reserved.
 
-
 from agent_framework import HostedMCPTool
-from agent_framework.openai import OpenAIChatClient
+from agent_framework.azure import AzureOpenAIChatClient
 from azure.ai.agentserver.agentframework import from_agent_framework  # pyright: ignore[reportUnknownVariableType]
+from azure.identity import DefaultAzureCredential
 
 
 def main():
-    # Create an Agent using the OpenAI Chat Client with a MCP Tool that connects to Microsoft Learn MCP
-    agent = OpenAIChatClient().create_agent(
+    # Create an Agent using the Azure OpenAI Chat Client with a MCP Tool that connects to Microsoft Learn MCP
+    agent = AzureOpenAIChatClient(credential=DefaultAzureCredential()).create_agent(
         name="DocsAgent",
         instructions="You are a helpful assistant that can help with microsoft documentation questions.",
         tools=HostedMCPTool(

python/samples/demos/hosted_agents/agent_with_hosted_mcp/agent.yaml

@@ -0,0 +1,33 @@
+# Unique identifier/name for this agent
+name: agent-with-text-search-rag
+# Brief description of what this agent does
+description: >
+  An AI agent that uses a ContextProvider for retrieval augmented generation (RAG) capabilities.
+  The agent runs searches against an external knowledge base before each model invocation and
+  injects the results into the model context. It can answer questions about Contoso Outdoors
+  policies and products, including return policies, refunds, shipping options, and product care
+  instructions such as tent maintenance.
+metadata:
+  # Categorization tags for organizing and discovering agents
+  authors:
+    - Microsoft Agent Framework Team
+  tags:
+    - Azure AI AgentServer
+    - Microsoft Agent Framework
+    - Retrieval-Augmented Generation
+    - RAG
+template:
+  name: agent-with-text-search-rag
+  # The type of agent - "hosted" for HOBO, "container" for COBO
+  kind: hosted
+  protocols:
+    - protocol: responses
+  environment_variables:
+    - name: AZURE_OPENAI_ENDPOINT
+      value: ${AZURE_OPENAI_ENDPOINT}
+    - name: AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
+      value: "{{chat}}"
+resources:
+  - kind: model
+    id: gpt-4o-mini
+    name: chat

python/samples/demos/hosted_agents/agent_with_hosted_mcp/main.py

@@ -7,8 +7,9 @@
 from typing import Any
 
 from agent_framework import ChatMessage, Context, ContextProvider, Role
-from agent_framework.openai import OpenAIChatClient
+from agent_framework.azure import AzureOpenAIChatClient
 from azure.ai.agentserver.agentframework import from_agent_framework  # pyright: ignore[reportUnknownVariableType]
+from azure.identity import DefaultAzureCredential
 
 if sys.version_info >= (3, 12):
     from typing import override
@@ -91,8 +92,8 @@ async def invoking(self, messages: ChatMessage | MutableSequence[ChatMessage], *
 
 
 def main():
-    # Create an Agent using the OpenAI Chat Client
-    agent = OpenAIChatClient().create_agent(
+    # Create an Agent using the Azure OpenAI Chat Client
+    agent = AzureOpenAIChatClient(credential=DefaultAzureCredential()).create_agent(
         name="SupportSpecialist",
         instructions=(
             "You are a helpful support specialist for Contoso Outdoors. "