Documentation

Eval

Is the agent any good, and does it hold up under load?

Eval sets

Eval → Eval sets
Eval hub: custom eval, jailbreak and prompt injection, DLP and responsible AI suites

A list of cases: an input, and what a good answer looks like. Run the set against a live agent endpoint and each case is scored by an LLM-as-judge on the metrics you pick.

Every new workspace is seeded with three security red-team sets: jailbreak and prompt injection, data-loss prevention, and responsible AI.

Load tests

Eval → Load tests

A traffic generator against an agent endpoint, reporting latency percentiles, throughput and error rate.

Running your first eval

1

Open an eval set

Eval → Eval sets, then pick one of the seeded security sets or create your own and add cases.

2

Click Run eval

Choose a target (below) and the metrics to score. For a Cloud Run agent you can pick the service from your Google Cloud projects instead of pasting its URL.

3

Read the run

Each case gets a score and the judge's reasoning, so a low score comes with a stated reason rather than just a number you have to trust.

What an eval can call

Eval sets and load tests take the same two kinds of target:

TargetFieldsWhat TraptureIQ sends
ADK agentBase URL of an adk api_server (or adk web, or a Cloud Run service deployed with adk deploy cloud_run), App name, optional API keyPer case: create a session, POST /run_sse, delete the session. The API key, if set, goes in an X-API-Key header.
WebhookURL, optional headers as a JSON objectPOST {"question": "..."}, expecting {"answer": "...", "tool_calls": [...]} back. Works with any framework.
  • The URL must be publicly reachable. The calls come from TraptureIQ's servers, so localhost and private addresses are refused.
  • An ADK target sends no Google identity token. A Cloud Run service deployed without public access answers 403. Put the agent behind a webhook you control, or evaluate a copy that allows unauthenticated calls.
  • App name is the agent's folder name, the one adk web lists, not the Cloud Run service name.
  • Agent Engine is not a direct target yet. Its API is not the ADK REST API; call it from a webhook.
An unavailable judge says soJudge scoring needs a configured model. If there is not one, those metrics report unavailable. They are never quietly replaced with a weaker keyword-matching score. A number you cannot trust is worse than no number, because it looks like a result.

Next: Tools.