Files
agent-framework/python/samples/02-agents/skills/script_approval/README.md
Eduard van Valkenburg 6acab3d1d6 Python: [BREAKING] Standardize model selection on model (#4999)
* Refactor Anthropic model option and provider clients

Rename the Anthropic client model option from model_id to model, add provider-specific Anthropic wrappers for Foundry, Bedrock, and Vertex, and expose them through the Anthropic, Foundry, Amazon, and Google namespaces. Update core option handling, docs, samples, and tests accordingly.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix Anthropic skills sample typing

Cast the Anthropic beta client to Any in the skills sample so the pre-commit sample pyright check no longer fails on beta skills and files endpoints that are not exposed by the current SDK stubs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* undo sample mypy

* Retry CI after transient external failures

Retrigger PR validation after an unrelated Copilot review workflow SAML failure and a transient external tau2 git fetch failure in the Windows Python test setup.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address review feedback on model option merging

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address Anthropic compatibility review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* moved all to `model`

* fixes for azure ai search

* Python: standardize remaining sample env var names

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Python: fix foundry-local pyright compatibility

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* updated env vars in cicd

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-04-01 19:00:18 +00:00

2.0 KiB

Script Approval — Human-in-the-Loop for Skill Scripts

This sample demonstrates how to require human approval before executing skill scripts using the require_script_approval=True option on SkillsProvider.

How It Works

When require_script_approval=True is set, the agent pauses before executing any skill script and returns approval requests instead:

  1. The agent tries to call run_skill_script — execution is paused
  2. result.user_input_requests contains approval request(s) with function name and arguments
  3. The application inspects each request and decides to approve or reject
  4. request.to_function_approval_response(approved=True|False) creates the response
  5. The response is sent back via agent.run(approval_response, session=session)
  6. If approved, the script executes; if rejected, the agent receives an error

Key Components

  • require_script_approval=True — Gates all script execution on human approval
  • result.user_input_requests — Contains pending approval requests after agent.run()
  • request.to_function_approval_response() — Creates an approval or rejection response

Running the Sample

Prerequisites

Environment Variables

Set the required environment variables in a .env file (see python/.env.example):

  • FOUNDRY_PROJECT_ENDPOINT: Your Azure AI Foundry project endpoint
  • AZURE_OPENAI_MODEL: The name of your model deployment (defaults to gpt-4o-mini)

Authentication

This sample uses AzureCliCredential for authentication. Run az login in your terminal before running the sample.

Run

cd python
uv run samples/02-agents/skills/script_approval/script_approval.py

Learn More