> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Evaluation Service

> Evaluation Service API methods in the Galtea SDK

The Evaluation Service in the Galtea SDK allows you to manage [evaluations](/concepts/product/version/session/evaluation) for assessing your products.
This Service is exposed by the `galtea.evaluations` object.

<Info>
  Remember that we will be using the `galtea` object. More information [here](/sdk/api/galtea).
</Info>

## Quick Example

First, initialize the Galtea SDK:

```python theme={"system"}
galtea = Galtea(api_key="YOUR_API_KEY")
```

Create evaluations of a session (one per metric):

```python theme={"system"}
evaluations = galtea.evaluations.create(
    session_id=session_id,
    metrics=[{"name": "Role Adherence"}, {"name": "Conversation Relevancy"}],
)
```

At some point later, you will be able to list all evaluations for that session:

```python theme={"system"}
evaluations = galtea.evaluations.list(session_id=session_id)
```

Display the results:

<Tip>
  Evaluations start in `PENDING` status while the evaluation engine processes them. Use [`wait_for()`](/sdk/api/evaluation/wait-for) to poll until all evaluations have completed before reading results.
</Tip>

```python theme={"system"}
print(f"Total evaluations: {len(evaluations)}")
scores = [ev.score for ev in evaluations if ev.score is not None]
if len(scores) > 0:
    average_score = sum(scores) / len(scores)
    print(f"Average Score: {average_score}")
else:
    print("No scores available yet")

print("Detailed Results:")
for evaluation in evaluations:
    metric = galtea.metrics.get(metric_id=evaluation.metric_id)
    print(f"Metric: {metric}")
    print(f"    Score: {evaluation.score}")
    print(f"    Reason: {evaluation.reason}")
```

## Service Methods

* [Run Evaluation](/sdk/api/evaluation/run)
* [Create Single-Turn Evaluation](/sdk/api/evaluation/create-single-turn)
* [Create Evaluations](/sdk/api/evaluation/create)
* [Wait for Evaluations](/sdk/api/evaluation/wait-for)
* [Listing Evaluations](/sdk/api/evaluation/list)
* [Retrieving Evaluation](/sdk/api/evaluation/get)
* [Deleting Evaluation](/sdk/api/evaluation/delete)
* [Retrying Evaluations](/sdk/api/evaluation/retry)

## Related

<Card title="Evaluation" icon="clipboard-check" iconType="solid" href="/concepts/product/version/session/evaluation">
  The assessment of an evaluation using a specific metric's criteria
</Card>
