Actions

Actions represent the execution layer of Amigo's cognitive architecture—the mechanism through which agents both interact with external systems and perform tasks that fall outside a model's optimal entropy range. Unlike traditional tool calling, which treats tools as static, predefined capabilities, actions function as intelligent primitives that adapt dynamically to context. They handle everything from deterministic mathematical computations and large-scale algorithmic exploration (like alpha-beta search) to external system integrations, enabling sophisticated problem-solving workflows that span the complete spectrum from creative exploration to deterministic execution while preventing the execution drift that would otherwise compromise both performance and safety over time.

The Entropy Stratification Paradigm

The foundational principle underlying Amigo's action system is that different types of work require fundamentally different cognitive approaches. Some problems demand creative exploration, others require structured analysis, and still others need deterministic execution. The system achieves optimal performance by matching each unit of work to the most appropriate execution method—a process we call entropy stratification.

Understanding the Cognitive Spectrum

Open-ended problem-solving scenarios where agents operate with maximum degrees of freedom. In healthcare deployments, this manifests as diagnostic agents generating novel hypotheses for complex multi-symptom presentations, synthesizing insights from ambiguous laboratory results, or adapting treatment protocols for rare conditions. These actions leverage the full generative capacity of language models to explore solution spaces that lack predefined pathways.

The power of entropy stratification emerges from the agent's ability to transition fluidly between these execution modes within a single problem-solving session. An agent might engage in creative diagnostic exploration for complex symptom patterns, then shift to deterministic dosage calculations, then return to structured care coordination—each transition optimized for the cognitive demands of the specific task.

Compositional Intelligence Through Agent Forge

Agent Forge enables coding agents to build sophisticated action patterns through compositional intelligence—the ability to combine simple primitives into complex behaviors that exhibit emergent capabilities. Through Agent Forge's declarative configuration management, actions become programmable at scale, allowing coding agents to systematically optimize action compositions based on performance data.

Building Blocks of Intelligent Action

Rather than having monolithic tools that try to do everything, Amigo's action system works with composable primitives. A diagnostic agent might combine:

Composable Action Primitives

  • Symptom Analysis: Parse patient presentations

  • Mathematical Computation: Calculate drug interaction probabilities

  • Medical Literature Search: Find relevant research

  • Differential Diagnosis: Generate potential conditions

  • Risk Assessment: Evaluate treatment options

  • Care Coordination: Integrate with hospital systems

Each primitive is optimized for its specific entropy level—whether that's creative exploration within the model's capabilities or deterministic computation outside its optimal range—and can be combined with others to create clinical workflows that would be impossible with traditional rigid medical software.

Dynamic Composition Patterns

The real intelligence emerges from how these primitives compose through systematic reasoning across multiple architectural dimensions. Agent Forge's declarative approach enables coding agents to analyze performance data and discover optimal compositional patterns through cross-dimensional optimization.

Cross-Dimensional Reasoning for Entropy Optimization

The system achieves sophisticated entropy stratification by reasoning simultaneously across agent identity, context graph topology, dynamic behavior triggers, action primitives, and memory's dimensional framework. This multi-dimensional analysis enables the discovery of compositional configurations that optimize cognitive resource allocation for specific problem classes.

Pattern Discovery Through Architectural Reasoning

When analyzing performance gaps, coding agents examine the relationships between:

  • Agent Identity Manifestation: How professional personas influence action selection and execution patterns

  • Context Graph Navigation: Which state transitions and traversal patterns correlate with successful outcomes

  • Dynamic Behavior Activation: How behavioral triggers and instruction specificity affect problem-solving effectiveness

  • Action Composition Sequences: Which primitive combinations and orchestration patterns deliver optimal results

  • Memory Dimensional Framework: How the user model's dimensional structure and preserved contextual information influence the effectiveness of different approaches

Emergent Configuration Optimization

