Criar orçamento
create_budgetCria um orçamento (limite planejado) por categoria e período. name e type são obrigatórios no banco e não têm default — omiti-los grava valores vazios e quebra o cruzamento com transações feito por budget_comparison (que casa Transaction.type = Budget.type). Efeito colateral: recalcula analytics (cashflow/networth) e insights do usuário. Diferente de create_goal (meta de acúmulo) e create_debt (dívida a pagar).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"type": "<type>",
"amount": "<amount>",
"year": "<year>"
},
"name": "create_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Nome do orçamento (ex: 'Mercado de Janeiro') | |
| type | Yes | Tipo — precisa bater com o Transaction.type das transações que devem contar para este orçamento | |
| year | Yes | Ano do período (ex: 2026) | |
| month | No | Mês (1-12), obrigatório apenas quando period = MONTHLY | |
| amount | Yes | Valor orçado/limite do período | |
| period | No | Periodicidade. Sem default no banco: se omitido, o orçamento não casa com a regra MONTHLY em budget_comparison/budget_daily e acaba tratado como anual — prefira sempre informar | |
| category | No | Nome da categoria a limitar (deve bater com Transaction.category). Omitido ou 'ALL' = todas as categorias desse type | |
| currency | No | Moeda (ISO 4217). Default: BRL |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| name | No | ||
| type | No | ||
| year | No | ||
| month | No | ||
| amount | No | ||
| period | No | ||
| userId | No | ||
| category | No | ||
| currency | No | ||
| createdAt | No | ||
| updatedAt | No |