Python: Support skill scripts execution (#4558)

* support skill scripts execution * fix mixed line endings * address comments and fix syntax issues * use few try/except instead of one * change samples * validate either script path or script resource is set not both * fix: separate LLM args from runtime kwargs in skill script execution * address pr review comments * address PR review comments * Update python/packages/core/agent_framework/_skills.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/packages/core/agent_framework/_skills.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/packages/core/agent_framework/_skills.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * 1. Fixing the caching bug where parameters_schema would re-inspect on every call when the result was None 2. Updating the arguments tool description to be more generic (not CLI-specific) * fix failing tests * address pr review comments * address pr review comments * allow resource function returning any instead of sting * address PR review comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-06-16 21:04:09 +08:00 · 2026-03-11 18:28:30 +00:00
parent 2f8fd5f82f
commit 23ebfbc937
27 changed files with 2994 additions and 528 deletions
@@ -0,0 +1,75 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""Sample subprocess-based skill script runner.
+
+Executes file-based skill scripts as local Python subprocesses.
+This is provided for demonstration purposes only.
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+
+from agent_framework import Skill, SkillScript
+
+
+def subprocess_script_runner(skill: Skill, script: SkillScript, args: dict[str, Any] | None = None) -> str:
+    """Run a skill script as a local Python subprocess.
+
+    Resolves the script's absolute path from the skill directory, converts
+    the ``args`` dict to CLI flags, and returns captured output.
+
+    Args:
+        skill: The skill that owns the script.
+        script: The script to run.
+        args: Optional arguments forwarded as CLI flags.
+
+    Returns:
+        The combined stdout/stderr output, or an error message.
+    """
+    if not skill.path:
+        return f"Error: Skill '{skill.name}' has no directory path."
+
+    if not script.path:
+        return f"Error: Script '{script.name}' has no file path. Only file-based scripts can be executed locally."
+
+    script_path = Path(skill.path) / script.path
+    if not script_path.is_file():
+        return f"Error: Script file not found: {script_path}"
+
+    cmd = [sys.executable, str(script_path)]
+
+    # Convert args dict to CLI flags
+    if args:
+        for key, value in args.items():
+            if isinstance(value, bool):
+                if value:
+                    cmd.append(f"--{key}")
+            elif value is not None:
+                cmd.append(f"--{key}")
+                cmd.append(str(value))
+
+    try:
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=30,
+            cwd=str(script_path.parent),
+        )
+
+        output = result.stdout
+        if result.stderr:
+            output += f"\nStderr:\n{result.stderr}"
+        if result.returncode != 0:
+            output += f"\nScript exited with code {result.returncode}"
+
+        return output.strip() or "(no output)"
+
+    except subprocess.TimeoutExpired:
+        return f"Error: Script '{script.name}' timed out after 30 seconds."
+    except OSError as e:
+        return f"Error: Failed to execute script '{script.name}': {e}"