Skip to content

leaderboard

agentic_ml.research.tools.leaderboard

The read_leaderboard tool.

make_read_leaderboard

make_read_leaderboard(ctx: ResearchContext)

Build a read_leaderboard tool bound to ctx.

Source code in src/agentic_ml/research/tools/leaderboard.py
15
16
17
18
19
20
21
22
23
24
25
26
27
28
def make_read_leaderboard(ctx: ResearchContext):
    """Build a ``read_leaderboard`` tool bound to ``ctx``."""

    @tool
    def read_leaderboard() -> str:
        """Return the current leaderboard as CSV text.

        Columns: ID, Status, one column per tracked metric, runtime and description.
        Use it to decide what to try next and to avoid repeating failed ideas. If you
        only want to inspect a specific trial, use `read_leaderboard_row(trial_id)`.
        """
        return read_leaderboard_action(ctx)

    return read_leaderboard

make_read_leaderboard_row

make_read_leaderboard_row(ctx: ResearchContext)

Build a read_leaderboard_row tool bound to ctx.

Source code in src/agentic_ml/research/tools/leaderboard.py
31
32
33
34
35
36
37
38
39
40
41
42
43
def make_read_leaderboard_row(ctx: ResearchContext):
    """Build a ``read_leaderboard_row`` tool bound to ``ctx``."""

    @tool
    def read_leaderboard_row(trial_id: str) -> str:
        """Return the leaderboard row for a given trial ID as CSV text.

        Columns: ID, Status, one column per tracked metric, runtime and description.
        Use it to inspect the results of a specific trial.
        """
        return read_leaderboard_action(ctx, trial_id=trial_id)

    return read_leaderboard_row