fractale-agents 0.0.12

Agents to support fractale agentic framework

fractale agents

Agents to use with fractale, agentic state-machine orchestrator for Science

A sub-agent is a single step in a state machine that can call other sub-agents, tools, or prompts, and respond dynamically to work on a scoped task. Sub-agents are created in order to map our expertise and logic into a more controlled execution or interaction with an LLM.

Agents

The following agents are availble.

Name	Description	Path
flux-operator	expert to deploy Flux Operator MiniClusters to Kubernetes	fractale_agents.kubernetes.FluxOperatorAgent
flux-build	optimized to build containers for the Flux Operator	fractale_agents.kubernetes.FluxBuildAgent
result_parse	Parse specific metrics from output logs	fractale_agents.parsers.ResultParserAgent
optimize	General optimization agent	fractale_agents.optimize.OptimizeAgent
job-transform	Job specification transformation agent	fractale_agents.hpc.job.JobTransformAgent
job-generate	Job specification generation agent	fractale_agents.hpc.job.JobGenerationAgent

The general prompt agent is provisioned by fractale directly, fractale.agents.general.PromptAgent. Would you like to see an expert added? Please open an issue and let us know.

Usage

A sub-agent is a specialized expert that can be imported and used in a fractale workflow. You can register agents on the fly, or via a configuration file.

# Register a sub-agent tool on the fly
fractale prompt -t fractale_agents.kubernetes.FluxOperatorAgent Deploy lammps to Kubernetes using the Flux Operator

Or write the tool into a registry file:

# sub-agents.yaml
tools:
  - path: fractale_agents.kubernetes.FluxOperatorAgent

And then:

fractale prompt -r ./sub-agents.yaml Deploy lammps to Kubernetes using the Flux Operator

The agents have logical dependencies. For example, the flux-operator sub agent is expecting to have access to a Kubernetes cluster to install and use the Flux Operator!

License

HPCIC DevTools is distributed under the terms of the MIT license. All new contributions must be made under this license.

See LICENSE, COPYRIGHT, and NOTICE for details.

SPDX-License-Identifier: (MIT)

LLNL-CODE- 842614