Skip to main content

Refresh agent sources

Use Refresh sources to make an agent pull the latest changes from the repositories you configured in AGENT_REPO.
This is helpful after you push updates (new scopes, handlers, config, etc.) and want the agent to use them—without reinstalling or redeploying.

ℹ️ This action does not reinstall or upgrade the agent binary or Helm chart. To change the agent version or flags, upgrade your Helm release or rerun the installer.

How to pull from the UI​

  1. Go to Platform settings > Agents.
  2. Find the agent to update.
  3. Open its menu and click Refresh sources.

The agent pulls the latest from your configured repository (or repositories) and reloads its sources.

agent-refresh-ui

When to use it​

  • You pushed changes to the branch in AGENT_REPO and want the agent to use them.
  • You added/removed repositories in a comma-separated AGENT_REPO value.
  • You changed repo-backed configuration the agent reads at runtime.

What it does (and doesn’t)​

It does:

  • Pull the latest from each repo/branch listed in AGENT_REPO.
  • Reload sources the agent reads from those repos (e.g., scopes/handlers/config).

It doesn’t:

  • Change runtime flags or environment variables (e.g., TAGS, NP_API_KEY).
  • Upgrade the agent binary or Helm chart.
  • Create/modify permissions or API keys.

📖 To change the agent version or flags, upgrade your Helm release or reinstall the agent. See Install the agent docs.

Tips and troubleshooting​

  • Ensure changes are pushed: Refresh pulls from the remote branch (...repo.git#branch), not local work.
  • Multiple repos: Use comma-separated URLs (no spaces) in AGENT_REPO.
  • Private repos: If your URL embeds a token, verify it’s valid and not expired.
  • Heartbeat and logs: Confirm the agent shows a recent Last heartbeat and check logs if updates don’t appear.