Debug-Modus aktivieren
Erfahren Sie, wie Sie das Debuglogging in ADK zur Fehlerbehebung aktivieren.
Debuglogging in ADK
Wenn Sie eine Anwendung entwickeln oder Fehler beheben, die mit ADK erstellt wurde, können Sie den Debug-Loggingmodus aktivieren, um detailliertere Informationen zu den Vorgängen im Hintergrund zu erhalten. Sie können diesen Modus in ADK über eine Umgebungsvariable aktivieren.
Debug-Modus aktivieren
Um das Debuglogging in ADK zu aktivieren, setzen Sie die Umgebungsvariable ADK_LOG_LEVEL auf DEBUG:
export ADK_LOG_LEVEL=DEBUG
Unter Windows können Sie diese Umgebungsvariable mit dem Befehl set festlegen:
set ADK_LOG_LEVEL=DEBUG
Nachdem Sie diese Umgebungsvariable festgelegt haben, führen Sie die ADK-Anwendung wie gewohnt aus. In der Ausgabe wird ein detaillierteres Log angezeigt.
Informationen zum Debug-Modus
Wenn der Debug-Modus aktiviert ist, erhalten Sie die folgenden Informationen:
- Ressourcen-OCIDs: Eindeutige IDs für die verwendeten OCI-Ressourcen
- OPC-Anforderungs-IDs: Anforderungs-IDs, die bei der Arbeit mit Oracle-Support referenziert werden sollen
- API-Anforderungs-/Antwortdetails: Details zur Kommunikation mit OCI-Services
- Logs für interne Vorgänge: Informationen darüber, wie der ADK Ihre Anforderungen verarbeitet
- Toolausführungstraces: Detaillierte Logs zu Toolaufrufen und deren Ergebnissen
Tipp: Wenn ein Problem auftritt, speichern Sie die zugehörigen Debuglogs. Diese Logs sind hilfreich, wenn Probleme an das OCI Generative AI Agents-Serviceteam oder Oracle Support gemeldet werden.
Beispielausgabe
Nach der Ausführung einer ADK-Anwendung mit aktiviertem Debug-Loggingmodus erhalten Sie eine Beispielausgabe:
[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
Wann wird der Debug-Modus verwendet?
Debug-Modus aktivieren, wenn:
- Fehlerbehebung bei unerwarteten Verhaltensweisen oder Fehlern
- Bei einem Problem mit Oracle Support arbeiten
- Ablauf der Agent-Ausführung verstehen
- Neue Agent-Funktionen entwickeln und detaillierte Interaktionen anzeigen
Hinweis: Deaktivieren Sie den Debug-Modus in Produktionsumgebungen, indem Sie diese Umgebungsvariable deaktivieren, da dieser Modus ausführliche Logs generiert, die sich auf die Performance auswirken können.
unset ADK_LOG_LEVEL
Integration mit Logging-Frameworks
ADK verwendet das Standardloggingmodul von Python. Wenn Ihre Anwendung eine benutzerdefinierte Loggingkonfiguration verwendet, können Sie die ADK-Logebene auch programmgesteuert steuern:
import logging
logging.getLogger('adk').setLevel(logging.DEBUG)
Mit dieser Methode können Sie das Logging in komplexen Anwendungen feiner steuern.