Fehler

Ein Fehler kommt als Tool-Ergebnis mit isError zurück, mit einer Meldung, die sagt, was zu korrigieren ist, damit der Agent seinen Aufruf berichtigen kann. Teile in geschweiften Klammern stehen für den übergebenen Wert.

Von YNAB

Jedes Tool, das YNAB aufruft, kann den Fehler von YNAB zurückgeben: Error calling tool '<tool>': YNAB <status>: <detail> — zum Beispiel YNAB 401 für ein falsches oder widerrufenes Token, YNAB 429, wenn die 200 Anfragen pro Stunde aufgebraucht sind. Ohne YNAB_API_KEY weigert sich der Server, YNAB aufzurufen: YNAB_API_KEY environment variable is not set.

find_transactions

• Account {0} is not in this plan: use an id from list_accounts.
• Category {0} is not in this plan: use a category_id from get_category_balances.
• until_date {until} is before since_date {since}: swap them.
• The dates span more than 366 days: search a shorter period.

forecast_balance

• Unknown account(s) {unknown}: use ids from list_accounts.
• until must be the current month or later.
• until must be at most 24 months ahead.
• until must be a month as YYYY-MM, got '{until}'.

get_budget_vs_actual

• month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.

get_category_balances

• month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.

get_monthly_summary

• month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.

list_scheduled_transactions

• Account {0} is not in this plan: use an id from list_accounts.
• Category {0} is not in this plan: use a category_id from get_category_balances.
• until_date {until} is before since_date {since}: swap them.
• The dates span more than 366 days: search a shorter period.

suggest_categories

• Invalid cursor: pass the next_cursor value from the previous page unchanged, or omit it to start from the first page.

apply_categories

• Transaction {tx_id} is assigned twice: keep one assignment.
• Transaction {tx_id} is not in this plan: use the transaction_id values returned by suggest_categories.
• Transaction {tx_id} is split across categories: change its lines in YNAB.
• Transaction {tx_id} is on an off-budget account: YNAB gives it no category.
• Transaction {tx_id} is a transfer between accounts: YNAB gives it no category.
• Category {category_id} is YNAB's internal Uncategorized: choose a real category.
• Category {category_id} is not in this plan: use a category_id from the categories returned by suggest_categories.
• Category {category_id} pays a credit card: YNAB ignores it on a transaction. Choose the category of what was paid for.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

create_category

• Group {category_group_id} is not in this plan: use an id from list_category_groups.
• The name is empty: give the new category a name.
• '{new_name}' already exists in {group}.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

create_transactions

• Account {account_id} is not in this plan: use an id from list_accounts.
• Give at least one transaction to create.
• {date} is in the future: YNAB only records transactions that happened.
• Category {category} is not in this plan: use a category_id from get_category_balances.
• Category {category} pays a credit card: YNAB ignores it on a transaction. Choose the category of what was paid for.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

flag_transactions

• Give at least one flag.
• Transaction {twice} is named twice: give one flag each.
• Transaction {unknown} is not in this plan: use a transaction_id from find_transactions.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

move_money

• Give two different categories: money moves from one to another.
• Category {category_id} is not in this plan: use a category_id from get_category_balances.
• month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.
• {refused}; {name} is back to {from_amount}: nothing was moved.
• {refused}, then putting {name} back failed too ({again}): set {name} back to {from_amount} in YNAB.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

reconcile_account

• Account {account_id} is not in this plan: use an id from list_accounts.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

set_category_budget

• Category {category_id} is not in this plan: use a category_id from get_category_balances.
• month must be 'current' or the first day of a month as YYYY-MM-01, got '{month}'.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

set_category_target

• Category {category_id} is not in this plan: use a category_id from get_category_balances or list_category_groups.
• Give either a date or a frequency, not both: YNAB refuses the two.
• To remove the target, give no amount, no date and no frequency.
• The amount must be greater than 0; to remove the target, give none.
• YNAB takes neither a date nor a frequency on a category paired to a loan account: give an amount alone.
• YNAB takes no frequency on a credit card payment category: give an amount alone, or a date.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

split_transaction

• Transaction {transaction_id} is not in this plan: use a transaction_id returned by suggest_categories.
• Transaction {tx_id} was deleted in YNAB: there is nothing to split.
• Transaction {tx_id} is already split: YNAB's API cannot change its lines, change them in YNAB.
• Transaction {tx_id} is a transfer between accounts: it cannot be split.
• Transaction {tx_id} is on an off-budget account: YNAB does not split those.
• Give at least two lines: to give the whole transaction one category, use apply_categories.
• The lines add up to {total}, the transaction is {amount}: they must match to the cent.
• A line is zero: leave it out.
• Category {category_id} is YNAB's internal Uncategorized: choose a real category.
• Category {category_id} is not in this plan: use a category_id from suggest_categories or get_category_balances.
• Category {category_id} pays a credit card: YNAB ignores it on a transaction. Choose the category of what was paid for.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

undo_operation

• Nothing to undo: no operation of this plan is still in effect with id {operation_id}.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.

update_category

• Category {category_id} is not in this plan: use a category_id from suggest_categories.
• Group {category_group_id} is not in this plan: use an id from list_category_groups.
• The new name is empty: give a name, or omit it to keep the current one.
• This client cannot ask the user to confirm, and AVENIR_MCP_REQUIRE_ELICITATION=1 forbids confirmation codes: nothing was changed. Use a client that supports MCP elicitation, or unset the variable.
• This confirmation code is unknown, expired, already used, or was issued for different changes. Call again without confirmation to get a new preview.
• Confirmation codes are disabled (AVENIR_MCP_REQUIRE_ELICITATION=1): call again without confirmation, and the user answers in the client.
• The plan changed between the preview and the answer. Call again without an answer to get a new preview.