Skip to main content
The New Relic toolkit lets agents query telemetry with NRQL, list and inspect monitored entities, and review alert policies, conditions, and open incidents. It uses New Relic’s NerdGraph GraphQL API. Add it on the agent Toolkits tab, configure a User Key and account ID, then reference tools with @ in the personality prompt.

​
Prerequisites

  • A New Relic account with a User Key (personal API key that starts with NRAK-) from API keys
  • Your New Relic Account ID (from the URL or Administration → Access Management)
  • Region: US (default) or EU
  • An agent you can edit
License or ingest keys are not supported — use a User Key.

​
Setup

  1. Open the agent → Toolkits → add New Relic.
  2. Create or select a connection and enter:
    • API key — User Key (NRAK-…)
    • Account ID
    • Region — US or EU
  3. Save, then @-mention New Relic tools in the personality prompt when the agent should investigate metrics or alerts.
  4. Test in Chat with a bounded NRQL query (include SINCE and LIMIT).

​
Available tools

​
Use cases

  • Investigate elevated error rates or latency with a focused NRQL query
  • Find the entity GUID for an application, then pull alert status and relationships
  • Summarize open incidents for an ops standup
  • Explain which alert policy or condition applies to a service

​
Tips

  • Prefer bounded NRQL (SINCE, WHERE, LIMIT) so responses stay readable and fast.
  • Set the account ID on the connection so every tool call does not need it repeated.
  • Use EU region when the New Relic organization is hosted in the EU.
  • Treat User Keys like secrets — do not paste them into prompts, tickets, or screenshots.

​
Troubleshooting