Administra la aplicación implementada

Operaciones básicas

Puedes mostrar una lista de instancias de ReasoningEngine, obtener una de ReasoningEngine o borrar una instancia de ReasoningEngine.

Mostrar lista de instancias ReasoningEngine

SDK de Vertex AI para Python

Con este comando, se enumeran todas las instancias de ReasoningEngine de un proyecto y ubicación determinados:

reasoning_engines.ReasoningEngine.list()

Con el siguiente código, se filtra la lista de instancias ReasoningEngine por display_name:

reasoning_engines.ReasoningEngine.list(filter='display_name="DISPLAY_NAME"')

Por ejemplo:

reasoning_engines.ReasoningEngine.list(filter='display_name="Demo Langchain Application"')

REST

Ejecuta el siguiente comando curl para enumerar todas las instancias de ReasoningEngine para un proyecto y una ubicación determinados:

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines

Obtén una instancia de ReasoningEngine

Cada instancia de ReasoningEngine tiene un RESOURCE_ID único identificador. Para obtener más información, consulta Implementa la aplicación.

SDK de Vertex AI para Python

El siguiente código te permite obtener un recurso ReasoningEngine específico:

remote_app = reasoning_engines.ReasoningEngine("RESOURCE_ID")

De forma alternativa, puedes proporcionar el nombre completo del recurso:

remote_app = reasoning_engines.ReasoningEngine(
"projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID"
)

REST

Ejecuta el siguiente comando de curl para obtener un recurso ReasoningEngine específico:

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID

Actualiza una instancia de ReasoningEngine

SDK de Vertex AI para Python

El siguiente código te permite borrar una instancia de ReasoningEngine que se estableció en la variable remote_app:

remote_app.update(
    reasoning_engine=UPDATED_AGENT_INSTANCE,  # Optional.
    requirements=REQUIREMENTS,                # Optional.
    display_name="DISPLAY_NAME",              # Optional.
    description="DESCRIPTION",                # Optional.
    extra_packages=EXTRA_PACKAGES,            # Optional.
)

Los argumentos son los mismos que cuando implementas la aplicación. Puedes encontrar más detalles en la referencia de la API.

Nota: Puedes actualizar uno o más campos de la instancia de ReasoningEngine al mismo tiempo, pero debes especificar al menos uno de los campos que se actualizarán. El tiempo que tarda en actualizarse la instancia dependerá de la actualización que se realice, pero, por lo general, debería tardar entre unos segundos y unos minutos.

REST

Ejecuta el siguiente comando curl para actualizar el nombre visible y la descripción de un recurso ReasoningEngine:

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID?update_mask="display_name,description" \
-d '{ "displayName": "DISPLAY_NAME", "description": "DESCRIPTION" }'

Nota: De manera similar, puedes realizar cambios en los otros campos y especificarlos en update_mask cuando lo hagas.

Borra una instancia de ReasoningEngine

SDK de Vertex AI para Python

El siguiente código te permite borrar una instancia de ReasoningEngine que se estableció en la variable remote_app:

remote_app.delete()

REST

Cada instancia de ReasoningEngine tiene un RESOURCE_ID único identificador. Para obtener más información, consulta Implementa la aplicación.

Ejecuta el siguiente comando de curl para borrar una instancia específica de ReasoningEngine:

curl \
-X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID

Haz un seguimiento de una instancia de LangchainAgent

Para habilitar el seguimiento para aplicaciones LangchainAgent, especifica enable_tracing=True cuando desarrolles la aplicación. Por ejemplo:

agent = reasoning_engines.LangchainAgent(
    model=model,                # Required.
    tools=[get_exchange_rate],  # Optional.
    enable_tracing=True,        # [New] Optional.
)

agent.query(input="What is the exchange rate from US dollars to Swedish currency?")

Esta acción exportará seguimientos a Cloud Trace en el proyecto en Configura tu proyecto de Google Cloud.

Ver seguimientos

Puedes encontrar los seguimientos en el Explorador de seguimiento.

Ir al Explorador de seguimiento

En el siguiente gráfico de Gantt, se muestra el resultado del seguimiento de la aplicación de ejemplo en Desarrolla una aplicación:

 

La primera fila en el diagrama de Gantt es para el seguimiento, y existe una fila para cada intervalo del seguimiento, que describe cuánto tiempo tardó cada suboperación.

Para obtener más información, consulta la documentación del Explorador de seguimiento.

Habilita el seguimiento para una aplicación personalizada

Para habilitar el seguimiento para aplicaciones personalizadas, puedes usar la integración de Google Cloud de OpenTelemetry en combinación con un framework de instrumentación como OpenInference o OpenLLMetry.

Cuotas y límites

Algunos valores de atributos pueden truncarse cuando alcancen los límites de cuota. Para obtener más información, consulta Cuota de Cloud Trace.

Costo

Cloud Trace tiene un nivel gratuito. Para obtener información sobre los precios más allá del nivel gratuito, consulta Precios de Cloud Trace.