Through systematic reasoning across these dimensions, the system discovers that optimal entropy stratification is not predetermined but emerges from the interaction patterns between architectural components. Agent Forge enables the coding agents to:

  1. Analyze Cross-Dimensional Performance Patterns: Identify how specific combinations of agent identity, context density, behavior triggers, and memory dimensional structure influence action effectiveness

  2. Generate Compositional Hypotheses: Create new primitive definitions and composition patterns based on identified correlations

  3. Validate Pattern Effectiveness: Test proposed configurations through comprehensive simulation across memory dimensional variations

  4. Deploy Optimized Configurations: Implement validated patterns as new compositional standards for specific problem classes

This creates a recursive optimization loop where the system continuously refines its understanding of how architectural components should interact to achieve optimal entropy stratification for different problem domains and memory contexts. The continuous nature of this optimization prevents compositional drift—ensuring that as individual components evolve, their interactions remain coherent and effective rather than degrading through accumulated misalignment.

Context Graph and Dynamic Behavior Integration

Actions don't exist in isolation—they're deeply integrated with Amigo's context graph and dynamic behavior systems, creating a unified cognitive architecture where the agent's understanding of the problem space directly influences which actions become available and how they're orchestrated.

Actions represent the execution layer that manifests the orchestration capabilities of Dynamic Behaviors. When dynamic behaviors trigger side-effects, these often materialize as specific action executions. This creates a seamless bridge between conversational intelligence and real-world outcomes.

Context-Aware Action Availability

Different states in a context graph expose different action capabilities through state-specific tool specifications. When a clinical agent is in an Action State focused on emergency triage, it has access to both action-execution tools (vital sign analyzers, severity scoring tools) and exit-condition evaluation tools that determine when to transition to the next phase of care. When it transitions to a Decision State for treatment planning, different actions become available—drug interaction checkers, care protocol analyzers, and outcome prediction capabilities—specifically configured for information gathering and analysis rather than direct intervention.

This isn't just about having different tools available; it's about the agent's cognitive context shaping which types of actions make sense. The context graph provides the topological understanding that helps the agent select not just what to do, but when and how to do it. Each state can also reference external state machines, enabling complex workflow orchestration across multiple clinical domains—for example, transitioning from emergency care to specialized cardiology workflows and returning with enhanced context.

Dynamic Action Modification

Dynamic behaviors can modify the available action landscape in real-time based on conversational context. When a clinician mentions they're working with a pediatric patient, dynamic behaviors might expose additional actions for age-appropriate dosing calculations or pediatric-specific diagnostic criteria. When the conversation shifts to discussing chronic disease management, the action set adapts to include medication adherence tools and long-term outcome tracking capabilities.

This creates a fluid, adaptive tool environment where the agent's capabilities evolve based on the specific problem context rather than being locked into a fixed set of predefined tools.

Serverless Execution Architecture

Actions execute through a serverless architecture that provides enterprise-grade reliability while maintaining the flexibility needed for dynamic composition. This approach treats each action as an independently deployable, scalable unit that can be orchestrated as needed. Crucially, each action can specify its own custom runtime environment, enabling specialized computational capabilities that go far beyond traditional API calls.

Custom Runtime Environments

Each action can specify its own custom runtime environment, unlocking powerful computational capabilities:

Actions can include domain-specific libraries like NumPy for mathematical computations, TensorFlow for machine learning inference, or specialized medical calculation libraries

Elastic and Reliable Execution

The serverless model means actions can scale from zero to handle demand spikes without requiring pre-provisioned infrastructure. When a clinical agent needs to perform intensive analysis across thousands of patient records during a public health emergency, the system can automatically provision the necessary compute resources and scale them back down when the analysis is complete.

This architecture also provides natural isolation boundaries—each action executes in its own environment with scoped permissions and resource access. If one action fails or behaves unexpectedly, it doesn't affect other actions or the overall system stability. The custom runtime approach means each action gets exactly the computational environment it needs without compromising other actions or the core agent system.

Enterprise Security and Compliance

All action execution occurs with comprehensive security controls including encrypted communication, secure secret management, and complete audit trails. Actions receive only the minimal permissions necessary for their specific function, following the principle of least privilege. Each action runs in its own isolated environment with organization-level separation, ensuring that healthcare organizations maintain strict data boundaries and compliance with regulations like HIPAA.

