{"id":"get_credit_usage","name":"Credit Consumption","alias":"CreditConsumption","aliases":[],"description_short":"Report how much of this project's agent credit allowance is used, daily and monthly.","description_long":"\n    Report how far through its agent credit allowance the project is, over both\n    windows that carry one: the day and the calendar month.\n\n    The allowance is a project-wide pool shared by every member, not a personal\n    one, and passing it warns rather than blocks: calls keep being served up to a\n    higher ceiling. Reading consumption through this agent is itself free and\n    consumes no credits.\n    ","description_tool_prompt":"Report how much of its Botify agent credit allowance the current project has consumed, both for today and for the current calendar month, as a percentage per window with that window's status and reset time. Use when the user asks how much of their allowance or envelope they have used, how many credits they have left, when their credits reset, or whether they are close to or over their limit. Answers in percentages only: the number of credits used, left, or allowed is not reported and must not be inferred or estimated from the percentage. This agent is free and consumes no credits.","source":"Botify","conversation_examples":["How many Botify credits do we have left this month?","How much of our credit allowance have we used today?","Are we close to our agent credit limit?","When do our credits reset?"],"tags":[],"available_in_chat":true,"available_in_deepthink":true,"available_in_mcp":true,"mcp_audience":"all","config":{"type":"object","properties":{},"required":[]},"item":{"type":"object","properties":{},"required":[]},"response":{"$defs":{"CreditWindow":{"description":"How far through its allowance one window is, and where that stands.","properties":{"usage_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Share of the window's allowance that has been consumed, above 100 once the allowance is passed. Null when there is no allowance to take a share of -- not a statement that calls are blocked","title":"Usage Percent"},"status":{"description":"Where this window's consumption stands, and the only field that says whether calls are still being served: they are refused on ``blocked`` alone","enum":["healthy","warning","over","blocked"],"title":"Status","type":"string"},"resets_at":{"description":"When the window rolls over and consumption returns to 0","format":"date-time","title":"Resets At","type":"string"}},"required":["usage_percent","status","resets_at"],"title":"CreditWindow","type":"object"}},"properties":{"credit_status":{"description":"Where the project stands overall: the worse of the daily and the monthly credit status","enum":["healthy","warning","over","blocked"],"title":"Credit Status","type":"string"},"daily":{"$ref":"#/$defs/CreditWindow","description":"Information about the daily allowance usage"},"monthly":{"$ref":"#/$defs/CreditWindow","description":"Information about the monthly allowance usage"},"summary":{"description":"A paragraph summarizing where usage sits expressed in natural language","title":"Summary","type":"string"}},"required":["credit_status","daily","monthly","summary"],"title":"GetCreditUsageProcessedItem","type":"object"},"has_canvas":false,"open_canvas_automatically":false}