Activación del modo de depuración
Descubra cómo activar el registro de depuración en ADK para la resolución de problemas.
Depurar registro en ADK
Al desarrollar o solucionar problemas de una aplicación creada con ADK, para obtener información más detallada sobre lo que ocurre en segundo plano, puede activar el modo de registro de depuración. Puede activar este modo en ADK mediante una variable de entorno.
Activación del modo de depuración
Para activar el registro de depuración en ADK, defina la variable de entorno ADK_LOG_LEVEL en DEBUG:
export ADK_LOG_LEVEL=DEBUG
En Windows, puede definir esta variable de entorno mediante el comando set:
set ADK_LOG_LEVEL=DEBUG
Después de definir esta variable de entorno, ejecute la aplicación ADK como de costumbre y verá un log más detallado en la salida.
Información del modo de depuración
Cuando el modo de depuración está activado, obtendrá la siguiente información:
- OCID de recurso: identificadores únicos para los recursos de OCI que se están utilizando
- ID de solicitud de OPC: identificadores de solicitud a los que hacer referencia cuando se trabaja con los Servicios de Soporte Oracle
- Detalles de solicitud/respuesta de API: detalles sobre la comunicación con los servicios de OCI
- Logs de operaciones internas: información sobre cómo el ADK está procesando sus solicitudes
- Rastreos de Ejecución de Herramientas: Logs detallados sobre llamadas a herramientas y sus resultados
Consejo: si encuentra un problema, guarde los logs de depuración. Estos logs son útiles al informar problemas al equipo de servicio de OCI Generative AI Agents o a los Servicios de Soporte Oracle.
Salida de ejemplo
A continuación, se muestra un ejemplo de salida después de ejecutar una aplicación ADK, con el modo de registro de depuración activado:
[05/08/25 15:19:35] DEBUG Invoking chat endpoint with data: {
"performed_actions": [
{
"action_id": "<example-action-id>",
"function_call_output": "{\"message\": {\"role\": \"AGENT\", \"content\":
{\"text\": \"Your most recent order, order_222222, has been refunded.\",
\"citations\": null, \"paragraph_citations\": null}, \"time_created\":
\"2025-05-08T22:19:33.669000+00:00\"}, \"traces\": [{\"time_created\":
\"2025-05-08T22:19:33.233000+00:00\", \"trace_type\": \"UNKNOWN_ENUM_VALUE\"}],
\"tool_results\": null, \"required_actions\": null, \"guardrail_result\": null}",
"performed_action_type": "FUNCTION_CALLING_PERFORMED_ACTION"
}
],
"session_id":
"ocid1.genaiagentsession.oc1.ap-osaka-1.xxx",
"should_stream": false,
"tool_parameters": null,
"user_message": "null"
}
[05/08/25 15:19:36] DEBUG Chat succeeded response: {
"guardrail_result": null,
"message": {
"content": {
"citations": null,
"paragraph_citations": null,
"text": "Your most recent order, order_222222, has been refunded."
},
"role": "AGENT",
"time_created": "2025-05-08T22:19:36.460000+00:00"
},
"required_actions": null,
"tool_results": null,
"traces": [
{
"time_created": "2025-05-08T22:19:36.048000+00:00",
"trace_type": "UNKNOWN_ENUM_VALUE"
}
]
}
DEBUG Chat succeeded opc-request-id:
5DF2A7C7E07F4DBDAE43373AADB51D22/4F09D0E8DAB0C8B3F72D1D684B4958C3/114ADCF1B6EBA536C
3A727BE80B570C1
Cuándo utilizar el modo de depuración
Active el modo de depuración cuando:
- Solución de errores o comportamientos inesperados
- Trabajar con el soporte de Oracle en un problema
- Descripción del Flujo de Ejecución de su Agente
- Desarrollo de nuevas funciones de agente y deseo de ver las interacciones detalladas
Nota: Recuerde desactivar el modo de depuración en entornos de producción anulando la definición de esta variable de entorno, ya que este modo genera logs detallados que podrían afectar al rendimiento.
unset ADK_LOG_LEVEL
Integración con Marcos de Registro
ADK utiliza el módulo de registro estándar de Python. Si la aplicación utiliza una configuración de registro personalizada, también puede controlar el nivel de log de ADK mediante programación:
import logging
logging.getLogger('adk').setLevel(logging.DEBUG)
Este método le proporciona un control más detallado sobre el registro en aplicaciones complejas.