QUICKSTART

Live in 4 steps.
// from zero to a streaming trace.

AgentScope is OpenTelemetry under the hood, so any HTTP-capable agent can ship spans. Below: the smallest path for ElizaOS, Solana Agent Kit, and a one-shot curl.

Open dashboard → Read the steps

01

Register your agent

Sign in to the dashboard, click Register agent, and fill in name + wallet pubkey. You'll get a per-agent ingest token on the detail page — copy it, keep it server-side.

Free tier caps at 2 agents per account during the public beta.

Open dashboard →

Install the SDK

Pick the package that matches your stack. Both ship under @agentscopehq/* on npm — pinned to @alpha until 1.0.

shell npm registry

# ElizaOS agents
$ pnpm add @agentscopehq/elizaos-plugin@alpha

# Solana Agent Kit (or any async TypeScript)
$ pnpm add @agentscopehq/agent-kit-sdk@alpha

Instrument your agent

One init call at boot, then wrap each action. Nested traced() calls auto-parent into a tree.

src/agent/index.ts @agentscopehq/elizaos-plugin

import { initAgentScope, wrapActions } from '@agentscopehq/elizaos-plugin';

const sdk = initAgentScope(({
  apiUrl: process.env.AGENTSCOPE_API_URL!,
  agentToken: process.env.AGENTSCOPE_TOKEN!,
});

export const myPlugin = {
  name: 'my-trading-plugin',
  actions: wrapActions([tradeAction, analyzeAction]),
};

process.on('SIGTERM', () => sdk.shutdown());

src/agent/index.ts @agentscopehq/agent-kit-sdk

import { initAgentScope, traced } from '@agentscopehq/agent-kit-sdk';

initAgentScope(({
  apiUrl: process.env.AGENTSCOPE_API_URL!,
  agentToken: process.env.AGENTSCOPE_TOKEN!,
});

// Wrap any async action — nested traced() calls auto-parent.
const sig = await traced('execute_trade', () => kit.trade(mint, amount, 'buy'), {
  'solana.mint': mint,
  'trade.amount_sol': amount,
});

POST /v1/traces OTLP/HTTP · JSON

$ curl -X POST $AGENTSCOPE_API_URL/v1/traces \
  -H "Content-Type: application/json" \
  -d '{
    "resourceSpans": [{
      "resource": {
        "attributes": [
          { "key": "agent.token", "value": { "stringValue": "$AGENTSCOPE_TOKEN" } }
        ]
      },
      "scopeSpans": [{
        "spans": [{
          "traceId": "5b8aa5a2d2c872e8321cf37308d69df2",
          "spanId":  "051581bf3cb55c13",
          "name":    "execute_trade",
          "startTimeUnixNano": "1700000000000000000",
          "endTimeUnixNano":   "1700000001000000000"
        }]
      }]
    }]
  }'

Works from any language. agent.token rides as an OTel resource attribute, not an HTTP header — survives proxy hops.

04
See traces in the dashboard

Boot your agent. Within seconds you'll see spans land in the Reasoning view, on-chain transactions parsed and timestamped under Transactions, and any rule breaches piped to Telegram.
- ✓ Reasoning tree with parent/child spans, durations, errors
- ✓ Tx ↔ span correlation via solana.tx.signature
- ✓ 5 anomaly rules out of the box: gas, slippage, drawdown, failure rate, idle wallet
Open dashboard →

Register your agent

Install the SDK

Instrument your agent

See traces in the dashboard