Runs a ReAct tool loop against a local order-tracking catalog.
Java 17+, Maven 3.9.1+, and the matching local ARGI/Extensions RC2 artifacts. Set ARGI_API_KEY and ARGI_MODEL; optionally set ARGI_BASE_URL to an OpenAI-compatible /v1 endpoint.
See the repository setup before running a module.
From the repository root, after installing the example reactor:
bash tools/run.sh argi-agent-example/react-toolsThe application owns a small order catalog. The real model requests track_order, ARGI executes it, and the model consumes the paired result. Unknown IDs return a tool error; they do not invent a shipment.
- ReactTools.java is the primary entry point.
- Website coverage maps documentation chapters to examples.
- Compatibility notes describe RC2 API changes and the verification boundary.
Local builds and selected runtime checks were performed on 2026-10-15. See validation results for the exact tested scope and remaining failures; compilation alone does not certify an external integration.
- Runs a ReAct tool loop against a local order-tracking catalog.
- Tool schema and argument validation; malformed JSON and missing records; unknown registry bindings; result/call identity; direct tool return.
Limit: A local order repository; no commerce API or irreversible order mutation.
| Source | Responsibility |
|---|---|
| DirectTrackingTool.java | Returns the application result directly instead of asking the model to rewrite it. |
| OrderRecord.java | Immutable application data returned by the tracking repository. |
| OrderRepository.java | A local fixture repository; replacing it does not change the tool schema. |
| ReactTools.java | A delivery assistant whose tracking results come from an application tool. |
| ToolScenarios.java | Exercises successful calls, invalid arguments, missing data and unknown tool names. |
| TrackingTool.java | Validates model-supplied arguments before looking up an application record. |
Run from the repository root after installing the reactor dependencies. Select an entry point explicitly. The validation record distinguishes completed runs from unexecuted or failed scenarios.
Returns the application result directly instead of asking the model to rewrite it. Runtime: model.
bash tools/run.sh argi-agent-example/react-tools -Dexample.mainClass=io.github.agentic.ai.examples.DirectTrackingToolExercises successful calls, invalid arguments, missing data and unknown tool names. Runtime: local.
bash tools/run.sh argi-agent-example/react-tools -Dexample.mainClass=io.github.agentic.ai.examples.ToolScenarios