Erreurs

Une erreur revient comme un résultat d’outil marqué isError, avec un message qui dit quoi corriger, pour que l’agent puisse rectifier son appel. Les éléments entre accolades représentent la valeur transmise.

Venant de YNAB

Tout outil qui appelle YNAB peut renvoyer l’erreur de YNAB : Error calling tool '<tool>': YNAB <status>: <detail> — par exemple YNAB 401 pour un jeton faux ou révoqué, YNAB 429 quand les 200 requêtes par heure sont épuisées. Sans YNAB_API_KEY, le serveur refuse d’appeler YNAB : 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.
• 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.
• 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.
• 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.
• 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.

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.
• 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.