Skip to main content

​
What is an Agent Secret?

An Agent Secret is a credential used to authenticate your agent instance with the Value Control Plane. It identifies which agent instance is sending events.

​
Getting Your Agent Secret

  1. Log in to the Value Control Plane
  2. Navigate to Agents → Select an agent type → Instances
  3. Create or select an instance
  4. Copy the Secret (shown only once on creation)
Agent secrets are sensitive credentials. Store them securely and never commit them to version control.

​
Using Agent Secrets

Pass the agent secret directly when initializing the client: 
from value import initialize_sync

client = initialize_sync(agent_secret="secret_abc123xyz")
Or with the async client: 
from value import initialize_async

client = await initialize_async(agent_secret="secret_abc123xyz")

​
Secret Rotation

To rotate an agent secret:
  1. Navigate to the agent instance in the Control Plane
  2. Click Refresh Secret
  3. Copy the new secret
  4. Update your environment with the new secret
The old secret is immediately invalidated. Plan your deployment to minimize downtime.

​
What the Secret Provides

When you initialize the SDK with a secret, it automatically:
  • Authenticates with the Control Plane
  • Retrieves agent metadata (ID, name, workspace, organization)
  • Configures OpenTelemetry with correct resource attributes