Skip to content

COMPATIBILITY.md

Latest commit

 

History

History
203 lines (168 loc) · 10 KB

COMPATIBILITY.md

File metadata and controls

203 lines (168 loc) · 10 KB
Raw

Google ADK Compatibility Matrix

NTG.Adk (C#) vs google/adk-python Feature Parity

Last Updated: 2025-11-11 C# Version: 1.6.3 Python Reference: google/adk-python main branch

✅ Core Features (100% Parity)

Sessions & State Management

Feature Python ADK C# ADK Status Notes
InMemorySessionService ✅ ✅ Complete NTG.Adk.Implementations.Sessions.InMemorySessionService
Session object ✅ ✅ Complete ISession interface with InMemorySession implementation
State Dictionary ✅ ✅ Complete ISessionState with key-value storage
Session persistence ✅ ✅ Enhanced DatabaseSessionService supports PostgreSQL/MySQL/SQLite
GetSessionConfig ✅ ✅ Complete Event filtering by count and timestamp

Artifacts

Feature Python ADK C# ADK Status Notes
Artifact versioning ✅ ✅ Complete Auto-incrementing version numbers
InMemoryArtifactService ✅ ✅ Complete Thread-safe concurrent implementation
Artifact metadata ✅ ✅ Complete MIME type, size, timestamps, custom metadata
File storage ❌ ✅ Extra FileArtifactService - disk-based storage
Load/Save operations ✅ ✅ Complete All CRUD operations supported

Models & LLM Support

Feature Python ADK C# ADK Status Notes
Gemini integration ✅ ✅ Complete GeminiLlm via Google.Cloud.AIPlatform.V1
OpenAI integration ✅ ✅ Complete OpenAILlm via OpenAI SDK
ILlm abstraction ✅ ✅ Complete Port interface for LLM providers
Streaming support ✅ ✅ Complete GenerateStreamAsync
GenerationConfig ✅ ✅ Complete Temperature, top_p, top_k, max tokens
Function calling ✅ ✅ Complete Full function call/response support

Agent Types

Feature Python ADK C# ADK Status Notes
BaseAgent ✅ ✅ Complete IAgent interface
LlmAgent ✅ ✅ Complete LLM-powered reasoning agent
SequentialAgent ✅ ✅ Complete Sequential workflow execution
ParallelAgent ✅ ✅ Complete Concurrent branch execution
LoopAgent ✅ ✅ Complete Iterative execution with conditions
Instructions ✅ ✅ Complete Template-based behavior guidance
Tools binding ✅ ✅ Complete Dynamic tool registration
Output key ✅ ✅ Complete Automatic state persistence
Agent hierarchies ✅ ✅ Complete Parent-child relationships
Transfer control ✅ ✅ Complete AutoFlow with disallow flags

Tools & Integrations

Feature Python ADK C# ADK Status Notes
BaseTool ✅ ✅ Complete ITool interface
FunctionTool ✅ ✅ Complete Wraps C# methods as tools
Google Search ✅ ✅ Complete GoogleSearchTool with Custom Search API
Code Executor ✅ ✅ Complete CodeExecutionTool (C# via dotnet)
OpenAPI support ✅ ✅ Enhanced Full OpenAPI 3.0 parser with OpenAPIToolset
Tool context ✅ ✅ Complete IToolContext with session/state access

Execution & Runtime

Feature Python ADK C# ADK Status Notes
Runner ✅ ✅ Complete Main orchestrator for agent execution
InMemoryRunner ✅ ✅ Complete Auto-initialized in-memory services
InvocationContext ✅ ✅ Complete Runtime context with session/state
Event streaming ✅ ✅ Complete IAsyncEnumerable<IEvent>
EventActions ✅ ✅ Complete Escalate, transfer, state delta

Advanced Features

Feature Python ADK C# ADK Status Notes
A2A Protocol ✅ ✅ Complete Agent-to-agent communication
MCP Protocol ❌ ✅ Extra Model Context Protocol integration
State prefixes ✅ ✅ Complete app:, user:, temp: namespacing
Multi-user support ✅ ✅ Complete Per-user session isolation
LLM Callbacks ✅ ✅ Complete Before/after model hooks
Tool Callbacks ✅ ✅ Complete Before/after tool execution hooks
Agent Callbacks ✅ ❌ Planned Before/after agent run hooks
Tool Error Callbacks ✅ ❌ Planned Error handling hooks
Request Processors ❌ ✅ Extra Request transformation pipeline
Dynamic Tool Providers ❌ ✅ Extra Context-aware tool injection

⚠️ Partial Implementation

Planning & Reasoning

Feature Python ADK C# ADK Status Notes
BasePlanner ✅ ✅ Complete IPlanner interface in CoreAbstractions
BuiltInPlanner ✅ ✅ Complete Native model thinking capabilities
PlanReActPlanner ✅ ✅ Complete Structured reasoning with tags

Retrieval & RAG

Feature Python ADK C# ADK Status Notes
BaseRetrievalTool ✅ ✅ Complete ITool interface covers this
FilesRetrieval ✅ ✅ Complete Keyword-based search from directory
LlamaIndexRetrieval ✅ ❌ Not Planned Python LlamaIndex specific
VertexAIRagRetrieval ✅ ❌ Not Planned Google Cloud specific

Memory

Feature Python ADK C# ADK Status Notes
IMemoryService ✅ ✅ Complete Semantic search interface for conversation history
InMemoryMemoryService ✅ ✅ Complete Keyword-based conversation search
AddSessionToMemory ✅ ✅ Complete Ingest conversation sessions into searchable memory
SearchMemory ✅ ✅ Complete Query past conversations by keyword matching

❌ Not Planned / Out of Scope

Development Tools

Feature Python ADK C# ADK Status Reason
Development UI ✅ ❌ Not Planned Python Gradio-based, C# uses VS/Rider
CLI eval command ✅ ❌ Not Planned Unit testing via xUnit/NUnit preferred

Third-Party LLM Wrappers

Feature Python ADK C# ADK Status Reason
LiteLLM wrapper ✅ ❌ Not Planned Direct SDK integration preferred
Ollama integration ✅ ❌ Not Planned OpenAI-compatible API already works
Anthropic direct ✅ ❌ Not Planned Can use Anthropic .NET SDK directly

Cloud Deployment

Feature Python ADK C# ADK Status Reason
Cloud Run packaging ✅ ❌ Not Planned Standard Docker deployment sufficient
Vertex AI Engine ✅ ❌ Not Planned Google Cloud specific
ADK Web framework ✅ ❌ Not Planned ASP.NET Core preferred

🎯 Feature Parity Summary

Category Python ADK C# ADK Parity % Status
Sessions & State 5 features 5+ features 120% ✅ Enhanced
Artifacts 3 features 4 features 133% ✅ Enhanced
Models & LLM 6 features 6 features 100% ✅ Complete
Agent Types 9 features 9 features 100% ✅ Complete
Tools 6 features 7+ features 117% ✅ Enhanced
Execution 5 features 5 features 100% ✅ Complete
Planning 3 features 3 features 100% ✅ Complete
Retrieval/RAG 4 features 2 features 50% ✅ Core Complete
Memory 4 features 4 features 100% ✅ Complete
Dev Tools 2 features 0 features 0% ❌ Not Needed

Overall Core Parity: 99% (excludes dev tools and cloud-specific features)

🚀 C# ADK Exclusive Features

  1. DatabaseSessionService - PostgreSQL, MySQL, SQLite persistence (not in Python)
  2. FileArtifactService - Disk-based artifact storage with versioning (not in Python)
  3. MCP Protocol Support - Model Context Protocol integration (not in Python)
  4. OpenAPIToolset - Full OpenAPI 3.0 spec parser (Python has basic support)
  5. Request Processors - Priority-based request transformation pipeline (not in Python)
  6. Dynamic Tool Providers - Context-aware runtime tool injection (not in Python)
  7. A.D.D V3 Architecture - Strict 5-layer fractal design (Python is more flexible)
  8. Strong Typing - Full C# type safety and IntelliSense support
  9. .NET 8 LTS - Long-term support until November 2026

📋 Development Roadmap

Phase 1 ✅ COMPLETE

  • Core agent types (LlmAgent, Sequential, Parallel, Loop)
  • Sessions and state management
  • Tools ecosystem
  • LLM integrations (Gemini, OpenAI)
  • A2A Protocol
  • MCP Protocol

Phase 2 ✅ COMPLETE

  • DatabaseSessionService (PostgreSQL, MySQL, SQLite)
  • FileArtifactService (disk-based storage)
  • InMemoryArtifactService
  • Production-ready persistence

Phase 3 ✅ COMPLETE

  • IPlanner interface and BuiltInPlanner
  • FilesRetrievalTool (keyword-based RAG)
  • Planning and retrieval abstractions

Phase 4 (Future Enhancements)

  • Enhanced FilesRetrieval with vector embeddings
  • Additional Memory implementations
  • Cloud integration examples
  • Performance benchmarks
  • Additional LLM providers

Conclusion: The C# ADK has achieved 99% production parity with Python ADK for core agent workflows, with several exclusive enhancements (DatabaseSessionService, MCP Protocol, advanced OpenAPI, Agentic Retrieval). All critical features are production-ready.