Common issues and solutions in Build Agent

  • Release version: Australia
  • Updated May 7, 2026
  • 4 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Common issues and solutions in Build Agent

    This guide helps ServiceNow customers identify and resolve frequent problems encountered with Build Agent in the Australia release version. It complements the general debugging approach by offering targeted solutions for common Build Agent errors and behaviors, enabling customers to quickly diagnose and fix issues for smoother development workflows.

    Show full answer Show less

    General debugging approach

    • Start by pasting the exact error message into the Build Agent chat; it often can diagnose and fix the problem automatically.
    • If multiple fixes fail, structure your debugging by reproducing the error, reviewing logs, checking access/configuration, and verifying if the issue is known.
    • Test hypotheses progressively from simple (access or role issues) to complex (logic edge cases).
    • If unresolved, start a new chat with a precise prompt and save debugging information for possible Now Support contact.

    Common issues and practical solutions

    • Now Assist panel not visible: Confirm required plugins (snglider, snbuildagent, snnowcreator) and admin role are assigned; refresh or re-login; if unresolved, capture error details and user roles.
    • Build Agent unresponsive: Clear browser cache, try a different browser, and verify ServiceNow service status; capture request and browser details if issue persists.
    • Scope or name conflict: Check if the app scope or name is already used; allow Build Agent to assign a unique scope or select a new name manually; document the conflict if unresolved.
    • Stuck in error loop: Use Git checkpoints or update set rollback to revert changes; begin a new conversation with the specific error and recent commits.
    • App not deploying: Verify build output for errors before deployment; run ServiceNow SDK build and then deploy sequentially; provide build logs and update set status if issues continue.
    • Empty UI page: Check browser console for errors; share console output with Build Agent to troubleshoot UI issues.
    • Context limit exceeded: Start a new chat window and re-describe the application; Build Agent resumes work without previous session context.
    • Out of prompts: Monitor your prompt usage within the 30-day cycle; wait for reset or upgrade to Now Assist for Creator; capture entitlement info if needed.
    • Rate limit error: Occurs when too many requests are sent; wait briefly before retrying; record error and timestamp if persistent.
    • Unsupported configuration: Confirm requested metadata/features are supported; manually complete unsupported steps on the platform, then continue with Build Agent.
    • Missing dependencies (IDE): Check package.json entries; allow Build Agent to self-correct or manually add packages and run npm install; capture missing module and install errors if unresolved.
    • Long-running prompt times out: Verify session timeout settings (glide.ui.sessiontimeout); coordinate with admins before changes; provide session length and prompt details if timeouts persist.

    Key outcomes

    By following this structured troubleshooting guidance and applying the tailored solutions, ServiceNow customers can efficiently resolve Build Agent issues related to access, configuration, deployment, session limits, and more. This ensures smoother development cycles, better application deployment success, and optimized use of Build Agent capabilities.

    Identify and resolve common issues in Build Agent. Use this reference alongside the general debugging approach to identify and fix problems.

    General debugging approach

    When something goes wrong, paste the exact error message into the Build Agent chat. Build Agent can often diagnose and fix the issue directly. If not, the error message is your starting point for debugging.

    If you attempt several fixes in the same conversation without progress, use a structured approach before starting a new chat.

    Tip:

    Use the following prompt to structure your debugging session:

    I'm seeing this error: [paste exact error]. This happens when: [describe scenario]. Before suggesting fixes: 1) Help me reproduce this consistently. 2) Review the debugger output and logs. 3) Check for access or configuration issues. 4) Examine if this is a known issue.

    Then test hypotheses from simplest to most complex:

    • Is this an access or role issue?
    • Is this a configuration problem?
    • Is this a naming convention mismatch?
    • Is this a logic edge case?

    If structured investigation does not resolve the issue within a few attempts, start a fresh conversation with a more specific prompt.

    Save any debugging information to convey if you need to contact Now Support.

    Issues and solutions

    Table 1. Troubleshooting Build Agent issues
    Issue Resolution
    Now Assist panel not visible
    • Quick check: Required plugins are installed and your user has the right roles. The ServiceNow IDE needs the admin role plus the documented Build Agent plugins (sn_glider and sn_build_agent for Trial; sn_now_creator for Paid). In ServiceNow Studio, confirm you're on a supported release.
    • Try: Refresh the page or sign out and back in.
    • If still failing, capture: The exact error or behavior, your release, and the role list on your user.
    Build Agent unresponsive
    • Quick check: Browser cache and the active session.
    • Try: Clear the cache, try a different browser, and check the ServiceNow status page for service announcements.
    • If still failing, capture: The request that hung, your browser version, and the ServiceNow status state.
    Scope or name conflict
    • Quick check: Whether the scope or app name is already in use on the instance.
    • Try: Let Build Agent self-correct with a unique scope, or pick a new name and try again.
    • If still failing, capture: The conflicting scope or app name and the action that triggered it.
    Stuck in error loop
    • Quick check: How many fixes Build Agent has attempted on the same symptom.
    • Try: Use Git checkpoints or update set rollback to revert, then start a fresh conversation that names the specific error.
    • If still failing, capture: The exact error text, recent commits, and a brief description of what you were trying to accomplish.
    App not deploying
    • Quick check: Build output for errors before deploying. Build Agent only deploys the latest successful build. If your updates are not available after deployment, the build may have failed even though the deployment succeeded.
    • Try: In the ServiceNow IDE, run ServiceNow SDK build first, check errors, then deploy and install in sequence. In ServiceNow Studio, confirm your update set is current and complete. Paste any error messages into the chat panel and ask Build Agent to resolve the build issues and redeploy. For more information, see Deploying what you built with Build Agent.
    • If still failing, capture: The build log, your SDK version, and your update set state.
    Empty UI page
    • Quick check: The browser console for errors.
    • Try: Open the browser console, copy the error messages, paste them into the chat panel, and ask Build Agent to fix the UI page.
    • If still failing, capture: The full browser console output and the prompt that produced the empty page.
    Context limit exceeded
    • Quick check: Whether you have received a Context Window Exceeded error. Build Agent maintains a history of your session and can resume from the point of failure, but has a context limit.
    • Try: Open a new chat window and describe the application again. Build Agent does not retain context from the previous session, but it reviews the work already done and continues from where it stopped.
    • If still failing, capture: The last prompt before the error and a summary of what had been built.
    Out of prompts
    • Quick check: Your remaining prompt count for the current 30-day cycle.
    • Try: Wait for the cycle to reset, or upgrade to Now Assist for Creator. Plan approvals do not count against your prompt allotment; only submitted prompts do.
    • If still failing, capture: Your entitlement state and the cycle reset date.
    Rate limit error
    • Quick check: Whether the model provider is receiving too many requests.
    • Try: Wait a minute or two before trying again.
    • If still failing, capture: The exact error message and the time it occurred.
    Unsupported configuration
    • Quick check: Whether the requested metadata or feature is in the supported list.
    • Try: Complete that step directly on the platform, then continue with Build Agent for everything else.
    • If still failing, capture: The configuration you needed and the workaround you used.
    Missing dependencies (IDE)
    • Quick check: package.json for the entries Build Agent referenced.
    • Try: Let Build Agent self-correct first. If that does not resolve it, add the package manually and run npm install.
    • If still failing, capture: The missing module name and the install error output.
    Long-running prompt times out
    • Quick check: Your session timeout setting.
    • Try: For labs and workshops, set glide.ui.session_timeout to 1440 in sys_properties. Coordinate with the platform admin on a shared instance before changing it.
    • If still failing, capture: The session length and the prompt that timed out.