fabricatio-capable

MIT

Capability assessment mixin for Fabricatio agents — determines whether a request can be fulfilled given available tools and context.

Installation

pip install fabricatio[capable]
# or
uv pip install fabricatio[capable]

For the full Fabricatio suite:

pip install fabricatio[full]

Overview

fabricatio-capable provides the Capable mixin class, which equips an agent with the ability to assess whether a given task is within its capabilities. It answers questions like: "given my current toolboxes and context, can I handle this request?"

The mixin composes three capabilities into one method:

• WithBriefing — supplies agent context as a structured briefing.
• EvidentlyJudge — delegates to the evidence-based judgment engine from fabricatio-judge.
• UseTool — provides access to the agent's ToolBox set for tool-cognizant evaluation.

The capable() method renders a configurable Jinja2 template with the briefing, request text, and toolbox metadata, then passes it through evidently_judge to produce a JudgeMent — a binary verdict backed by affirmative and denying evidence.

Key Types

Usage

Single Request

from fabricatio_capable.capabilities.capable import Capable
from fabricatio_judge.models.judgement import JudgeMent
from fabricatio_tool.models.tool import ToolBox

class MyAgent(Capable):
    # Capable is an ABC; provide your concrete agent logic here.
    ...

agent = MyAgent()
toolboxes = {ToolBox(name="file_tools"), ToolBox(name="web_tools")}

result: JudgeMent | None = await agent.capable(
    "Read the latest commit and summarize changes",
    toolboxes=toolboxes,
)

if result and result.final_judgement:
    print("Capable — proceeding.")
else:
    print("Not capable. Evidence:", result.evidences if result else "N/A")

Batch Assessment

requests = [
    "Fetch weather data for Tokyo",
    "Train a LoRA on 100GB of images",
]
results = await agent.capable(requests, toolboxes=toolboxes)

for req, judgement in zip(requests, results):
    verdict = judgement.final_judgement if judgement else "undetermined"
    print(f"{req}: {verdict}")

Configuration

All options below are read through the fabricatio configuration chain (see the Configuration Guide). Set them under the [ext.capable] table in fabricatio.toml, equivalently under [tool.fabricatio.ext.capable] in pyproject.toml, or via FABRICATIO_EXT__CAPABLE__<FIELD_UPPER> environment variables.

[ext.capable]
capable_template = "built-in/capable"

Access at runtime: from fabricatio_capable.config import capable_config.

Dependencies

• fabricatio-core — Core interfaces, briefing model, template manager
• fabricatio-tool — UseTool capability and ToolBox model
• fabricatio-judge — EvidentlyJudge and JudgeMent

License

MIT — see LICENSE