feat: add experimental AgentConfig with comprehensive tool management

[mr-lee]

Resuming #865

Description

• Add AgentConfig class for loading configuration from JSON files or dicts
• Support model, prompt, and tools configuration options
• Update tool registry to resolve tool names from strands_tools package
• Maintain backward compatibility with existing Agent constructor
• Add comprehensive tests for configuration loading and validation

Usage example

For basic usage with the default set of tools available to choose from the config: file_read, editor, http_request, use_agent, and shell

from strands.experimental import AgentConfig

config = AgentConfig({"model": "test-model", "prompt": "Test prompt", "tools": ["file_read", "shell"]})
agent = config.to_agent() # kwargs are passed to the agent init

To configure the set of tools available to the config, you can supply your own tool registry:

from strands import tool
from strands.experimental import AgentConfig
from strands.tools.registry import ToolRegistry

@tool
def add(x: int, y: int) -> int:
    return x + y

tool_registry = ToolRegistry()
tool_registry.process_tools([add])

# Create config with tool selection
config = AgentConfig(
    {"model": "test-model", "prompt": "Test prompt", "tools": ["add"]}, tool_registry=tool_registry
)
agent = config.to_agent() # kwargs are passed to the agent init

You can also load a config from a file:

from strands.experimental import AgentConfig

config = AgentConfig("file://path/to/local/config) # Config gets loaded into dict
agent = config.to_agent() # kwargs are passed to the agent init

Documentation PR

strands-agents/docs#252

Type of Change

New feature

Testing

How have you tested the change? Verify that the changes do not break functionality or introduce warnings in consuming repositories: agents-docs, agents-tools, agents-cli

• I ran hatch run prepare

Checklist

• I have read the CONTRIBUTING document
• I have added any necessary tests that prove my fix is effective or my feature works
• I have updated the documentation accordingly
• I have added an appropriate example to the documentation to outline the feature, or no new docs are needed
• My changes generate no new warnings
• Any dependent changes have been merged and published

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[awsarron]

proposed interface during experimental:

from strands.experimental import config_to_agent

agent = config_to_agent("/path/to/amazing-agent.json")

agent("do the thing")

potential interface for non-experimental in future releases:

from strands import config_to_agent

agent = config_to_agent("/path/to/amazing-agent.json")

agent("do the thing")

example amazing-agent.json definition of tools:

{
  // ...
  tools: ["strands_tools.file_read", "my_app.tools.cake_tool", "/path/to/another_tool.py"]
}

strands supports loading tools from python modules and filepaths:

sdk-python/src/strands/tools/registry.py

Lines 57 to 105 in eef11cc

	def add_tool(tool: Any) -> None:
	# Case 1: String file path
	if isinstance(tool, str):
	# Extract tool name from path
	tool_name = os.path.basename(tool).split(".")[0]
	self.load_tool_from_filepath(tool_name=tool_name, tool_path=tool)
	tool_names.append(tool_name)
	# Case 2: Dictionary with name and path
	elif isinstance(tool, dict) and "name" in tool and "path" in tool:
	self.load_tool_from_filepath(tool_name=tool["name"], tool_path=tool["path"])
	tool_names.append(tool["name"])
	# Case 3: Dictionary with path only
	elif isinstance(tool, dict) and "path" in tool:
	tool_name = os.path.basename(tool["path"]).split(".")[0]
	self.load_tool_from_filepath(tool_name=tool_name, tool_path=tool["path"])
	tool_names.append(tool_name)
	# Case 4: Imported Python module
	elif hasattr(tool, "__file__") and inspect.ismodule(tool):
	# Get the module file path
	module_path = tool.__file__
	# Extract the tool name from the module name
	tool_name = tool.__name__.split(".")[-1]
	# Check for TOOL_SPEC in module to validate it's a Strands tool
	if hasattr(tool, "TOOL_SPEC") and hasattr(tool, tool_name) and module_path:
	self.load_tool_from_filepath(tool_name=tool_name, tool_path=module_path)
	tool_names.append(tool_name)
	else:
	function_tools = self._scan_module_for_tools(tool)
	for function_tool in function_tools:
	self.register_tool(function_tool)
	tool_names.append(function_tool.tool_name)
	if not function_tools:
	logger.warning("tool_name=<%s>, module_path=<%s> | invalid agent tool", tool_name, module_path)
	# Case 5: AgentTools (which also covers @tool)
	elif isinstance(tool, AgentTool):
	self.register_tool(tool)
	tool_names.append(tool.tool_name)
	# Case 6: Nested iterable (list, tuple, etc.) - add each sub-tool
	elif isinstance(tool, Iterable) and not isinstance(tool, (str, bytes, bytearray)):
	for t in tool:
	add_tool(t)
	else:
	logger.warning("tool=<%s> | unrecognized tool specification", tool)

for the initial implementation in this PR we could do something like:

def config_to_agent(filepath: str) -> Agent:
    # pseudo code
    parsed_config = JSON.loads(filepath)
    tools_list = []
    for tool in parsed_config["tools"]:
        tool_arg = tool
        if not is_filepath(tool):
            try:
                tool_arg = importlib.import_module(tool)
            except ImportError as e:
                # handle tool not a file and not a module
        tools_list.append(tool_arg)
    return Agent(tools=tools_list)

[Unshure]

Can we add tests for loading module tools, as well as specific functions from a module? You can add the tools to the tests/fixtures directory

[cagataycali]

blocker: can we support mcp_servers, a2a_servers, load_tool_from_directory, system_prompt (not as prompt given below), provider, session id, s3 session support etc here?

[cagataycali]

can we support multi-agents as array of agents instead of just support one agent?