---
sourceDocument: Brazil Enable AI
sourceDocumentLink: https://www.servicenow.com/docs/r/intelligent-experiences

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Enable AI

ft:clusterId :

    - platai

bundleId :

    - platai

workflow :

    - Platform


---

# Troubleshoot external AI agents

# Troubleshoot external AI agents {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Use this troubleshooting guide to resolve issues with External AI agents' roles, testing procedures, failure diagnosis and reference resources.

## Prerequisites for External AI agents {#troubleshoot-external-ai-agents__section_znt_2cs_5kc}

The following plugins, versions, and roles are apply for external AI agents:

* Application version: ServiceNow Otto AI Agents v6.0.x+.
* Platform version: Zurich Patch 4+ or Yokohama Patch 11+.
* Enable external agent interoperability (AI Agent Studio → Settings):
  * Set the sn_aia.external_agents.enabled to true (ServiceNow can call external agents).
  * Set the sn_aia.internal_agents.enabled_external system property to true (External agents can call ServiceNow AI Agents).
  {#troubleshoot-external-ai-agents__ul_z21_wcs_5kc}
* Service account \& roles for inbound A2A calls: sn_aia.integration (runtime) or sn_aia_admin (testing), plus rest_service and snc_platform_rest_api_access.
* AI Agent activation \& discoverability: Ensure the agent is active and enable the AI agent for discovery (sets External discoverable on sn_aia_agent_config).
{#troubleshoot-external-ai-agents__ul_jkj_kcs_5kc}

## Autonomous mode {#troubleshoot-external-ai-agents__section_f5h_sns_5kc}

You must enable the autonomous mode for executing External AI agents. Using the Supervised execution mode runs with human interaction or intervention as opposed to an agent interaction and needs the autonomous mode to be set
up. For more information, see [Add tools and information to an AI agent](https://www.servicenow.com/docs/4zuFIUomTGbD7imZq8ovlQ "Add a tool to an AI agent to enable different functionalities and help your AI agents achieve their objectives.").

The asynchronous mode is not supported for external AI agents in AI Agent Studio. Change the communication mode to the Synchronous mode while onboarding the external agents and enable push notifications.

## Review logs for external agents {#troubleshoot-external-ai-agents__a2a}

You can retrieve tool logs using the sn_aia_external_agent_exec_history table and to access the full conversation history via the task/get method, enable the Display output in tool settings.

## Additional resources {#troubleshoot-external-ai-agents__section_dch_tns_5kc}

Use the following documentation resources for more information:

* Enable MCP and A2A protocol: [Enable MCP and A2A for your agentic workflows](https://www.servicenow.com/community/servicenow-otto-articles/enable-mcp-and-a2a-for-your-agentic-workflows-with-faqs-updated/ta-p/3373907).
* [AI Agents and 3rd-party integrations](https://www.servicenow.com/community/servicenow-otto-articles/ai-agents-and-3rd-party-integrations/ta-p/3316286).
* [Setting up A2A authentication for ServiceNow AI agents](https://www.servicenow.com/docs/Os1zJfFmkXj1kWsARh2uRA "Configure ServiceNow AI agents as secondary agents over the Agent2Agent (A2A) protocol by setting up authentication and enabling external agent interoperability.")
* [Sample payloads for A2A - ServiceNow as secondary Agent](https://www.servicenow.com/community/servicenow-otto-articles/sample-payloads-for-google-a2a-servicenow-as-secondary-agent/ta-p/3451904)
* [AI Agents FAQ and Troubleshooting](https://www.servicenow.com/community/servicenow-otto-articles/ai-agents-faq-and-troubleshooting/ta-p/3200454)
* [Troubleshooting AI Agents](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB2419769)
* [External AI agents in ServiceNow via A2A - ServiceNow as primary agent](https://www.servicenow.com/community/servicenow-otto-articles/external-agents-in-servicenow-via-google-a2a-servicenow-as/ta-p/3467587)
* [AI skill support in MCP Server Console](https://www.servicenow.com/docs/vQo~4Dt5ZecupMHbzbOWLQ "MCP Server Console supports creating tools for Model Context Protocol (MCP) servers from a subset of AI skills.")
* [Troubleshooting RaptorDB](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1513425)
{#troubleshoot-external-ai-agents__ul_ctb_vns_5kc}