# `ADK.Eval.Scorer`
[🔗](https://github.com/zeroasterisk/adk-elixir/blob/main/lib/adk/eval/scorer.ex#L1)

Behaviour for evaluation scorers.

A scorer examines an agent's response (list of events) and returns a score
between 0.0 and 1.0, along with a pass/fail determination and details.

## Implementing a custom scorer

    defmodule MyScorer do
      @behaviour ADK.Eval.Scorer

      @impl true
      def score(events, opts) do
        # ... analyze events ...
        %{score: 1.0, pass: true, details: "looks good"}
      end
    end

# `score_result`

```elixir
@type score_result() :: %{score: float(), pass: boolean(), details: String.t() | nil}
```

# `score`

```elixir
@callback score(events :: [ADK.Event.t()], opts :: keyword()) :: score_result()
```

# `function_calls`

```elixir
@spec function_calls([ADK.Event.t()]) :: [map()]
```

Extract all function calls from events.

# `response_text`

```elixir
@spec response_text([ADK.Event.t()]) :: String.t()
```

Extract all text from agent response events (non-user, non-partial).

---

*Consult [api-reference.md](api-reference.md) for complete listing*