AI Agent Cost Sentinel

Ingest logs/datasets, estimate LLM/tool cost, anomaly detection, budget alerts, run summaries.

What this Actor does

• Runs the exact ai-agent-cost-sentinel contract against only the inputs and sources documented below.
• Emits records that are validated against the bundled dataset schema before they are written.
• Keeps source references and stable record identifiers in the output when those fields are declared.
• Provides a bounded sample path for Store inspection; the sample path does not emit a paid event.

Inputs

• searchKeywords: Buyer-relevant keywords used to focus the records returned by this product.
• taskIntent: Stable product-specific purpose for this saved Apify task.
• sourceMode: Sample emits public-safe Marketplace Listing Signal rows. Approved live source mode keeps the same output fields and only uses owner-approved public URLs.
• outputMode: Use sample records for Apify Store QA or buyer-ready records for approved Marketplace Listing Signal delivery.
• startUrls: Public URLs to use for live Marketplace Listing Signal extraction after source-policy approval. Leave empty for sample mode.
• maxItems: Caps the number of Marketplace Listing Signal rows written to the dataset.
• perSourceLimit: Caps validated rows from any one source before cross-source deduplication.
• maxTotalChargeUsd: Buyer-selected spend ceiling; the Apify run-level maximum remains authoritative.
• overallTimeoutSecs: Stops additional source work once the bounded run deadline is reached.
• requestTimeoutSecs: Timeout applied independently to each approved source request.
• maxRequestRetries: Bounded retry count for transient source failures.
• sinceLastRun: Uses stable Actor state to skip logical records delivered by earlier runs.
• deltaMode: Preserves stable deduplication keys for recurring tasks and schedules.

Sources and access boundary

• User-supplied public or authorized source URLs provided through startUrls; live mode fails closed when neither an approved fallback nor a supplied URL exists.

Only public or user-authorized inputs may be processed. The Actor does not bypass authentication, paywalls, CAPTCHAs, access controls, or source terms.

Output

The default dataset exposes these Actor-relevant fields:

• listingName: Seller, listing, or app name.
• listingUrl: Public listing URL.
• signalType: Marketplace intelligence signal category.
• impactSummary: Buyer-facing impact summary.
• priorityActions: Recommended actions for the buyer.
• recordId: Record Id value.
• sourceName: Source Name value.
• sourceUrl: Source Url value.
• retrievedAt: Retrieved At value.
• confidence: Normalized signal confidence.
• errors: Errors value.
• runSummary: Run Summary value.

The output link exposed by .actor/OUTPUT_SCHEMA.json points to the default dataset: {{links.apiDefaultDatasetUrl}}/items.

Sample run

{
  "searchKeywords": [
    "source-backed signal",
    "buyer fit"
  ],
  "taskIntent": "buyer-ready-product-run",
  "sourceMode": "sample",
  "outputMode": "sample-records",
  "startUrls": [],
  "maxItems": 1,
  "perSourceLimit": 25,
  "maxTotalChargeUsd": 5,
  "overallTimeoutSecs": 900,
  "requestTimeoutSecs": 30,
  "maxRequestRetries": 2,
  "sinceLastRun": false,
  "deltaMode": true
}

Example fields from the bundled deterministic sample:

{
  "listingName": "AI Agent Cost Sentinel sample",
  "listingUrl": "https://apify.com/zentrafoundry/ai-agent-cost-sentinel",
  "signalType": "sample",
  "impactSummary": "Sample impact summary for AI Agent Cost Sentinel.",
  "priorityActions": [
    "Sample priority action for AI Agent Cost Sentinel."
  ],
  "recordId": "ai-agent-cost-sentinel-sample-1",
  "sourceName": "AI Agent Cost Sentinel",
  "sourceUrl": "https://apify.com/zentrafoundry/ai-agent-cost-sentinel",
  "retrievedAt": "2026-01-15T09:00:00Z",
  "confidence": 0.9,
  "errors": [],
  "runSummary": {}
}

Sample values are labeled as sample data and are not claims about a live source result.

Pricing and cost control

This source package preserves the Actor's current Apify pay-per-event configuration. The authenticated current event definitions are:

• result-delivered: Charged once for each buyer-ready result written to the dataset.

The per-result source event is result-delivered. Production output uses Apify's charged dataset push path and checks the returned charge limit before continuing. Sample, demo, test, and quality-validation paths do not emit a paid event. Start production runs with a small maxItems and an Apify run spending limit.

Reliability and limitations

• Live results depend on the supplied source availability and the fields the source actually returns.
• Missing values remain missing, null, or warning-backed according to the schema; they are not invented.
• A live run that cannot produce a schema-valid result fails instead of publishing a generic substitute.
• Output is decision-support data and does not replace legal, financial, medical, safety, procurement, or compliance review.

Existing public Actor identity

• Owner: zentrafoundry
• Actor ID: 35ZBIthVBs4oZTgzD
• Slug: ai-agent-cost-sentinel
• Store URL: https://apify.com/zentrafoundry/ai-agent-cost-sentinel

This package updates that exact existing public Actor in place. It does not create, clone, upsert, duplicate, draft, privatize, or change pricing or visibility.