feat(ai): complete ADK migration and optimize system health checks

Major architectural changes and improvements:

## ADK Framework Migration (v0.10.0)
- Migrated from LangChain/LangGraph to Google ADK 1.3.0 with LiteLLM 1.80.5
- Improved tool calling reliability with local Ollama models
- Converted all 10 tools to ADK async generator format
- Updated streaming pipeline for ADK event system
- Enhanced error handling and agent initialization

## Model Optimization
- Switched from gemma3:12b (10GB VRAM) to gemma3:4b (4.8GB VRAM)
- Reduced VRAM usage from 91% to 43% (5.4GB freed)
- Optimized for production stability with memory headroom

## Health Check System Overhaul
- Optimized /health/full: 6ms response (was 30s+)
- Added model verification: confirms configured model is available
- New /health/diagnostics endpoint with optional deep testing
- Added currently loaded models tracking
- Clear emoji status indicators (✅/❌/⚠️)
- Fixed AGENT_AVAILABLE flag export for proper health reporting

## Ollama Client Enhancements
- Added list_models() method for model inventory
- Enhanced model verification in health checks
- Better error handling and reporting

## Documentation Updates
- Updated STATUS.md to v0.10.0-adk-migration
- Comprehensive CHANGELOG.md entry with migration details
- Updated PLANS.md showing Phase 4 complete
- Updated ai-orchestrator-plan.md with ADK status
- Added MIGRATION_PLAN_LANGCHAIN_TO_ADK.md
- Added ADK_Ollama_Research.md with implementation analysis

## Technical Details
- 10 tools: 7 infrastructure + 2 research + 1 response tool
- Framework: Google ADK with UnifiedAgent pattern
- System prompt: v7_adk_best_practice
- Container health: Now passing Docker healthchecks
- Response times: Simple queries ~0.3-1s, Research ~4-7s

This commit is contained in:

jpmschweitzer

2025-11-26 08:36:50 +01:00

parent bfc58b03ba

commit e3b451b7b0

15 changed files with 1731 additions and 275 deletions

									
										services/core-api/Dockerfile
									
		+1
		-1
	
												View File
												
				@@ -41,7 +41,7 @@ EXPOSE 8083

				# Health check

				HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \

				    CMD curl -f http://localhost:8083/health || exit 1

				    CMD curl -f http://localhost:8083/health/full || exit 1

				# Run the application

				CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8083"]