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.
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" }'
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.