Address feedback: Add ChatPrompt, functions, MCP server/client, A2A server/client examples and docs links

Co-authored-by: heyitsaamir <[email protected]>

Author: Copilot

packages/a2aprotocol/README.md

@@ -24,19 +24,44 @@ uv add microsoft-teams-a2a
 
 ## Usage
 
+### A2A Server (Expose Agent)
+
 ```python
 from microsoft.teams.apps import App
 from microsoft.teams.a2a import A2APlugin, A2APluginOptions
 from a2a.types import AgentCard
 
 app = App()
 
+# Expose your Teams agent via A2A protocol
 agent_card = AgentCard(
     name="My Agent",
     description="A helpful agent",
     capabilities={}
 )
 
-a2a_plugin = A2APlugin(A2APluginOptions(agent_card=agent_card))
-app.use(a2a_plugin)
+a2a_server = A2APlugin(A2APluginOptions(agent_card=agent_card))
+app.use(a2a_server)
+```
+
+### A2A Client (Use Other Agents)
+
+```python
+from microsoft.teams.a2a import A2AClientPlugin, A2APluginUseParams
+from microsoft.teams.ai import ChatPrompt
+from microsoft.teams.openai import OpenAICompletionsAIModel
+
+model = OpenAICompletionsAIModel(api_key="your-api-key", model="gpt-4")
+
+# Connect to another A2A agent
+a2a_client = A2AClientPlugin()
+a2a_client.on_use_plugin(
+    A2APluginUseParams(
+        key="weather-agent",
+        base_url="http://localhost:4000/a2a",
+        card_url=".well-known/agent-card.json"
+    )
+)
+
+prompt = ChatPrompt(model, plugins=[a2a_client])
 ```

packages/ai/README.md

@@ -12,9 +12,7 @@
 AI-powered conversational experiences for Microsoft Teams applications.
 Provides prompt management, action planning, and model integration for building intelligent Teams bots.
 
-<a href="https://microsoft.github.io/teams-ai" target="_blank">
-    <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
-</a>
+[📖 Documentation](https://microsoft.github.io/teams-ai/python/in-depth-guides/ai/)
 
 ## Installation
 
@@ -24,15 +22,39 @@ uv add microsoft-teams-ai
 
 ## Usage
 
+### ChatPrompt
+
 ```python
-from microsoft.teams.ai import Agent
+from microsoft.teams.ai import ChatPrompt, Function
 from microsoft.teams.openai import OpenAICompletionsAIModel
+from pydantic import BaseModel
 
 model = OpenAICompletionsAIModel(api_key="your-api-key", model="gpt-4")
-agent = Agent(model=model)
 
-result = await agent.send(
+# Create a ChatPrompt
+prompt = ChatPrompt(model)
+
+result = await prompt.send(
     input="Hello!",
     instructions="You are a helpful assistant."
 )
+```
+
+### Function Calling
+
+```python
+class GetWeatherParams(BaseModel):
+    location: str
+
+async def get_weather(params: GetWeatherParams) -> str:
+    return f"The weather in {params.location} is sunny"
+
+weather_function = Function(
+    name="get_weather",
+    description="Get weather for a location",
+    parameter_schema=GetWeatherParams,
+    handler=get_weather
+)
+
+prompt = ChatPrompt(model, functions=[weather_function])
 ```

packages/devtools/README.md

@@ -14,9 +14,7 @@
 
 Developer tools for locally testing and debugging Teams applications. Streamlines the development process by eliminating the need to deploy apps or expose public endpoints during development.
 
-<a href="https://microsoft.github.io/teams-ai" target="_blank">
-    <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
-</a>
+[📖 Documentation](https://microsoft.github.io/teams-ai/developer-tools/devtools/)
 
 ## Installation
 

packages/mcpplugin/README.md

@@ -10,11 +10,9 @@
 </p>
 
 Model Context Protocol (MCP) integration for Microsoft Teams AI applications.
-Enables Teams bots to use MCP servers as tools and resources.
+Enables Teams bots to both expose tools as MCP servers and use MCP servers as clients.
 
-<a href="https://microsoft.github.io/teams-ai" target="_blank">
-    <img src="https://img.shields.io/badge/📖 Getting Started-blue?style=for-the-badge" />
-</a>
+[📖 Documentation](https://microsoft.github.io/teams-ai/python/in-depth-guides/ai/mcp/)
 
 ## Installation
 
@@ -24,16 +22,40 @@ uv add microsoft-teams-mcpplugin
 
 ## Usage
 
+### MCP Client (Use MCP Servers)
+
 ```python
 from microsoft.teams.apps import App
 from microsoft.teams.mcpplugin import McpClientPlugin
 
 app = App()
 
-mcp_plugin = McpClientPlugin(
+# Connect to an MCP server
+mcp_client = McpClientPlugin(
     server_command="uvx",
     server_args=["mcp-server-time"]
 )
 
-app.use(mcp_plugin)
+app.use(mcp_client)
+```
+
+### MCP Server (Expose Tools)
+
+```python
+from microsoft.teams.apps import App
+from microsoft.teams.mcpplugin import McpServerPlugin
+from microsoft.teams.ai import Function
+from pydantic import BaseModel
+
+app = App()
+
+class EchoParams(BaseModel):
+    message: str
+
+async def echo_handler(params: EchoParams) -> str:
+    return f"Echo: {params.message}"
+
+# Expose app as MCP server
+mcp_server = McpServerPlugin(name="my-mcp-server")
+app.use(mcp_server)
 ```