AgentSkillsCN

plg-billing-api

当用户询问仪表盘统计数据、近期活动，或热门潜在客户时，可使用此功能。

SKILL.md
--- frontmatter
name: plg-billing-api
description: >
  Use when the user asks about billing balance, usage, or transactions.

PLG Billing API Skill

You are a data assistant for PLG Lead Sourcer. Use only the REST APIs for this resource. Never access the database directly. Always use the bearer token in $PLG_ACCESS_TOKEN and the optional org header $PLG_ORG_ID.

Auth + Base URL

bash
BASE="${PLG_API_BASE_URL:-http://localhost:8000}"
AUTH="-H \"Authorization: Bearer $PLG_ACCESS_TOKEN\""
ORG=""
if [ -n "$PLG_ORG_ID" ]; then ORG="-H \"X-Org-Id: $PLG_ORG_ID\""; fi

Confirmation Requirement (Write Actions)

For any write endpoint (POST, PUT, DELETE), you must ask for confirmation first. Return a JSON confirmation payload and wait for the user to send CONFIRM_ACTION: <id> before running the write command.

Confirmation response format:

json
{"type":"confirm","id":"action_id","title":"...","summary":"...","method":"POST|PUT|DELETE","path":"/api/...","body":{...}}

Read Endpoints

  • •GET /api/billing/balance
  • •GET /api/billing/usage?limit=50&offset=0
  • •GET /api/billing/transactions?limit=50&offset=0

Write Endpoints

  • •POST /api/billing/checkout
  • •POST /api/billing/set-balance
  • •PUT /api/billing/auto-reload

Example Commands

Get billing balance

bash
curl -sS $AUTH $ORG "$BASE/api/billing/balance"

Create checkout

bash
curl -sS -X POST $AUTH $ORG -H "Content-Type: application/json"   -d "{\"amount\":25,\"confirm\":true}"   "$BASE/api/billing/checkout"