Python: Introducing support for declarative yaml spec (#2002)

* first work on declarative

* initial version of the declarative support

* fix tests and mypy

* fix parameters of functiontool

* slight logic improvement

* remove path until merge

* updates from comments

* create dispatcher and spec type, json_schema method

* fix mypy, skipping model

* updated lock

* fixed declarative tests and renamed some other test files

* refined loader

* updated lock

* fix mypy

* added readme to samples folder

* fixes from review

* undid test file rename

python/samples/getting_started/declarative/microsoft_learn_agent.py

@@ -0,0 +1,25 @@
+# Copyright (c) Microsoft. All rights reserved.
+import asyncio
+from pathlib import Path
+
+from agent_framework.declarative import AgentFactory
+from azure.identity.aio import AzureCliCredential
+
+
+async def main():
+    """Create an agent from a declarative yaml specification and run it."""
+    # get the path
+    current_path = Path(__file__).parent
+    yaml_path = current_path.parent.parent.parent.parent / "agent-samples" / "foundry" / "MicrosoftLearnAgent.yaml"
+
+    # create the agent from the yaml
+    async with (
+        AzureCliCredential() as credential,
+        AgentFactory(client_kwargs={"async_credential": credential}).create_agent_from_yaml_path(yaml_path) as agent,
+    ):
+        response = await agent.run("How do I create a storage account with private endpoint using bicep?")
+        print("Agent response:", response.text)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())