How simonbayl/agentic_optimization_tool works
This is a conversational operations-research agent: a user describes a decision problem, answers targeted questions, supplies data, and receives a solved linear optimization model and a business-language explanation. The turn-based LangGraph orchestrator coordinates understanding, completeness checks, clarification, model generation and execution, editing, and explanation. The README documents scenario comparisons and relaxations; unsampled implementations are represented by their existing directories where necessary. Edges rely on README statements, the shown orchestrator excerpt, or SOURCE INDEX references; unsampled connections are omitted where ownership is unclear.
Main entry points: graph_orchestrator.py Turn orchestrator · builder.py Code generation · ConversationSession.py Conversation session · Explain.py Result explanation
Components 27
Conversation
- Terminal interface
interactions/terminal.py - Conversation session
interactions/ConversationSession.py - Data schema reader
interactions/data_schema.py - Turn orchestrator
orchestrator/graph_orchestrator.py
Problem formalization
- Business understanding
agentic_tools/understand/AgentUnderstand.py - Business specification
data_model/BusinessProblemSpec.py - Model completion
agentic_tools/completeness/AgentComplete.py - Completeness checker
agentic_tools/completeness/checker.py - Clarification policy
orchestrator/dialogue.py
Model and solve
- Mathematical model
data_model/MathematicalStructure.py - Code generation
agentic_tools/model/builder.py - Generation context
agentic_tools/model/context.py - Model validation
agentic_tools/model/validation.py - Generated-code execution
agentic_tools/model/executor.py - Solver runner
agentic_tools/model/runner.py
Results and editing
- Model editing
agentic_tools/edit/AgentEdit.py - Model patch
agentic_tools/edit/patch.py - Result explanation
agentic_tools/explain/Explain.py - Constraint margins
agentic_tools/explain/margins.py - Scenario reports
agentic_tools/explain/report.py
Shared state
- Clarification state
data_model/ClarificationState.py - Optimization result
data_model/OptimisationResult.py - Shared agent state
data_model/AgentState.py
Other components
- User
- User data files
- Mistral API
- OR-Tools HiGHS
Connections 34
- User → Terminal interface: sends request
README.md - Terminal interface → Conversation session: forwards turn
interactions/terminal.py - Conversation session → Turn orchestrator: runs turn
- Conversation session → Data schema reader: loads schema
- User data files → Data schema reader: provides columns
README.md - Turn orchestrator → Business understanding: updates understanding
orchestrator/graph_orchestrator.py - Business understanding → Mistral API: requests interpretation
- Business understanding → Business specification: returns specification
agentic_tools/understand/AgentUnderstand.py - Turn orchestrator → Model completion: completes model
orchestrator/graph_orchestrator.py - Turn orchestrator → Completeness checker: checks completeness
orchestrator/graph_orchestrator.py - Completeness checker → Clarification state: produces questions
agentic_tools/completeness/checker.py - Turn orchestrator → Clarification policy: applies question policy
orchestrator/graph_orchestrator.py - Clarification policy → Clarification state: updates questions
orchestrator/dialogue.py - Model completion → Mathematical model: formalizes problem
- Turn orchestrator → Code generation: builds model
orchestrator/graph_orchestrator.py - Code generation → Generation context: prepares generation context
agentic_tools/model/builder.py - Code generation → Model validation: validates generated code
agentic_tools/model/builder.py - Code generation → Generated-code execution: executes generated code
agentic_tools/model/builder.py - Code generation → Mathematical model: uses model specification
agentic_tools/model/builder.py - Generated-code execution → Solver runner: runs model
- Solver runner → OR-Tools HiGHS: solves optimization
- Code generation → User data files: loads model data
README.md - Code generation → Optimization result: returns solve result
agentic_tools/model/builder.py - Turn orchestrator → Model editing: handles model edits
orchestrator/graph_orchestrator.py - Model editing → Model patch: proposes patch
agentic_tools/edit/AgentEdit.py - Model editing → Code generation: rebuilds after edit
agentic_tools/edit/AgentEdit.py - Turn orchestrator → Result explanation: explains result
orchestrator/graph_orchestrator.py - Turn orchestrator → Constraint margins: computes margins
orchestrator/graph_orchestrator.py - Result explanation → Mistral API: requests explanation
- Result explanation → Optimization result: interprets solution
agentic_tools/explain/Explain.py - Result explanation → Scenario reports: includes scenarios
agentic_tools/explain/Explain.py - Turn orchestrator → Shared agent state: routes shared state
orchestrator/graph_orchestrator.py - Conversation session → Shared agent state: maintains conversation
interactions/ConversationSession.py - Turn orchestrator → Terminal interface: returns reply