feat: add set_conversational_output tool + generate-output prompt for conversational agents

[maxduu]

Summary

Two additive changes in uipath/agent/react/:

1. New flow-control tool definition set_conversational_output — a framework-internal tool bound by the langchain runtime's GENERATE_CONVERSATIONAL_OUTPUT node to reliably extract structured output fields from a conversational agent's turn. Mirrors the existing end_execution/raise_error shape.
2. New generate-output instruction prompt — the framework-internal HumanMessage appended to the extraction LLM call, telling the model to fill the tool's args from the conversation with per-turn priority and "N/A"-placeholder rules for un-yet-determinable required fields.

Context

Part of a four-PR series enabling reliable structured-output extraction for conversational agents. This PR only adds primitives to `uipath`; the graph wiring lives in uipath-langchain, the runtime gating in uipath-agents, and the FPS field in uipath-runtime.

Related PRs

Part of a coordinated four-repo change. Each PR is independently reviewable, but they land together:

• uipath-runtime-python feat: expose conversationalService.enableOutputs FPS flag on context uipath-runtime-python#142 — surfaces the conversationalService.enableOutputs FPS flag on UiPathRuntimeContext.
• uipath-python feat: add set_conversational_output tool + generate-output prompt for conversational agents #1785 — adds the set_conversational_output flow-control tool + generate-output prompt primitives.
• uipath-langchain-python feat: add conversational-output node for low-code conversational-agent loop uipath-langchain-python#965 — implements the GENERATE_CONVERSATIONAL_OUTPUT graph node, router path, and terminate extraction (the main change).
• uipath-agents-python https://github.com/UiPath/uipath-agents-python/pull/588 — Gates custom outputs on the FPS flag + agent-version.

Test plan

• `uv run pytest packages/uipath/tests/agent/react/test_conversational_prompts.py` (26 tests pass)
• `ruff check` + `ruff format --check` clean

[Copilot]

Pull request overview

Adds framework primitives in uipath.agent.react to support reliable structured-output extraction for conversational agents by introducing a new flow-control tool (set_conversational_output) and a dedicated generate-output instruction prompt used during extraction.

Changes:

• Added SET_CONVERSATIONAL_OUTPUT_TOOL (and supporting enum + placeholder schema model) to the ReAct flow-control tool set.
• Added _GENERATE_OUTPUT_INSTRUCTION + get_generate_output_prompt() to provide an internal instruction prompt for structured-output extraction.
• Added tests validating the presence and key constraints of the generate-output prompt.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
packages/uipath/src/uipath/agent/react/tools.py	Adds the new flow-control tool name, placeholder args schema model, and exported tool config.
packages/uipath/src/uipath/agent/react/conversational_prompts.py	Adds the generate-output instruction constant and accessor used during structured-output extraction.
packages/uipath/src/uipath/agent/react/init.py	Exports the new tool constant, schema model, and prompt accessor.
packages/uipath/tests/agent/react/test_conversational_prompts.py	Adds tests for the new generate-output prompt accessor.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

🚨 Heads up: uipath-langchain cross-tests are FAILING 🚨

Your changes may break the uipath-langchain-python integration.

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →