원클릭으로 Manus에서 모든 스킬 실행

adk-migration

스타1

포크0

업데이트2026년 7월 8일 10:43

Migrate ADK agents from 1.x to 2.3. Covers breaking API changes (graph Workflow vs GraphAgent, McpToolset, BuiltInCodeExecutor, ctx.resume_inputs, agent modes), renamed imports, deploy CLI changes, model/thinking/embedding updates, and session/state incompatibility. Use when upgrading an ADK 1.x codebase to 2.3, auditing code for deprecated 1.x APIs, or resolving 2.3 import/attribute errors.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

OMIXEC

OMIXEC/Google-ADK-Skills

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

adk-migration — ADK 1.x → 2.3

Port an ADK 1.x codebase to 2.3 (google-adk>=2.3.0,<3). Every mapping below is verified through Context7 /google/adk-docs and the local adk-python-v2.3/ mirror when present. Never use adk-python-v1/ for new ADK APIs.

When to use

Upgrading an ADK 1.x project to 2.3.
Diagnosing 2.3 ImportError/AttributeError from old symbol names.
Auditing a codebase for deprecated 1.x patterns before shipping.

Breaking-change checklist

Scan the codebase (grep) for each left-hand pattern and apply the fix:

1.x (deprecated / removed)	2.3
`GraphAgent`, `builder.add_node/add_edge`, `Condition`, `google.adk.agents.graph`	`Workflow` + `node()` + `Edge(from_node, to_node, route)` + `JoinNode`
`@edge` decorator	`Edge(...)` class instances
`ctx.resume_data`	`ctx.resume_inputs`
`MCPToolset`	`McpToolset`
`connection_params=StdioServerParameters(...)`	`connection_params=StdioConnectionParams(server_params=StdioServerParameters(...))`
`from ...tools import code_execution` (+ in `tools=`)	`BuiltInCodeExecutor` (`google.adk.code_executors`) via `code_executor=`
`from google.adk.sessions import VertexAiMemoryBankService`	`from google.adk.memory import VertexAiMemoryBankService`
`RemoteA2AAgent`	`RemoteA2aAgent` (`google.adk.agents.remote_a2a_agent`)
`adk deploy cloud-run` / `adk deploy vertex`	`adk deploy cloud_run` / `adk deploy agent_engine`
`thinking_budget=<int>`	`thinking_level="minimal\|low\|medium\|high"`
`temperature` / `top_p` / `top_k` / `candidate_count` on Gemini 3.x	remove (no longer recommended / unsupported)
`gemini-2.0-`, `gemini-1.5-`, `gemini-2.5-*`, `gemini-pro`	`gemini-3.5-flash` / `gemini-3.1-flash-lite` / `gemini-3.1-pro-preview`
`gemini-live-2.5-flash-native-audio`, `gemini-2.0-flash-live-001`	`gemini-3.1-flash-live-preview`
`text-embedding-004`, `embedding-001`	`gemini-embedding-2`
`google-adk` 1.x pin, Python 3.11-only	`google-adk>=2.3.0,<3`, Python 3.10+, `google-genai` v2.0.0+

Full old→new code samples: references/api-changes.md. Model/thinking/embedding detail: references/models-config.md.

Structural rules new/enforced in 2.3

output_schema XOR tools — an LlmAgent with output_schema may not have tools, sub-agents, or transfer. Split reasoning leaves (schema) from tool leaves.
Agent modes — LlmAgent.mode: Literal['chat', 'task', 'single_turn'].
Graph runtime — node() functions + Edge instances + JoinNode fan-in (google.adk.workflow); Workflow exported top-level (from google.adk import Workflow).
HITL — request_input tool pauses a run; resume reads ctx.resume_inputs.

Data / state incompatibility

Session/state schema is not compatible between 1.x and 2.3. Do not reuse 1.x-persisted sessions; start fresh or migrate with tools under google.adk.sessions.migration (local mirror path: adk-python-v2.3/src/google/adk/sessions/migration/).
Embedding spaces are incompatible across embedding models — moving to gemini-embedding-2 requires re-embedding all stored vectors.

Migration procedure

Pin google-adk>=2.3.0,<3 and google-genai>=2.0.0; set Python 3.10+.
Run the checklist grep-and-replace (start with imports, then call sites).
Convert any GraphAgent/add_edge graphs to Workflow/Edge/JoinNode.
Split any LlmAgent that has both output_schema and tools.
Update model IDs + thinking_level; drop sampling params on 3.x.
Re-embed stored vectors if changing embedding model.
Verify (below).

Verify

# no deprecated symbols remain
grep -rnE "GraphAgent|add_edge\(|MCPToolset[^a-z]|ctx\.resume_data|@edge\b|thinking_budget|gemini-(2\.|1\.)" src/
python -c "import google.adk; print(google.adk.__version__)"   # 2.3.x

Then run the app / tests. Related skills: adk-model-routing (models + thinking), adk-embeddings (embedding/DB migration), adk-tools/adk-mcp (tool/MCP APIs).

이 저장소의 다른 Skills

같은 저장소

adk-a2a

OMIXEC/Google-ADK-Skills

ADK Agent-to-Agent (A2A) protocol expert covering remote agent communication, agent cards, HTTP-based delegation, and distributed agent systems. Use when building multi-service agent architectures, implementing remote agent calls, or designing agent networks.

2026-07-081

adk-embeddings

OMIXEC/Google-ADK-Skills

ADK memory + embeddings across databases. Generate multimodal embeddings with gemini-embedding-2, persist agent sessions/memory to Cloud SQL, Postgres, Firestore, or SQLite, and store/retrieve vectors for RAG (pgvector, Firestore vector). Use when choosing a session/memory backend, wiring a database SessionService or MemoryService, generating embeddings, or building a vector store for retrieval on an ADK agent.

2026-07-081

adk-model-routing

OMIXEC/Google-ADK-Skills

ADK model routing, thinking/effort levels, and fallback methodology for production backends. Covers the current Gemini 3.x model catalog (gemini-3.5-flash, gemini-3.1-flash-lite, gemini-3.1-pro-preview, gemini-3.1-flash-live-preview, gemini-embedding-2), thinking_level effort tiers (minimal/low/medium/high), deprecation of thinking_budget and sampling params, and primary→fallback chains. Use when selecting a model, tuning thinking/effort, routing by task complexity/cost, or designing model fallback for an ADK agent.

2026-07-081

adk-agent-builder

OMIXEC/Google-ADK-Skills

Central hub for building, testing, and iterating on ADK agents. Trigger this skill when the user wants to create a new agent, configure modes (task, single-turn), or build graph-based workflows.

2026-07-071

graph-workflow-go

OMIXEC/Google-ADK-Skills

DAG-based ADK workflow in Go using graph pattern. Use for Go backends needing multi-step agent pipelines.

2026-07-071

collaborative-workflow-python

OMIXEC/Google-ADK-Skills

Coordinator agent delegating to specialized sub-agents. Python. Use for multi-domain tasks requiring different expertise.

2026-07-071

name	adk-migration
description	Migrate ADK agents from 1.x to 2.3. Covers breaking API changes (graph Workflow vs GraphAgent, McpToolset, BuiltInCodeExecutor, ctx.resume_inputs, agent modes), renamed imports, deploy CLI changes, model/thinking/embedding updates, and session/state incompatibility. Use when upgrading an ADK 1.x codebase to 2.3, auditing code for deprecated 1.x APIs, or resolving 2.3 import/attribute errors.

adk-migration — ADK 1.x → 2.3

When to use

Upgrading an ADK 1.x project to 2.3.
Diagnosing 2.3 ImportError/AttributeError from old symbol names.
Auditing a codebase for deprecated 1.x patterns before shipping.

Breaking-change checklist

Scan the codebase (grep) for each left-hand pattern and apply the fix:

1.x (deprecated / removed)	2.3
`GraphAgent`, `builder.add_node/add_edge`, `Condition`, `google.adk.agents.graph`	`Workflow` + `node()` + `Edge(from_node, to_node, route)` + `JoinNode`
`@edge` decorator	`Edge(...)` class instances
`ctx.resume_data`	`ctx.resume_inputs`
`MCPToolset`	`McpToolset`
`connection_params=StdioServerParameters(...)`	`connection_params=StdioConnectionParams(server_params=StdioServerParameters(...))`
`from ...tools import code_execution` (+ in `tools=`)	`BuiltInCodeExecutor` (`google.adk.code_executors`) via `code_executor=`
`from google.adk.sessions import VertexAiMemoryBankService`	`from google.adk.memory import VertexAiMemoryBankService`
`RemoteA2AAgent`	`RemoteA2aAgent` (`google.adk.agents.remote_a2a_agent`)
`adk deploy cloud-run` / `adk deploy vertex`	`adk deploy cloud_run` / `adk deploy agent_engine`
`thinking_budget=<int>`	`thinking_level="minimal\|low\|medium\|high"`
`temperature` / `top_p` / `top_k` / `candidate_count` on Gemini 3.x	remove (no longer recommended / unsupported)
`gemini-2.0-`, `gemini-1.5-`, `gemini-2.5-*`, `gemini-pro`	`gemini-3.5-flash` / `gemini-3.1-flash-lite` / `gemini-3.1-pro-preview`
`gemini-live-2.5-flash-native-audio`, `gemini-2.0-flash-live-001`	`gemini-3.1-flash-live-preview`
`text-embedding-004`, `embedding-001`	`gemini-embedding-2`
`google-adk` 1.x pin, Python 3.11-only	`google-adk>=2.3.0,<3`, Python 3.10+, `google-genai` v2.0.0+

Full old→new code samples: references/api-changes.md. Model/thinking/embedding detail: references/models-config.md.

Structural rules new/enforced in 2.3

output_schema XOR tools — an LlmAgent with output_schema may not have tools, sub-agents, or transfer. Split reasoning leaves (schema) from tool leaves.
Agent modes — LlmAgent.mode: Literal['chat', 'task', 'single_turn'].
Graph runtime — node() functions + Edge instances + JoinNode fan-in (google.adk.workflow); Workflow exported top-level (from google.adk import Workflow).
HITL — request_input tool pauses a run; resume reads ctx.resume_inputs.

Data / state incompatibility

Session/state schema is not compatible between 1.x and 2.3. Do not reuse 1.x-persisted sessions; start fresh or migrate with tools under google.adk.sessions.migration (local mirror path: adk-python-v2.3/src/google/adk/sessions/migration/).
Embedding spaces are incompatible across embedding models — moving to gemini-embedding-2 requires re-embedding all stored vectors.

Migration procedure

Pin google-adk>=2.3.0,<3 and google-genai>=2.0.0; set Python 3.10+.
Run the checklist grep-and-replace (start with imports, then call sites).
Convert any GraphAgent/add_edge graphs to Workflow/Edge/JoinNode.
Split any LlmAgent that has both output_schema and tools.
Update model IDs + thinking_level; drop sampling params on 3.x.
Re-embed stored vectors if changing embedding model.
Verify (below).

Verify

# no deprecated symbols remain
grep -rnE "GraphAgent|add_edge\(|MCPToolset[^a-z]|ctx\.resume_data|@edge\b|thinking_budget|gemini-(2\.|1\.)" src/
python -c "import google.adk; print(google.adk.__version__)"   # 2.3.x

Then run the app / tests. Related skills: adk-model-routing (models + thinking), adk-embeddings (embedding/DB migration), adk-tools/adk-mcp (tool/MCP APIs).