Skip to content

docs: add use_agent, graph, and elasticsearch_memory to README#431

Merged
mkmeral merged 2 commits intostrands-agents:mainfrom
agent-of-mkmeral:add-use-agent-to-readme
Mar 30, 2026
Merged

docs: add use_agent, graph, and elasticsearch_memory to README#431
mkmeral merged 2 commits intostrands-agents:mainfrom
agent-of-mkmeral:add-use-agent-to-readme

Conversation

@agent-of-mkmeral
Copy link
Copy Markdown
Contributor

@agent-of-mkmeral agent-of-mkmeral commented Mar 27, 2026

Summary

Adds documentation for three tools that were missing or incomplete in the README:

  1. use_agent (Agent as Tool) — was completely missing
  2. graph (Multi-Agent DAG) — was completely undocumented (distinct from agent_graph)
  3. elasticsearch_memory — had usage examples but was missing from the Tools Overview table

Changes

1. Features Section

  • Added 🤖 Agent as Tool bullet describing nested agent instances with model switching support
  • Added 🔗 Multi-Agent Graph bullet describing deterministic DAG-based multi-agent pipelines

2. Tools Overview Table

  • Added use_agent row with usage example and description
  • Added graph row with usage example and description
  • Added elasticsearch_memory row with usage example and description

3. Usage Examples Section

  • Added comprehensive Use Agent (Agent as Tool) section with examples showing:
    • Basic usage inheriting parent agent's model
    • Model switching with different providers (bedrock, ollama, github)
    • Environment-based model selection (model_provider="env")
    • Custom model configuration with parameters
    • Tool filtering for nested agents
  • Added Graph (Multi-Agent DAG) section with examples showing:
    • Creating a multi-agent research pipeline with per-node model configuration
    • Executing tasks through the graph
    • Status, list, and delete operations
    • Clear distinction from agent_graph (persistent message-passing vs DAG execution)

4. Environment Variables Section

  • Added Use Agent Tool environment variables table
  • Added Elasticsearch Memory Tool environment variables table (all ELASTICSEARCH_* vars)
  • Added Graph Tool note about shared model env vars

Context

Requested by @mkmeral in this comment.

Ref: agent-of-mkmeral/strands-coder-private#64

Add the use_agent (Agent as Tool) documentation to README.md:

- Added to Features section with description of nested agent instances
  and model switching support
- Added to Tools Overview table with usage example and description
- Added comprehensive Usage Examples section showing:
  - Basic usage inheriting parent model
  - Model switching with different providers (bedrock, ollama, github)
  - Environment-based model selection
  - Custom model configuration with parameters
  - Tool filtering for nested agents
- Added Environment Variables section for use_agent configuration

Closes strands-agents/tools#XXX
@mkmeral mkmeral enabled auto-merge (squash) March 27, 2026 19:57
Comment thread README.md
@mkmeral
Copy link
Copy Markdown
Contributor

mkmeral commented Mar 27, 2026

@agent-of-mkmeral these are the other missing ones. can you add these too?

:x: Missing from README Tools Overview table entirely:
use_agent.py — spawn sub-agents dynamically
→ Just addressed by @murmeral in [PR #431](https://github.com/strands-agents/tools/pull/431) :tada:
graph.py — :warning: completely undocumented
→ Different from agent_graph.py (which IS in the table). graph.py has no entry anywhere in the README.
:warning: Partially documented (example section exists, but NOT in the Tools Overview table):
elasticsearch_memory.py — has a usage example at the bottom of README but is absent from the main tools table

Add missing tool documentation as requested by @mkmeral:

- graph.py: Added to Features section, Tools Overview table, Usage
  Examples section with comprehensive DAG pipeline example, and
  Environment Variables section. This is distinct from agent_graph
  (persistent message-passing) — graph uses deterministic DAG execution
  with output propagation via Strands SDK GraphBuilder.

- elasticsearch_memory.py: Added to Tools Overview table (was already
  documented in Usage Examples but missing from the main table). Added
  Environment Variables section documenting all ELASTICSEARCH_* vars.
auto-merge was automatically disabled March 27, 2026 20:26

Head branch was pushed to by a user without write access

@agent-of-mkmeral
Copy link
Copy Markdown
Contributor Author

Done! Added both missing tools in commit 1019acd:

graph.py (was completely undocumented)

  • ✅ Added to Features section: "🔗 Multi-Agent Graph"
  • ✅ Added to Tools Overview table with usage example
  • ✅ Added comprehensive Usage Examples section ("Graph - Multi-Agent DAG") with full DAG pipeline example showing create, execute, status, list, delete actions
  • ✅ Added Environment Variables section (notes it shares model env vars with use_agent)
  • ✅ Clearly distinguished from agent_graph (persistent message-passing vs deterministic DAG execution)

elasticsearch_memory.py (had examples but missing from table)

  • ✅ Added to Tools Overview table with usage example
  • ✅ Added Environment Variables section documenting all ELASTICSEARCH_* vars with defaults

Also replied to @hfurkanbozkurt's review thread clarifying the use_agent env vars.

@agent-of-mkmeral agent-of-mkmeral changed the title docs: add use_agent tool to README docs: add use_agent, graph, and elasticsearch_memory to README Mar 27, 2026
@mkmeral mkmeral enabled auto-merge (squash) March 27, 2026 21:39
@mkmeral mkmeral merged commit b0c8f30 into strands-agents:main Mar 30, 2026
17 of 18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants