Ankur Sharma
9a75c06873
The metric takes into account all the turns of the multi-turn conversation. The class delegates the responsibility to Vertex Gen AI Eval SDK. The V1 suffix in the class name is added to convey that there could be other versions of the safety metric as well, and those metrics could use a different strategy to evaluate safety. Co-authored-by: Ankur Sharma <ankusharma@google.com> PiperOrigin-RevId: 884504910
228 lines
8.9 KiB
TOML
228 lines
8.9 KiB
TOML
[project]
|
|
# Project metadata. Available keys are documented at:
|
|
# https://packaging.python.org/en/latest/specifications/declaring-project-metadata
|
|
|
|
name = "google-adk"
|
|
description = "Agent Development Kit"
|
|
readme = "README.md"
|
|
requires-python = ">=3.10"
|
|
license = { file = "LICENSE" }
|
|
authors = [{ name = "Google LLC", email = "googleapis-packages@google.com" }]
|
|
classifiers = [ # List of https://pypi.org/classifiers/
|
|
"Typing :: Typed",
|
|
"Intended Audience :: Developers",
|
|
"Intended Audience :: Science/Research",
|
|
"Programming Language :: Python",
|
|
"Programming Language :: Python :: 3",
|
|
"Programming Language :: Python :: 3.10",
|
|
"Programming Language :: Python :: 3.11",
|
|
"Programming Language :: Python :: 3.12",
|
|
"Programming Language :: Python :: 3.13",
|
|
"Programming Language :: Python :: 3.14",
|
|
"Operating System :: OS Independent",
|
|
"Topic :: Software Development :: Libraries :: Python Modules",
|
|
"License :: OSI Approved :: Apache Software License",
|
|
]
|
|
dependencies = [
|
|
# go/keep-sorted start
|
|
"PyYAML>=6.0.2, <7.0.0", # For APIHubToolset.
|
|
"aiosqlite>=0.21.0", # For SQLite database
|
|
"anyio>=4.9.0, <5.0.0", # For MCP Session Manager
|
|
"authlib>=1.6.6, <2.0.0", # For RestAPI Tool
|
|
"click>=8.1.8, <9.0.0", # For CLI tools
|
|
"fastapi>=0.124.1, <1.0.0", # FastAPI framework
|
|
"google-api-python-client>=2.157.0, <3.0.0", # Google API client discovery
|
|
"google-auth[pyopenssl]>=2.47.0", # Google Auth library
|
|
"google-cloud-aiplatform[agent_engines]>=1.132.0, <2.0.0", # For VertexAI integrations, e.g. example store.
|
|
"google-cloud-bigquery-storage>=2.0.0",
|
|
"google-cloud-bigquery>=2.2.0",
|
|
"google-cloud-bigtable>=2.32.0", # For Bigtable database
|
|
"google-cloud-dataplex>=1.7.0,<3.0.0", # For Dataplex Catalog Search tool
|
|
"google-cloud-discoveryengine>=0.13.12, <0.14.0", # For Discovery Engine Search Tool
|
|
"google-cloud-pubsub>=2.0.0, <3.0.0", # For Pub/Sub Tool
|
|
"google-cloud-secret-manager>=2.22.0, <3.0.0", # Fetching secrets in RestAPI Tool
|
|
"google-cloud-spanner>=3.56.0, <4.0.0", # For Spanner database
|
|
"google-cloud-speech>=2.30.0, <3.0.0", # For Audio Transcription
|
|
"google-cloud-storage>=2.18.0, <4.0.0", # For GCS Artifact service
|
|
"google-genai>=1.64.0, <2.0.0", # Google GenAI SDK
|
|
"graphviz>=0.20.2, <1.0.0", # Graphviz for graph rendering
|
|
"httpx>=0.27.0, <1.0.0", # HTTP client library
|
|
"jsonschema>=4.23.0, <5.0.0", # Agent Builder config validation
|
|
"mcp>=1.23.0, <2.0.0", # For MCP Toolset
|
|
"opentelemetry-api>=1.36.0, <1.39.0", # OpenTelemetry - keep below 1.39.0 due to current agent_engines exporter constraints.
|
|
"opentelemetry-exporter-gcp-logging>=1.9.0a0, <2.0.0",
|
|
"opentelemetry-exporter-gcp-monitoring>=1.9.0a0, <2.0.0",
|
|
"opentelemetry-exporter-gcp-trace>=1.9.0, <2.0.0",
|
|
"opentelemetry-exporter-otlp-proto-http>=1.36.0",
|
|
"opentelemetry-resourcedetector-gcp>=1.9.0a0, <2.0.0",
|
|
"opentelemetry-sdk>=1.36.0, <1.39.0",
|
|
"pyarrow>=14.0.0",
|
|
"pydantic>=2.12.0, <3.0.0", # For data validation/models
|
|
"python-dateutil>=2.9.0.post0, <3.0.0", # For Vertext AI Session Service
|
|
"python-dotenv>=1.0.0, <2.0.0", # To manage environment variables
|
|
"requests>=2.32.4, <3.0.0",
|
|
"sqlalchemy-spanner>=1.14.0", # Spanner database session service
|
|
"sqlalchemy>=2.0, <3.0.0", # SQL database ORM
|
|
"starlette>=0.49.1, <1.0.0", # For FastAPI CLI
|
|
"tenacity>=9.0.0, <10.0.0", # For Retry management
|
|
"typing-extensions>=4.5, <5",
|
|
"tzlocal>=5.3, <6.0", # Time zone utilities
|
|
"uvicorn>=0.34.0, <1.0.0", # ASGI server for FastAPI
|
|
"watchdog>=6.0.0, <7.0.0", # For file change detection and hot reload
|
|
"websockets>=15.0.1, <16.0.0", # For BaseLlmFlow
|
|
# go/keep-sorted end
|
|
]
|
|
dynamic = ["version"]
|
|
|
|
[project.urls]
|
|
homepage = "https://google.github.io/adk-docs/"
|
|
repository = "https://github.com/google/adk-python"
|
|
changelog = "https://github.com/google/adk-python/blob/main/CHANGELOG.md"
|
|
documentation = "https://google.github.io/adk-docs/"
|
|
|
|
[project.scripts]
|
|
adk = "google.adk.cli:main"
|
|
|
|
[project.optional-dependencies]
|
|
|
|
dev = [
|
|
# go/keep-sorted start
|
|
"flit>=3.10.0",
|
|
"isort>=6.0.0",
|
|
"mypy>=1.15.0",
|
|
"pyink>=25.12.0",
|
|
"pylint>=2.6.0",
|
|
# go/keep-sorted end
|
|
]
|
|
|
|
a2a = [
|
|
# go/keep-sorted start
|
|
"a2a-sdk>=0.3.4,<0.4.0",
|
|
# go/keep-sorted end
|
|
]
|
|
|
|
community = [
|
|
# go/keep-sorted start
|
|
"google-adk-community",
|
|
# go/keep-sorted end
|
|
]
|
|
|
|
eval = [
|
|
# go/keep-sorted start
|
|
"Jinja2>=3.1.4,<4.0.0", # For eval template rendering
|
|
"gepa>=0.1.0",
|
|
"google-cloud-aiplatform[evaluation]>=1.140.0",
|
|
"pandas>=2.2.3",
|
|
"rouge-score>=0.1.2",
|
|
"tabulate>=0.9.0",
|
|
# go/keep-sorted end
|
|
]
|
|
|
|
test = [
|
|
# go/keep-sorted start
|
|
"a2a-sdk>=0.3.0,<0.4.0",
|
|
"anthropic>=0.43.0", # For anthropic model tests
|
|
"crewai[tools];python_version>='3.11' and python_version<'3.12'", # For CrewaiTool tests; chromadb/pypika fail on 3.12+
|
|
"kubernetes>=29.0.0", # For GkeCodeExecutor
|
|
"langchain-community>=0.3.17",
|
|
"langgraph>=0.2.60, <0.4.8", # For LangGraphAgent
|
|
"litellm>=1.75.5, <2.0.0", # For LiteLLM tests
|
|
"llama-index-readers-file>=0.4.0", # For retrieval tests
|
|
"openai>=1.100.2", # For LiteLLM
|
|
"opentelemetry-instrumentation-google-genai>=0.3b0, <1.0.0",
|
|
"pypika>=0.50.0", # For crewai->chromadb dependency
|
|
"pytest-asyncio>=0.25.0",
|
|
"pytest-mock>=3.14.0",
|
|
"pytest-xdist>=3.6.1",
|
|
"pytest>=9.0.0,<10.0.0",
|
|
"python-multipart>=0.0.9",
|
|
"rouge-score>=0.1.2",
|
|
"tabulate>=0.9.0",
|
|
# go/keep-sorted end
|
|
]
|
|
|
|
docs = [
|
|
"autodoc_pydantic",
|
|
"furo",
|
|
"myst-parser",
|
|
"sphinx<9.0.0",
|
|
"sphinx-autodoc-typehints",
|
|
"sphinx-rtd-theme",
|
|
]
|
|
|
|
# Optional extensions
|
|
extensions = [
|
|
"anthropic>=0.43.0", # For anthropic model support
|
|
"beautifulsoup4>=3.2.2", # For load_web_page tool.
|
|
"crewai[tools];python_version>='3.11' and python_version<'3.12'", # For CrewaiTool; chromadb/pypika fail on 3.12+
|
|
"docker>=7.0.0", # For ContainerCodeExecutor
|
|
"kubernetes>=29.0.0", # For GkeCodeExecutor
|
|
"k8s-agent-sandbox>=0.1.1.post2", # For GkeCodeExecutor sandbox mode
|
|
"langgraph>=0.2.60, <0.4.8", # For LangGraphAgent
|
|
"litellm>=1.75.5, <2.0.0", # For LiteLlm class. Currently has OpenAI limitations. TODO: once LiteLlm fix it
|
|
"llama-index-readers-file>=0.4.0", # For retrieval using LlamaIndex.
|
|
"llama-index-embeddings-google-genai>=0.3.0", # For files retrieval using LlamaIndex.
|
|
"lxml>=5.3.0", # For load_web_page tool.
|
|
"pypika>=0.50.0", # For crewai->chromadb dependency
|
|
"toolbox-adk>=0.7.0, <0.8.0", # For tools.toolbox_toolset.ToolboxToolset
|
|
]
|
|
|
|
otel-gcp = ["opentelemetry-instrumentation-google-genai>=0.6b0, <1.0.0"]
|
|
|
|
toolbox = ["toolbox-adk>=0.7.0, <0.8.0"]
|
|
|
|
[tool.pyink]
|
|
# Format py files following Google style-guide
|
|
line-length = 80
|
|
unstable = true
|
|
pyink-indentation = 2
|
|
pyink-use-majority-quotes = true
|
|
pyink-annotation-pragmas = [
|
|
"noqa",
|
|
"pylint:",
|
|
"type: ignore",
|
|
"pytype:",
|
|
"mypy:",
|
|
"pyright:",
|
|
"pyre-",
|
|
]
|
|
|
|
|
|
[build-system]
|
|
# Build system specify which backend is used to build/install the project (flit,
|
|
# poetry, setuptools,...). All backends are supported by `pip install`
|
|
requires = ["flit_core >=3.8,<4"]
|
|
build-backend = "flit_core.buildapi"
|
|
|
|
|
|
[tool.flit.sdist]
|
|
include = ['src/**/*', 'README.md', 'pyproject.toml', 'LICENSE']
|
|
exclude = ['src/**/*.sh']
|
|
|
|
|
|
[tool.flit.module]
|
|
name = "google.adk"
|
|
include = ["py.typed"]
|
|
|
|
|
|
[tool.isort]
|
|
profile = "google"
|
|
single_line_exclusions = []
|
|
line_length = 200 # Prevent line wrap flickering.
|
|
known_third_party = ["google.adk"]
|
|
|
|
|
|
[tool.pytest.ini_options]
|
|
testpaths = ["tests"]
|
|
asyncio_default_fixture_loop_scope = "function"
|
|
asyncio_mode = "auto"
|
|
|
|
|
|
[tool.mypy]
|
|
python_version = "3.10"
|
|
exclude = ["tests/", "contributing/samples/"]
|
|
plugins = ["pydantic.mypy"]
|
|
strict = true
|
|
disable_error_code = ["import-not-found", "import-untyped", "unused-ignore"]
|
|
follow_imports = "skip"
|