En esta página, se describe cómo administrar el ciclo de vida de una operación de larga duración (LRO) en Vertex AI Agent Builder.
Se muestra un objeto de operación de larga duración cuando una llamada
a un método puede tardar mucho tiempo en completarse. Por ejemplo, la API de Vertex AI Agent Builder crea una operación de larga duración cuando llamas a documents.import
a través de la API o las bibliotecas cliente. La operación realiza un seguimiento del estado del trabajo de procesamiento.
Puedes usar los métodos de operaciones de larga duración que proporciona la API de Vertex AI Agent Builder para Verifica el estado de las operaciones. Tú puede enumerar o sondear operaciones.
El registro de una operación se conserva aproximadamente 30 días después de que esta finaliza, lo que significa que no puedes ver ni enumerar una operación después de ese tiempo.
Obtén detalles sobre una operación de larga duración
A continuación, se muestra cómo obtener detalles sobre una operación.
REST
Para obtener el estado de una operación de larga duración y ver los detalles sobre ella, sigue estos pasos:
Busca el nombre de la operación de una de estas dos maneras:
Después de realizar una llamada a un método que devuelve una solicitud operativa, revisa la respuesta.
Por ejemplo, si llamas a
documents.import
, el principio de la respuesta se ve de la siguiente manera:{ "name": "projects/12345/locations/global/collections/default_collection/dataStores/my-datastore_4321/branches/0/operations/import-documents-56789", "metadata": { "@type": "type.googleapis.com/google.cloud.discoveryengine.v1beta.ImportDocumentsMetadata" } }
El valor
name
en la respuesta proporciona el nombre de la operación, que se puede que se usa para consultar el estado de la operación. No incluyas las citas cuando copia el nombre de la operación.Obtén el nombre de la operación enumerando las operaciones las operaciones.
Llama al método
operations.get
en el recurso que creó la operación:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1beta/OPERATION_NAME"
OPERATION_NAME: Es el nombre de la operación de la operación anterior. paso.
Las primeras líneas de la respuesta del comando
GET
se ven de la siguiente manera:{ "operations": [ { "name": "projects/12345/locations/global/collections/default_collection/dataStores/my-datastore_4321/branches/0/operations/import-documents-56789", "metadata": { "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsMetadata", } } ] }
Python
Para obtener más información, consulta la API de Python de Vertex AI Agent Builder documentación de referencia.
Para autenticarte en Vertex AI Agent Builder, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Enumerar las operaciones de larga duración
A continuación, se muestra cómo enumerar las operaciones de un recurso de Google Cloud.
REST
Para obtener una lista de las operaciones de larga duración de un recurso de Google Cloud, sigue estos pasos:
Llama al método
operations.list
de la siguiente forma:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/operations"
DATA_STORE_ID: Es el ID del almacén de datos de Vertex AI Agent Builder que se creó con tu motor. En la URL de la consola de Google Cloud, el ID del almacén de datos aparece después de
engines/
y antes de/data
.
Python
Para obtener más información, consulta la API de Python de Vertex AI Agent Builder documentación de referencia.
Para autenticarte en Vertex AI Agent Builder, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Sondea una operación de larga duración
A continuación, se muestra cómo sondear el estado de una operación.
REST
Para sondear la operación de larga duración hasta que finalice, sigue estos pasos:
Ejecuta el siguiente comando, que llama al método
operations.get
de forma reiterada, con una retirada de 10 segundos entre cada solicitud:while true; \ do curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://discoveryengine.googleapis.com/v1beta/OPERATION_NAME"; \ sleep 10; \ done
OPERATION_NAME: El nombre de la operación, que se encuentra en Obtén detalles sobre una operación de larga duración. Por ejemplo:
projects/12345/locations/global/collections/default_collection/dataStores/my-datastore_4321/branches/0/operations/import-documents-56789
Detén el trabajo de sondeo (
Control+Z
) después de que el estado muestre"done": true
.
Python
Para obtener más información, consulta la documentación de referencia de la API de Python del compilador de agentes de Vertex AI.
Para autenticarte en Vertex AI Agent Builder, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.