The system maintains detailed logs of all action executions, making it possible to understand exactly what happened during any problem-solving session and ensuring compliance with enterprise governance requirements. Multi-layered security includes encrypted secrets management with rotation capabilities, webhook signing for external integrations, and comprehensive audit trails that meet healthcare compliance standards.

Economic Work Unit Delivery

Actions are ultimately organized around delivering economic work units—coherent packages of business value that solve real problems for organizations. This focus ensures that all the sophisticated orchestration and composition translates into measurable outcomes.

From Technical Execution to Business Value

The system continuously tracks how action compositions contribute to completing meaningful work. A successful economic work unit might be:

Verification and Continuous Improvement

Each economic work unit undergoes multi-dimensional verification to ensure it meets quality standards. This includes verifying that individual actions executed correctly, that the composition achieved its intended outcome, and that the result provides genuine business value. The system supports sophisticated versioning with semantic version constraints, enabling blue-green deployments and zero-downtime updates while maintaining rollback capabilities for safety.

The verification data feeds back into Agent Forge's optimization process, enabling coding agents to continuously improve their action composition strategies. Actions that consistently contribute to successful work units are reinforced and extended, while patterns that don't deliver value are identified and improved. This continuous feedback loop prevents the gradual degradation of action effectiveness that would otherwise occur as problem domains evolve and requirements shift. Performance metrics include success rates, latency patterns, and resource utilization, with automatic failover capabilities ensuring system reliability.

Future-Ready Architecture

The action system is designed to integrate seamlessly with emerging AI capabilities while maintaining operational stability. As new AI paradigms emerge, the compositional architecture can incorporate them without disrupting existing workflows.

Preparing for Neuralese Integration

When high-bandwidth vector communication becomes available through technologies like Neuralese, the action system will be ready to take advantage of these capabilities. Actions will be able to pass rich multidimensional representations between each other instead of compressed text tokens, enabling more sophisticated reasoning chains and emergent behaviors.

Surgical Capability Enhancement

The modular design enables surgical adoption of new capabilities. New action types can be added without modifying existing actions, and existing actions can be enhanced with new capabilities while maintaining compatibility with current implementations.

This approach turns AI advancement from a disruptive force into a controlled opportunity for continuous improvement, allowing organizations to benefit from new capabilities while maintaining the reliability and predictability they need for mission-critical work.

Operational Excellence

Actions operate within a comprehensive operational framework that ensures reliability, performance, and continuous improvement across enterprise deployments.

Monitoring and Reliability

The system provides comprehensive monitoring of action performance, including execution time, resource utilization, and success rates across different entropy levels. This data enables proactive identification of potential issues before they impact operational performance. Advanced analytics track state machine transition patterns, identify stuck states, and monitor resource costs across multi-region deployments with automatic load balancing.

Actions are designed with fault tolerance in mind, providing graceful error recovery and meaningful fallback behaviors when things don't go as expected. Circuit breakers prevent cascading failures, and graceful degradation ensures continued operation even when some capabilities are unavailable. The system supports multi-LLM provider integration with automatic provider selection based on performance, ensuring reliability even when specific AI services experience issues.

Learning and Evolution

Perhaps most importantly, the action system is designed to learn and improve over time. As agents execute more actions and complete more economic work units, the system builds a deeper understanding of which action patterns work best for different types of problems.

This learning feeds back into Agent Forge's optimization capabilities, enabling coding agents to continuously refine their problem-solving approaches. The result is a system that becomes more intelligent and effective over time, rather than remaining static despite advances in underlying AI capabilities.


Actions represent the bridge between Amigo's sophisticated cognitive architecture and real-world problem-solving. By combining entropy-aware execution with compositional intelligence and continuous learning, actions enable agents to deliver reliable, measurable business value while maintaining the flexibility to adapt to new challenges and opportunities.

Next Steps

For implementation examples and detailed configuration guidance, explore the Action Architecture documentation in the developer guide.

Last updated

Was this helpful?