Python: Fix OpenAPI concept sample (#12418)

### Motivation and Context

An OpenAPI concept sample that we have is broken. This PR fixes it to
run properly based on the current OpenAPI plugin handling.

<!-- 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.
-->

### Description

Fixes the broken OpenAPI sample.

<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->

### 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 😄

Author: moonbox3

python/samples/concepts/plugins/openapi/README.md

@@ -2,7 +2,7 @@
 
 For more generic setup instructions, including how to install the `uv` tool, see the [main README](../../../../DEV_SETUP.md).
 
-1. In a terminal, navigate to `semantic_kernel/python/samples/kernel-syntax-examples/openapi_example`.
+1. In a terminal, navigate to `semantic_kernel/python/samples/concepts/plugins/openapi`.
 
 2. Run `uv sync` followed by `source .venv/bin/activate` to enter the virtual environment (depending on the os, the activate script may be in a different location).
 

python/samples/concepts/plugins/openapi/openapi.yaml

@@ -32,7 +32,7 @@ paths:
             description: Your name
         - name: Header
           in: header
-          required: false
+          required: true
           schema:
             type: string
             description: The header

python/samples/concepts/plugins/openapi/openapi_client.py

@@ -1,27 +1,33 @@
 # Copyright (c) Microsoft. All rights reserved.
 
 import asyncio
+import os
 
-import semantic_kernel as sk
+from semantic_kernel import Kernel
 from semantic_kernel.functions.kernel_arguments import KernelArguments
 
 
 async def main():
-    """Client"""
-    kernel = sk.Kernel()
-
-    openapi_plugin = kernel.add_plugin_from_openapi(plugin_name="openApiPlugin", openapi_document_path="./openapi.yaml")
-
-    arguments = {
-        "request_body": '{"input": "hello world"}',
-        "path_params": '{"name": "mark"}',
-        "query_params": '{"q": "0.7"}',
-        "headers": '{"Content-Type": "application/json", "Header": "example"}',
-    }
-
-    kernel_arguments = KernelArguments(**arguments)
-
-    result = await kernel.invoke(openapi_plugin["helloWorld"], arguments=kernel_arguments)
+    """OpenAPI Sample Client"""
+    kernel = Kernel()
+
+    spec_path = os.path.join(
+        os.path.dirname(os.path.dirname(os.path.dirname(os.path.realpath(__file__)))),
+        "plugins",
+        "openapi",
+        "openapi.yaml",
+    )
+
+    openapi_plugin = kernel.add_plugin_from_openapi(plugin_name="openApiPlugin", openapi_document_path=spec_path)
+
+    arguments = KernelArguments(
+        input="hello world",
+        name="John",
+        q=0.7,
+        Header="example-header",
+    )
+
+    result = await kernel.invoke(openapi_plugin["helloWorld"], arguments=arguments)
 
     print(result)
 

python/samples/concepts/plugins/openapi/openapi_server.py

@@ -2,7 +2,7 @@
 
 from aiohttp import web
 
-"""Server"""
+"""OpenAPI Sample Server"""
 routes = web.RouteTableDef()