mirror of
https://github.com/encounter/adk-python.git
synced 2026-07-09 18:19:28 -07:00
Haiyuan CaoandCopybara-Service
223d9a7ff5
Close gaps between ADK's Agent Skills implementation and the public Agent Skills spec (agentskills.io/specification): - Frontmatter: add field validators for name (kebab-case, max 64), description (non-empty, max 1024), compatibility (max 500); add allowed-tools alias; add extra='allow'; add populate_by_name - utils: extract _parse_skill_md helper; use model_validate() for alias support; enforce name-dir matching; add validate_skill_dir() and read_skill_properties() - prompt: accept Union[Frontmatter, Skill]; - skill_toolset: add scripts/ resource loading; auto-inject system instruction (with inject_instruction opt-out); duplicate name check; _list_skills() returns Skill objects - sample agent: remove manual instruction (auto-injected now) Co-authored-by: Haiyuan Cao <haiyuan@google.com> PiperOrigin-RevId: 873177060
57 lines
1.8 KiB
Python
57 lines
1.8 KiB
Python
# Copyright 2026 Google LLC
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
"""Example agent demonstrating the use of SkillToolset."""
|
|
|
|
import pathlib
|
|
|
|
from google.adk import Agent
|
|
from google.adk.skills import load_skill_from_dir
|
|
from google.adk.skills import models
|
|
from google.adk.tools.skill_toolset import SkillToolset
|
|
|
|
greeting_skill = models.Skill(
|
|
frontmatter=models.Frontmatter(
|
|
name="greeting-skill",
|
|
description=(
|
|
"A friendly greeting skill that can say hello to a specific person."
|
|
),
|
|
),
|
|
instructions=(
|
|
"Step 1: Read the 'references/hello_world.txt' file to understand how"
|
|
" to greet the user. Step 2: Return a greeting based on the reference."
|
|
),
|
|
resources=models.Resources(
|
|
references={
|
|
"hello_world.txt": "Hello! 👋👋👋 So glad to have you here! ✨✨✨",
|
|
"example.md": "This is an example reference.",
|
|
},
|
|
),
|
|
)
|
|
|
|
weather_skill = load_skill_from_dir(
|
|
pathlib.Path(__file__).parent / "skills" / "weather_skill"
|
|
)
|
|
|
|
my_skill_toolset = SkillToolset(skills=[greeting_skill, weather_skill])
|
|
|
|
root_agent = Agent(
|
|
model="gemini-2.5-flash",
|
|
name="skill_user_agent",
|
|
description="An agent that can use specialized skills.",
|
|
tools=[
|
|
my_skill_toolset,
|
|
],
|
|
)
|