Actions8
filled by AI
AI-generatedSummary
Lets an AI agent choose the analytics operation at runtime ("filled by AI", default usageSummary), with a Period (24h, 7d, 30d, 90d) applied to budget status, usage summary, daily costs, and cost-by-model queries against Alephant analytics.
Inputs
- period — Time window for the budget, usage, daily-cost, and cost-by-model operations. Options: 24h, 7d, 30d, 90d. Default 7d. Sent as the
periodquery parameter. The "filled by AI" option resolves to 7d when set statically; in tool mode the model supplies it.
Output shape
One item per input item whose json is the raw Alephant API response for the chosen operation. In AI tool mode the same response is returned to the agent as a JSON string.
Uses a GET request to the Alephant SaaS cockpit endpoints (budget-status, usage-summary, daily-costs, cost-by-model), authenticated with the virtual key credential. Transient network errors are retried once. Failures raise a NodeApiError. The Period only affects those four operations. Other operations (scope, recentRequests, requestLogDetail) ignore it.
Examples
Example 1: An AI agent answers "how much did we spend on each model this month?"
Connect the node to an AI Agent as a tool. The model selects operation costByModel and period 30d.
Example 2: Weekly usage report in a regular workflow
Operation: Usage Summary, Period: 7 Days, with Alephant virtual key credentials.