Troubleshoot managing deployed agents

This document describes how to resolve errors that you might encounter when managing deployed agents.

Error when filtering the list of agents

Issue:

You receive an error message similar to the following:

InvalidArgument: 400 Provided filter is not valid.

Possible cause:

Your filter isn't formatted properly.

Recommended solution:

Update the formatting of your filter so it's formatted correctly. For example, you might be using the following to filter by display name. This filter isn't formatted correctly because it's missing quotation marks:

fromvertexaiimport agent_engines
agent_engines.list (filter=f'display_name={DISPLAY_NAME}')

In this case, enclose {DISPLAY_NAME} in double-quotation marks:

fromvertexaiimport agent_engines
agent_engines.list (filter=f'display_name="{DISPLAY_NAME}"')

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年10月16日 UTC.