Activate evaluation scoring for external AI systems

task australia Updated Sep 10, 2026 3 min read mon-ai-monitor-external-ai-system.md
Raw file servicenow.com

Assess the quality and safety of your external AI systems by connecting them to AI Control Tower and activating evaluation scoring.

Before you begin

Role required: sn_ai_governance.ai_steward

About this task

External AI systems require trace data to be scored by the evaluation engine. Unlike AI systems on the ServiceNow AI Platform, which are automatically instrumented, external AI systems must be connected to send trace data to AI Control Tower. There are two ways to establish this connection:

  • SDK instrumentation: Instrument your AI agent code using the Traceloop SDK and authenticate with an API key. Use this method for any AI agent framework that is not hosted on a supported cloud platform or monitoring service.
  • Trace connection: Connect to a supported cloud platform or monitoring service through your cloud credentials and a MID Server. Use this method when your AI agents already run on or send traces to a supported platform. No API key or code instrumentation is required.

Procedure

  1. Navigate to All > AI Control Tower > Home > Settings > Rules and templates > Evaluation.

  2. On the AI evaluations sub-tab, select External AI systems.

  3. Set the Activate toggle to on.

  4. Connect your external AI system to send trace data to AI Control Tower using SDK instrumentation or a trace connection.

Connection method

Description

SDK instrumentation

Use for any third-party AI agent framework (CrewAI, LangChain, AWS Agent Core, and others) not connected through a trace connection. Requires generating an API key and configuring the Traceloop SDK in your agent code.

  1. Generate an API key to authenticate trace data requests from your external AI system.

Note: Multiple API keys can exist, but only one is active at a time.

1.  In the **API key for external AI system evaluation** section, select **Create API key**.

The API Key record page opens on a new browser tab.

2.  On the form, fill in the fields.

Field

Description

Name

Name for the API key.

Description

Purpose of the API key.

User

User associated with this API key.Select a user with the sn_ai_observe.ai_data_sender role. Use a dedicated service account rather than a user with elevated permissions. This role is installed with the AI Control Tower Evaluations plugin and grants permission to send observability data without granting read or write access to AI Control Tower configuration. If the service account does not already have this role, assign it before creating the API key.

Active

Whether the API key is active.

Auth Scope

Scope that controls the API key's authority at runtime.

Expiry

Date when the API key expires. Leave empty for no expiration.

3. Select **Submit**.
4.  Copy the generated token and store it securely.

The token is displayed only once. If you lose it, generate a new key, which deactivates the previous one.

5.  Return to the AI Control Tower browser tab and refresh the page.

The new API key appears in the API key for external AI system evaluation section.

  1. Instrument your AI agent to send trace data to your ServiceNow instance.

For instrumentation steps using the Traceloop SDK, see Instrument a third-party AI agent with the Traceloop SDK for AI Control Tower Evaluations.

Trace connection

Use when your AI agents run on a supported cloud platform or already send traces to a supported monitoring service. The ServiceNow AI Platform collects trace data through your cloud credentials and a MID Server. No API key or SDK instrumentation is required.

See Configuring trace connections.

## Result

Evaluation scoring is active for external AI systems. Scores appear on the monitoring Overview page as new sessions are evaluated.

What to do next

To add or remove global metrics and adjust their sample rate, see Configure global metrics for external AI systems.

Parent Topic:Configure evaluation scoring for external AI systems

Related topics

Configure global metrics for external AI systems

Configure asset-specific metrics for external AI systems

Exclude external AI systems from a metric

Keywords ServiceNow OttoAI Agentsgenerative AIagentic AI
Search documentation
Search document titles and file paths on the australia branch