vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-09 17:08:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
agent-zero/helpers/responses_tools.py.dox.md
Alessandro f90bb63a9f
Some checks are pending
Build And Publish Docker Images / plan (push) Waiting to run
Details
Build And Publish Docker Images / build (push) Blocked by required conditions
Details
Use prompt-declared Responses tool names 
Prefer explicit tool_name examples and first prompt headings when deriving native Responses function tool names, falling back to the prompt filename only when no callable name is declared.

Add regression coverage for code_execution_tool, memory_load, call_subordinate, behaviour_adjustment, and filename-only fallback, and document the contract in responses_tools DOX.
2026-06-15 15:06:48 +02:00

1.4 KiB
Raw Blame History

responses_tools.py DOX

Purpose

  • Own conversion of Agent Zero tool prompt files and MCP tool metadata into OpenAI Responses API function tool definitions.
  • Keep native Responses function availability synchronized with the text tool prompt surface.

Ownership

  • responses_tools.py owns runtime implementation.
  • responses_tools.py.dox.md owns durable notes about responsibilities, prompt-derived contracts, and verification for this helper.

Local Contracts

  • Build local function tools from enabled agent.system.tool.*.md prompt files.
  • Local prompt-derived function names prefer explicit "tool_name" examples, then the first prompt heading, and only fall back to the prompt filename when the prompt declares no callable name.
  • Preserve original Agent Zero tool names through the native Responses name map.
  • Keep MCP tool schemas merged after local prompt-derived tools.
  • Connector remote tools are advertised only when _a0_connector runtime metadata says the matching connected CLI capability is currently available.

Work Guidance

  • Keep prompt-derived descriptions bounded by MAX_TOOL_DESCRIPTION_CHARS.
  • Treat plugin-specific tool gates as optional imports so core helper loading does not require a plugin that is absent or disabled.

Verification

  • Run targeted Responses/tool prompt tests after changing function-tool construction.
  • Run connector prompt gating tests when changing remote tool availability.