Plaid debug item
Diagnose a Plaid item by retrieving its state information. This tool provides comprehensive information about why an item may not be working properly. <when_to_use> Use this tool when you need to diagnose why an item is not functioning as expected </when_to_use> <description> In the response, you will see the following information: 1. Item State: - "Never extracted": no extraction has been attempted for this item yet - "Successful": The most recent extraction was successful - "Retrying": The most recent extraction encountered a temporary issue and is being retried - "Needs user attention": The item requires user input and client access is not permitted - "Needs user attention (with access)": The item requires user input but client access is permitted 2. Item Consent State: - Boolean indicating whether the item has active user consent - If an item is not consented, it cannot perform extractions or updates 3. Item Deleted At: - If set to a non-zero value, indicates when the item was deleted - Deleted items cannot retrieve data, and cannot be patched as it is requested by the end users - If the item is not deleted yet, the response will be "not available" 4. Known Issues: - Includes description and status of any known issues affecting the item - May provide insights into ongoing problems with the connection When diagnosing an item, follow this sequence: - First, check if the item is deleted. If yes, the item cannot work properly. - Second, if the item is not deleted but lacks active consent, it cannot function properly. - Third, if the item is not deleted: * Check item state. If it indicates the item needs user attention, the item requires manual intervention. * Note any known issues as supplementary information, though these are usually not the primary cause of problems. - If all diagnostics look normal but the user still reports issues, advise them to contact Plaid support. </description> <important> - If an item is deleted, it is not working properly. It is not patchable, you should suggest the user to create a new item. - If an item is missing active consent, it is not working properly. You should suggest the user to use Update Mode to reauthorize the item. - If an item state indicates it needs user attention, the user should use Update Mode to reauthorize the item. - If running into error "the item does not belong to the team", it means the item is not associated with the team. You must inform the user that the item does not belong to their selected team. You may ask if they would like to try other teams associated with their account, but do not automatically attempt other teams. - If an item cannot be found, it's possible the item is not in the Production environment. When explaining the error, inform the user that this is a possible reason for the error. </important>