google-adk 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (345) hide show
  1. google/adk/._version.py +0 -0
  2. google/adk/__init__.py +20 -0
  3. google/adk/agents/__init__.py +32 -0
  4. google/adk/agents/active_streaming_tool.py +38 -0
  5. google/adk/agents/base_agent.py +345 -0
  6. google/adk/agents/callback_context.py +112 -0
  7. google/adk/agents/invocation_context.py +181 -0
  8. google/adk/agents/langgraph_agent.py +140 -0
  9. google/adk/agents/live_request_queue.py +64 -0
  10. google/adk/agents/llm_agent.py +376 -0
  11. google/adk/agents/loop_agent.py +62 -0
  12. google/adk/agents/parallel_agent.py +96 -0
  13. google/adk/agents/readonly_context.py +46 -0
  14. google/adk/agents/remote_agent.py +50 -0
  15. google/adk/agents/run_config.py +87 -0
  16. google/adk/agents/sequential_agent.py +45 -0
  17. google/adk/agents/transcription_entry.py +34 -0
  18. google/adk/artifacts/__init__.py +23 -0
  19. google/adk/artifacts/base_artifact_service.py +128 -0
  20. google/adk/artifacts/gcs_artifact_service.py +195 -0
  21. google/adk/artifacts/in_memory_artifact_service.py +133 -0
  22. google/adk/auth/__init__.py +22 -0
  23. google/adk/auth/auth_credential.py +220 -0
  24. google/adk/auth/auth_handler.py +268 -0
  25. google/adk/auth/auth_preprocessor.py +116 -0
  26. google/adk/auth/auth_schemes.py +67 -0
  27. google/adk/auth/auth_tool.py +55 -0
  28. google/adk/cli/__init__.py +15 -0
  29. google/adk/cli/__main__.py +18 -0
  30. google/adk/cli/agent_graph.py +148 -0
  31. google/adk/cli/browser/adk_favicon.svg +17 -0
  32. google/adk/cli/browser/assets/audio-processor.js +51 -0
  33. google/adk/cli/browser/assets/config/runtime-config.json +3 -0
  34. google/adk/cli/browser/index.html +33 -0
  35. google/adk/cli/browser/main-SY2WYYGV.js +75 -0
  36. google/adk/cli/browser/polyfills-FFHMD2TL.js +18 -0
  37. google/adk/cli/browser/styles-4VDSPQ37.css +17 -0
  38. google/adk/cli/cli.py +181 -0
  39. google/adk/cli/cli_deploy.py +181 -0
  40. google/adk/cli/cli_eval.py +282 -0
  41. google/adk/cli/cli_tools_click.py +524 -0
  42. google/adk/cli/fast_api.py +784 -0
  43. google/adk/cli/utils/__init__.py +49 -0
  44. google/adk/cli/utils/envs.py +57 -0
  45. google/adk/cli/utils/evals.py +93 -0
  46. google/adk/cli/utils/logs.py +72 -0
  47. google/adk/code_executors/__init__.py +49 -0
  48. google/adk/code_executors/base_code_executor.py +97 -0
  49. google/adk/code_executors/code_execution_utils.py +256 -0
  50. google/adk/code_executors/code_executor_context.py +202 -0
  51. google/adk/code_executors/container_code_executor.py +196 -0
  52. google/adk/code_executors/unsafe_local_code_executor.py +71 -0
  53. google/adk/code_executors/vertex_ai_code_executor.py +234 -0
  54. google/adk/docs/Makefile +20 -0
  55. google/adk/docs/build/doctrees/google-adk.doctree +0 -0
  56. google/adk/docs/build/html/_sources/google-adk.rst.txt +98 -0
  57. google/adk/docs/build/html/_sources/index.rst.txt +7 -0
  58. google/adk/docs/build/html/_static/autodoc_pydantic.css +27 -0
  59. google/adk/docs/build/html/_static/basic.css +925 -0
  60. google/adk/docs/build/html/_static/debug.css +85 -0
  61. google/adk/docs/build/html/_static/doctools.js +156 -0
  62. google/adk/docs/build/html/_static/documentation_options.js +29 -0
  63. google/adk/docs/build/html/_static/file.png +0 -0
  64. google/adk/docs/build/html/_static/language_data.js +199 -0
  65. google/adk/docs/build/html/_static/minus.png +0 -0
  66. google/adk/docs/build/html/_static/plus.png +0 -0
  67. google/adk/docs/build/html/_static/pygments.css +274 -0
  68. google/adk/docs/build/html/_static/scripts/furo-extensions.js +16 -0
  69. google/adk/docs/build/html/_static/scripts/furo.js +19 -0
  70. google/adk/docs/build/html/_static/scripts/furo.js.LICENSE.txt +7 -0
  71. google/adk/docs/build/html/_static/scripts/furo.js.map +1 -0
  72. google/adk/docs/build/html/_static/searchtools.js +620 -0
  73. google/adk/docs/build/html/_static/skeleton.css +312 -0
  74. google/adk/docs/build/html/_static/sphinx_highlight.js +170 -0
  75. google/adk/docs/build/html/_static/styles/furo-extensions.css +18 -0
  76. google/adk/docs/build/html/_static/styles/furo-extensions.css.map +1 -0
  77. google/adk/docs/build/html/_static/styles/furo.css +18 -0
  78. google/adk/docs/build/html/_static/styles/furo.css.map +1 -0
  79. google/adk/docs/build/html/genindex.html +861 -0
  80. google/adk/docs/build/html/google-adk.html +5461 -0
  81. google/adk/docs/build/html/index.html +567 -0
  82. google/adk/docs/build/html/objects.inv +0 -0
  83. google/adk/docs/build/html/py-modindex.html +373 -0
  84. google/adk/docs/build/html/search.html +333 -0
  85. google/adk/docs/build/html/searchindex.js +17 -0
  86. google/adk/docs/source/conf.py +133 -0
  87. google/adk/docs/source/google-adk.rst +98 -0
  88. google/adk/docs/source/index.rst +7 -0
  89. google/adk/evaluation/__init__.py +31 -0
  90. google/adk/evaluation/agent_evaluator.py +329 -0
  91. google/adk/evaluation/evaluation_constants.py +24 -0
  92. google/adk/evaluation/evaluation_generator.py +270 -0
  93. google/adk/evaluation/response_evaluator.py +135 -0
  94. google/adk/evaluation/trajectory_evaluator.py +184 -0
  95. google/adk/events/__init__.py +21 -0
  96. google/adk/events/event.py +130 -0
  97. google/adk/events/event_actions.py +55 -0
  98. google/adk/examples/__init__.py +28 -0
  99. google/adk/examples/base_example_provider.py +35 -0
  100. google/adk/examples/example.py +27 -0
  101. google/adk/examples/example_util.py +123 -0
  102. google/adk/examples/vertex_ai_example_store.py +104 -0
  103. google/adk/flows/__init__.py +14 -0
  104. google/adk/flows/llm_flows/__init__.py +20 -0
  105. google/adk/flows/llm_flows/_base_llm_processor.py +52 -0
  106. google/adk/flows/llm_flows/_code_execution.py +458 -0
  107. google/adk/flows/llm_flows/_nl_planning.py +129 -0
  108. google/adk/flows/llm_flows/agent_transfer.py +132 -0
  109. google/adk/flows/llm_flows/audio_transcriber.py +109 -0
  110. google/adk/flows/llm_flows/auto_flow.py +49 -0
  111. google/adk/flows/llm_flows/base_llm_flow.py +559 -0
  112. google/adk/flows/llm_flows/basic.py +72 -0
  113. google/adk/flows/llm_flows/contents.py +370 -0
  114. google/adk/flows/llm_flows/functions.py +486 -0
  115. google/adk/flows/llm_flows/identity.py +47 -0
  116. google/adk/flows/llm_flows/instructions.py +137 -0
  117. google/adk/flows/llm_flows/single_flow.py +57 -0
  118. google/adk/memory/__init__.py +35 -0
  119. google/adk/memory/base_memory_service.py +74 -0
  120. google/adk/memory/in_memory_memory_service.py +62 -0
  121. google/adk/memory/vertex_ai_rag_memory_service.py +177 -0
  122. google/adk/models/__init__.py +31 -0
  123. google/adk/models/anthropic_llm.py +243 -0
  124. google/adk/models/base_llm.py +87 -0
  125. google/adk/models/base_llm_connection.py +76 -0
  126. google/adk/models/gemini_llm_connection.py +200 -0
  127. google/adk/models/google_llm.py +331 -0
  128. google/adk/models/lite_llm.py +673 -0
  129. google/adk/models/llm_request.py +98 -0
  130. google/adk/models/llm_response.py +111 -0
  131. google/adk/models/registry.py +102 -0
  132. google/adk/planners/__init__.py +23 -0
  133. google/adk/planners/base_planner.py +66 -0
  134. google/adk/planners/built_in_planner.py +75 -0
  135. google/adk/planners/plan_re_act_planner.py +208 -0
  136. google/adk/runners.py +456 -0
  137. google/adk/sessions/__init__.py +41 -0
  138. google/adk/sessions/base_session_service.py +133 -0
  139. google/adk/sessions/database_session_service.py +522 -0
  140. google/adk/sessions/in_memory_session_service.py +206 -0
  141. google/adk/sessions/session.py +54 -0
  142. google/adk/sessions/state.py +71 -0
  143. google/adk/sessions/vertex_ai_session_service.py +356 -0
  144. google/adk/telemetry.py +189 -0
  145. google/adk/tests/__init__.py +14 -0
  146. google/adk/tests/integration/.env.example +10 -0
  147. google/adk/tests/integration/__init__.py +18 -0
  148. google/adk/tests/integration/conftest.py +119 -0
  149. google/adk/tests/integration/fixture/__init__.py +14 -0
  150. google/adk/tests/integration/fixture/agent_with_config/__init__.py +15 -0
  151. google/adk/tests/integration/fixture/agent_with_config/agent.py +88 -0
  152. google/adk/tests/integration/fixture/callback_agent/__init__.py +15 -0
  153. google/adk/tests/integration/fixture/callback_agent/agent.py +105 -0
  154. google/adk/tests/integration/fixture/context_update_test/OWNERS +1 -0
  155. google/adk/tests/integration/fixture/context_update_test/__init__.py +15 -0
  156. google/adk/tests/integration/fixture/context_update_test/agent.py +43 -0
  157. google/adk/tests/integration/fixture/context_update_test/successful_test.session.json +582 -0
  158. google/adk/tests/integration/fixture/context_variable_agent/__init__.py +15 -0
  159. google/adk/tests/integration/fixture/context_variable_agent/agent.py +115 -0
  160. google/adk/tests/integration/fixture/customer_support_ma/__init__.py +15 -0
  161. google/adk/tests/integration/fixture/customer_support_ma/agent.py +172 -0
  162. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/__init__.py +15 -0
  163. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/agent.py +338 -0
  164. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/order_query.test.json +69 -0
  165. google/adk/tests/integration/fixture/ecommerce_customer_service_agent/test_config.json +6 -0
  166. google/adk/tests/integration/fixture/flow_complex_spark/__init__.py +15 -0
  167. google/adk/tests/integration/fixture/flow_complex_spark/agent.py +182 -0
  168. google/adk/tests/integration/fixture/flow_complex_spark/sample.session.json +190 -0
  169. google/adk/tests/integration/fixture/hello_world_agent/__init__.py +15 -0
  170. google/adk/tests/integration/fixture/hello_world_agent/agent.py +95 -0
  171. google/adk/tests/integration/fixture/hello_world_agent/roll_die.test.json +24 -0
  172. google/adk/tests/integration/fixture/hello_world_agent/test_config.json +6 -0
  173. google/adk/tests/integration/fixture/home_automation_agent/__init__.py +15 -0
  174. google/adk/tests/integration/fixture/home_automation_agent/agent.py +304 -0
  175. google/adk/tests/integration/fixture/home_automation_agent/simple_test.test.json +5 -0
  176. google/adk/tests/integration/fixture/home_automation_agent/simple_test2.test.json +5 -0
  177. google/adk/tests/integration/fixture/home_automation_agent/test_config.json +5 -0
  178. google/adk/tests/integration/fixture/home_automation_agent/test_files/dependent_tool_calls.test.json +18 -0
  179. google/adk/tests/integration/fixture/home_automation_agent/test_files/memorizing_past_events/eval_data.test.json +17 -0
  180. google/adk/tests/integration/fixture/home_automation_agent/test_files/memorizing_past_events/test_config.json +6 -0
  181. google/adk/tests/integration/fixture/home_automation_agent/test_files/simple_multi_turn_conversation.test.json +18 -0
  182. google/adk/tests/integration/fixture/home_automation_agent/test_files/simple_test.test.json +17 -0
  183. google/adk/tests/integration/fixture/home_automation_agent/test_files/simple_test2.test.json +5 -0
  184. google/adk/tests/integration/fixture/home_automation_agent/test_files/test_config.json +5 -0
  185. google/adk/tests/integration/fixture/tool_agent/__init__.py +15 -0
  186. google/adk/tests/integration/fixture/tool_agent/agent.py +218 -0
  187. google/adk/tests/integration/fixture/tool_agent/files/Agent_test_plan.pdf +0 -0
  188. google/adk/tests/integration/fixture/trip_planner_agent/__init__.py +15 -0
  189. google/adk/tests/integration/fixture/trip_planner_agent/agent.py +110 -0
  190. google/adk/tests/integration/fixture/trip_planner_agent/initial.session.json +13 -0
  191. google/adk/tests/integration/fixture/trip_planner_agent/test_config.json +5 -0
  192. google/adk/tests/integration/fixture/trip_planner_agent/test_files/initial.session.json +13 -0
  193. google/adk/tests/integration/fixture/trip_planner_agent/test_files/test_config.json +5 -0
  194. google/adk/tests/integration/fixture/trip_planner_agent/test_files/trip_inquiry_sub_agent.test.json +7 -0
  195. google/adk/tests/integration/fixture/trip_planner_agent/trip_inquiry.test.json +19 -0
  196. google/adk/tests/integration/models/__init__.py +14 -0
  197. google/adk/tests/integration/models/test_google_llm.py +65 -0
  198. google/adk/tests/integration/test_callback.py +70 -0
  199. google/adk/tests/integration/test_context_variable.py +67 -0
  200. google/adk/tests/integration/test_evalute_agent_in_fixture.py +76 -0
  201. google/adk/tests/integration/test_multi_agent.py +28 -0
  202. google/adk/tests/integration/test_multi_turn.py +42 -0
  203. google/adk/tests/integration/test_single_agent.py +23 -0
  204. google/adk/tests/integration/test_sub_agent.py +26 -0
  205. google/adk/tests/integration/test_system_instruction.py +177 -0
  206. google/adk/tests/integration/test_tools.py +287 -0
  207. google/adk/tests/integration/test_with_test_file.py +34 -0
  208. google/adk/tests/integration/tools/__init__.py +14 -0
  209. google/adk/tests/integration/utils/__init__.py +16 -0
  210. google/adk/tests/integration/utils/asserts.py +75 -0
  211. google/adk/tests/integration/utils/test_runner.py +97 -0
  212. google/adk/tests/unittests/__init__.py +14 -0
  213. google/adk/tests/unittests/agents/__init__.py +14 -0
  214. google/adk/tests/unittests/agents/test_base_agent.py +407 -0
  215. google/adk/tests/unittests/agents/test_langgraph_agent.py +191 -0
  216. google/adk/tests/unittests/agents/test_llm_agent_callbacks.py +138 -0
  217. google/adk/tests/unittests/agents/test_llm_agent_fields.py +231 -0
  218. google/adk/tests/unittests/agents/test_loop_agent.py +136 -0
  219. google/adk/tests/unittests/agents/test_parallel_agent.py +92 -0
  220. google/adk/tests/unittests/agents/test_sequential_agent.py +114 -0
  221. google/adk/tests/unittests/artifacts/__init__.py +14 -0
  222. google/adk/tests/unittests/artifacts/test_artifact_service.py +276 -0
  223. google/adk/tests/unittests/auth/test_auth_handler.py +575 -0
  224. google/adk/tests/unittests/conftest.py +73 -0
  225. google/adk/tests/unittests/fast_api/__init__.py +14 -0
  226. google/adk/tests/unittests/fast_api/test_fast_api.py +269 -0
  227. google/adk/tests/unittests/flows/__init__.py +14 -0
  228. google/adk/tests/unittests/flows/llm_flows/__init__.py +14 -0
  229. google/adk/tests/unittests/flows/llm_flows/_test_examples.py +142 -0
  230. google/adk/tests/unittests/flows/llm_flows/test_agent_transfer.py +311 -0
  231. google/adk/tests/unittests/flows/llm_flows/test_functions_long_running.py +244 -0
  232. google/adk/tests/unittests/flows/llm_flows/test_functions_request_euc.py +346 -0
  233. google/adk/tests/unittests/flows/llm_flows/test_functions_sequential.py +93 -0
  234. google/adk/tests/unittests/flows/llm_flows/test_functions_simple.py +258 -0
  235. google/adk/tests/unittests/flows/llm_flows/test_identity.py +66 -0
  236. google/adk/tests/unittests/flows/llm_flows/test_instructions.py +164 -0
  237. google/adk/tests/unittests/flows/llm_flows/test_model_callbacks.py +142 -0
  238. google/adk/tests/unittests/flows/llm_flows/test_other_configs.py +46 -0
  239. google/adk/tests/unittests/flows/llm_flows/test_tool_callbacks.py +269 -0
  240. google/adk/tests/unittests/models/__init__.py +14 -0
  241. google/adk/tests/unittests/models/test_google_llm.py +224 -0
  242. google/adk/tests/unittests/models/test_litellm.py +804 -0
  243. google/adk/tests/unittests/models/test_models.py +60 -0
  244. google/adk/tests/unittests/sessions/__init__.py +14 -0
  245. google/adk/tests/unittests/sessions/test_session_service.py +227 -0
  246. google/adk/tests/unittests/sessions/test_vertex_ai_session_service.py +246 -0
  247. google/adk/tests/unittests/streaming/__init__.py +14 -0
  248. google/adk/tests/unittests/streaming/test_streaming.py +50 -0
  249. google/adk/tests/unittests/tools/__init__.py +14 -0
  250. google/adk/tests/unittests/tools/apihub_tool/clients/test_apihub_client.py +499 -0
  251. google/adk/tests/unittests/tools/apihub_tool/test_apihub_toolset.py +204 -0
  252. google/adk/tests/unittests/tools/application_integration_tool/clients/test_connections_client.py +600 -0
  253. google/adk/tests/unittests/tools/application_integration_tool/clients/test_integration_client.py +630 -0
  254. google/adk/tests/unittests/tools/application_integration_tool/test_application_integration_toolset.py +345 -0
  255. google/adk/tests/unittests/tools/google_api_tool/__init__.py +13 -0
  256. google/adk/tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py +657 -0
  257. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_auto_auth_credential_exchanger.py +145 -0
  258. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_base_auth_credential_exchanger.py +68 -0
  259. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_oauth2_exchanger.py +153 -0
  260. google/adk/tests/unittests/tools/openapi_tool/auth/credential_exchangers/test_service_account_exchanger.py +196 -0
  261. google/adk/tests/unittests/tools/openapi_tool/auth/test_auth_helper.py +573 -0
  262. google/adk/tests/unittests/tools/openapi_tool/common/test_common.py +436 -0
  263. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test.yaml +1367 -0
  264. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_openapi_spec_parser.py +628 -0
  265. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_openapi_toolset.py +139 -0
  266. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_operation_parser.py +406 -0
  267. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_rest_api_tool.py +966 -0
  268. google/adk/tests/unittests/tools/openapi_tool/openapi_spec_parser/test_tool_auth_handler.py +201 -0
  269. google/adk/tests/unittests/tools/retrieval/__init__.py +14 -0
  270. google/adk/tests/unittests/tools/retrieval/test_vertex_ai_rag_retrieval.py +147 -0
  271. google/adk/tests/unittests/tools/test_agent_tool.py +167 -0
  272. google/adk/tests/unittests/tools/test_base_tool.py +141 -0
  273. google/adk/tests/unittests/tools/test_build_function_declaration.py +277 -0
  274. google/adk/tests/unittests/utils.py +304 -0
  275. google/adk/tools/__init__.py +51 -0
  276. google/adk/tools/_automatic_function_calling_util.py +346 -0
  277. google/adk/tools/agent_tool.py +176 -0
  278. google/adk/tools/apihub_tool/__init__.py +19 -0
  279. google/adk/tools/apihub_tool/apihub_toolset.py +209 -0
  280. google/adk/tools/apihub_tool/clients/__init__.py +13 -0
  281. google/adk/tools/apihub_tool/clients/apihub_client.py +332 -0
  282. google/adk/tools/apihub_tool/clients/secret_client.py +115 -0
  283. google/adk/tools/application_integration_tool/__init__.py +19 -0
  284. google/adk/tools/application_integration_tool/application_integration_toolset.py +230 -0
  285. google/adk/tools/application_integration_tool/clients/connections_client.py +903 -0
  286. google/adk/tools/application_integration_tool/clients/integration_client.py +253 -0
  287. google/adk/tools/base_tool.py +144 -0
  288. google/adk/tools/built_in_code_execution_tool.py +59 -0
  289. google/adk/tools/crewai_tool.py +72 -0
  290. google/adk/tools/example_tool.py +62 -0
  291. google/adk/tools/exit_loop_tool.py +23 -0
  292. google/adk/tools/function_parameter_parse_util.py +307 -0
  293. google/adk/tools/function_tool.py +87 -0
  294. google/adk/tools/get_user_choice_tool.py +28 -0
  295. google/adk/tools/google_api_tool/__init__.py +14 -0
  296. google/adk/tools/google_api_tool/google_api_tool.py +59 -0
  297. google/adk/tools/google_api_tool/google_api_tool_set.py +107 -0
  298. google/adk/tools/google_api_tool/google_api_tool_sets.py +55 -0
  299. google/adk/tools/google_api_tool/googleapi_to_openapi_converter.py +521 -0
  300. google/adk/tools/google_search_tool.py +68 -0
  301. google/adk/tools/langchain_tool.py +86 -0
  302. google/adk/tools/load_artifacts_tool.py +113 -0
  303. google/adk/tools/load_memory_tool.py +58 -0
  304. google/adk/tools/load_web_page.py +41 -0
  305. google/adk/tools/long_running_tool.py +39 -0
  306. google/adk/tools/mcp_tool/__init__.py +42 -0
  307. google/adk/tools/mcp_tool/conversion_utils.py +161 -0
  308. google/adk/tools/mcp_tool/mcp_tool.py +113 -0
  309. google/adk/tools/mcp_tool/mcp_toolset.py +272 -0
  310. google/adk/tools/openapi_tool/__init__.py +21 -0
  311. google/adk/tools/openapi_tool/auth/__init__.py +19 -0
  312. google/adk/tools/openapi_tool/auth/auth_helpers.py +498 -0
  313. google/adk/tools/openapi_tool/auth/credential_exchangers/__init__.py +25 -0
  314. google/adk/tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.py +105 -0
  315. google/adk/tools/openapi_tool/auth/credential_exchangers/base_credential_exchanger.py +55 -0
  316. google/adk/tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.py +117 -0
  317. google/adk/tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.py +97 -0
  318. google/adk/tools/openapi_tool/common/__init__.py +19 -0
  319. google/adk/tools/openapi_tool/common/common.py +300 -0
  320. google/adk/tools/openapi_tool/openapi_spec_parser/__init__.py +32 -0
  321. google/adk/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.py +231 -0
  322. google/adk/tools/openapi_tool/openapi_spec_parser/openapi_toolset.py +144 -0
  323. google/adk/tools/openapi_tool/openapi_spec_parser/operation_parser.py +260 -0
  324. google/adk/tools/openapi_tool/openapi_spec_parser/rest_api_tool.py +496 -0
  325. google/adk/tools/openapi_tool/openapi_spec_parser/tool_auth_handler.py +268 -0
  326. google/adk/tools/preload_memory_tool.py +72 -0
  327. google/adk/tools/retrieval/__init__.py +36 -0
  328. google/adk/tools/retrieval/base_retrieval_tool.py +37 -0
  329. google/adk/tools/retrieval/files_retrieval.py +33 -0
  330. google/adk/tools/retrieval/llama_index_retrieval.py +41 -0
  331. google/adk/tools/retrieval/vertex_ai_rag_retrieval.py +107 -0
  332. google/adk/tools/tool_context.py +90 -0
  333. google/adk/tools/toolbox_tool.py +46 -0
  334. google/adk/tools/transfer_to_agent_tool.py +21 -0
  335. google/adk/tools/vertex_ai_search_tool.py +96 -0
  336. google/adk/version.py +16 -0
  337. google_adk-0.0.3.dist-info/METADATA +73 -0
  338. google_adk-0.0.3.dist-info/RECORD +340 -0
  339. {google_adk-0.0.1.dist-info → google_adk-0.0.3.dist-info}/WHEEL +1 -2
  340. google_adk-0.0.3.dist-info/entry_points.txt +3 -0
  341. agent_kit/__init__.py +0 -0
  342. google_adk-0.0.1.dist-info/LICENSE.txt +0 -170
  343. google_adk-0.0.1.dist-info/METADATA +0 -15
  344. google_adk-0.0.1.dist-info/RECORD +0 -6
  345. google_adk-0.0.1.dist-info/top_level.txt +0 -1
google/adk/docs/build/html/search.html ADDED
@@ -0,0 +1,333 @@
1
+ <!doctype html>
2
+ <!--
3
+ Copyright 2025 Google LLC
4
+
5
+ Licensed under the Apache License, Version 2.0 (the "License");
6
+ you may not use this file except in compliance with the License.
7
+ You may obtain a copy of the License at
8
+
9
+ http://www.apache.org/licenses/LICENSE-2.0
10
+
11
+ Unless required by applicable law or agreed to in writing, software
12
+ distributed under the License is distributed on an "AS IS" BASIS,
13
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ See the License for the specific language governing permissions and
15
+ limitations under the License.
16
+ -->
17
+
18
+ <html class="no-js" lang="en" data-content_root="./">
19
+ <head>
20
+ <meta charset="utf-8"/>
21
+ <meta name="viewport" content="width=device-width,initial-scale=1"/>
22
+ <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="#" />
23
+
24
+ <!-- Generated with Sphinx 7.4.7 and Furo 2024.08.06 -->
25
+ <meta name="robots" content="noindex" />
26
+ <title>Search - Agent Development Kit documentation</title><link rel="stylesheet" type="text/css" href="_static/pygments.css?v=8f2a1f02" />
27
+ <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
28
+ <link rel="stylesheet" type="text/css" href="_static/autodoc_pydantic.css" />
29
+ <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=302659d7" />
30
+ <link rel="stylesheet" type="text/css" href="_static/css/custom.css" />
31
+
32
+
33
+
34
+
35
+ <style>
36
+ body {
37
+ --color-code-background: #f8f8f8;
38
+ --color-code-foreground: black;
39
+ --font-stack: "Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif;
40
+ --font-stack--monospace: Roboto Mono, "Helvetica Neue Mono", monospace;
41
+ --font-stack--headings: "Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif;
42
+ --color-brand-primary: black;
43
+ --color-brand-content: black;
44
+
45
+ }
46
+ @media not print {
47
+ body[data-theme="dark"] {
48
+ --color-code-background: #202020;
49
+ --color-code-foreground: #d0d0d0;
50
+ --font-stack: "Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif;
51
+ --font-stack--monospace: Roboto Mono, "Helvetica Neue Mono", monospace;
52
+ --font-stack--headings: "Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif;
53
+ --color-brand-primary: white;
54
+ --color-brand-content: white;
55
+
56
+ }
57
+ @media (prefers-color-scheme: dark) {
58
+ body:not([data-theme="light"]) {
59
+ --color-code-background: #202020;
60
+ --color-code-foreground: #d0d0d0;
61
+ --font-stack: "Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif;
62
+ --font-stack--monospace: Roboto Mono, "Helvetica Neue Mono", monospace;
63
+ --font-stack--headings: "Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif;
64
+ --color-brand-primary: white;
65
+ --color-brand-content: white;
66
+
67
+ }
68
+ }
69
+ }
70
+ </style></head>
71
+ <body>
72
+
73
+ <script>
74
+ document.body.dataset.theme = localStorage.getItem("theme") || "auto";
75
+ </script>
76
+
77
+
78
+ <svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
79
+ <symbol id="svg-toc" viewBox="0 0 24 24">
80
+ <title>Contents</title>
81
+ <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
82
+ <path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
83
+ </svg>
84
+ </symbol>
85
+ <symbol id="svg-menu" viewBox="0 0 24 24">
86
+ <title>Menu</title>
87
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
88
+ stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
89
+ <line x1="3" y1="12" x2="21" y2="12"></line>
90
+ <line x1="3" y1="6" x2="21" y2="6"></line>
91
+ <line x1="3" y1="18" x2="21" y2="18"></line>
92
+ </svg>
93
+ </symbol>
94
+ <symbol id="svg-arrow-right" viewBox="0 0 24 24">
95
+ <title>Expand</title>
96
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
97
+ stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
98
+ <polyline points="9 18 15 12 9 6"></polyline>
99
+ </svg>
100
+ </symbol>
101
+ <symbol id="svg-sun" viewBox="0 0 24 24">
102
+ <title>Light mode</title>
103
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
104
+ stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
105
+ <circle cx="12" cy="12" r="5"></circle>
106
+ <line x1="12" y1="1" x2="12" y2="3"></line>
107
+ <line x1="12" y1="21" x2="12" y2="23"></line>
108
+ <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
109
+ <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
110
+ <line x1="1" y1="12" x2="3" y2="12"></line>
111
+ <line x1="21" y1="12" x2="23" y2="12"></line>
112
+ <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
113
+ <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
114
+ </svg>
115
+ </symbol>
116
+ <symbol id="svg-moon" viewBox="0 0 24 24">
117
+ <title>Dark mode</title>
118
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
119
+ stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
120
+ <path stroke="none" d="M0 0h24v24H0z" fill="none" />
121
+ <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
122
+ </svg>
123
+ </symbol>
124
+ <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
125
+ <title>Auto light/dark, in light mode</title>
126
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
127
+ stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
128
+ class="icon-custom-derived-from-feather-sun-and-tabler-moon">
129
+ <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
130
+ <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
131
+ <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
132
+ <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
133
+ <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
134
+ <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
135
+ <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
136
+ <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
137
+ <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
138
+ <circle cx="14.5" cy="9.55" r="3.6"/>
139
+ </svg>
140
+ </symbol>
141
+ <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
142
+ <title>Auto light/dark, in dark mode</title>
143
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
144
+ stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
145
+ class="icon-custom-derived-from-feather-sun-and-tabler-moon">
146
+ <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
147
+ <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
148
+ <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
149
+ <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
150
+ <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
151
+ <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
152
+ <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
153
+ <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
154
+ <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
155
+ <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
156
+ </svg>
157
+ </symbol>
158
+ <symbol id="svg-pencil" viewBox="0 0 24 24">
159
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
160
+ stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-pencil-code">
161
+ <path d="M4 20h4l10.5 -10.5a2.828 2.828 0 1 0 -4 -4l-10.5 10.5v4" />
162
+ <path d="M13.5 6.5l4 4" />
163
+ <path d="M20 21l2 -2l-2 -2" />
164
+ <path d="M17 17l-2 2l2 2" />
165
+ </svg>
166
+ </symbol>
167
+ <symbol id="svg-eye" viewBox="0 0 24 24">
168
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
169
+ stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-eye-code">
170
+ <path stroke="none" d="M0 0h24v24H0z" fill="none" />
171
+ <path d="M10 12a2 2 0 1 0 4 0a2 2 0 0 0 -4 0" />
172
+ <path
173
+ d="M11.11 17.958c-3.209 -.307 -5.91 -2.293 -8.11 -5.958c2.4 -4 5.4 -6 9 -6c3.6 0 6.6 2 9 6c-.21 .352 -.427 .688 -.647 1.008" />
174
+ <path d="M20 21l2 -2l-2 -2" />
175
+ <path d="M17 17l-2 2l2 2" />
176
+ </svg>
177
+ </symbol>
178
+ </svg>
179
+
180
+ <input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
181
+ <input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
182
+ <label class="overlay sidebar-overlay" for="__navigation">
183
+ <div class="visually-hidden">Hide navigation sidebar</div>
184
+ </label>
185
+ <label class="overlay toc-overlay" for="__toc">
186
+ <div class="visually-hidden">Hide table of contents sidebar</div>
187
+ </label>
188
+
189
+ <a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
190
+
191
+
192
+
193
+ <div class="page">
194
+ <header class="mobile-header">
195
+ <div class="header-left">
196
+ <label class="nav-overlay-icon" for="__navigation">
197
+ <div class="visually-hidden">Toggle site navigation sidebar</div>
198
+ <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
199
+ </label>
200
+ </div>
201
+ <div class="header-center">
202
+ <a href="index.html"><div class="brand">Agent Development Kit documentation</div></a>
203
+ </div>
204
+ <div class="header-right">
205
+ <div class="theme-toggle-container theme-toggle-header">
206
+ <button class="theme-toggle">
207
+ <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
208
+ <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
209
+ <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
210
+ <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
211
+ <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
212
+ </button>
213
+ </div>
214
+ <label class="toc-overlay-icon toc-header-icon no-toc" for="__toc">
215
+ <div class="visually-hidden">Toggle table of contents sidebar</div>
216
+ <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
217
+ </label>
218
+ </div>
219
+ </header>
220
+ <aside class="sidebar-drawer">
221
+ <div class="sidebar-container">
222
+
223
+ <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
224
+
225
+
226
+ <span class="sidebar-brand-text">Agent Development Kit documentation</span>
227
+
228
+ </a><form class="sidebar-search-container" method="get" action="#" role="search">
229
+ <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
230
+ <input type="hidden" name="check_keywords" value="yes">
231
+ <input type="hidden" name="area" value="default">
232
+ </form>
233
+ <div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
234
+ <ul>
235
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html">Submodules</a></li>
236
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#google-adk-agents-module">google.adk.agents module</a></li>
237
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#module-google.adk.artifacts">google.adk.artifacts module</a></li>
238
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#module-google.adk.code_executors">google.adk.code_executors module</a></li>
239
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#google-adk-evaluation-module">google.adk.evaluation module</a></li>
240
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#module-google.adk.events">google.adk.events module</a></li>
241
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#module-google.adk.examples">google.adk.examples module</a></li>
242
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#module-google.adk.memory">google.adk.memory module</a></li>
243
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#google-adk-models-module">google.adk.models module</a></li>
244
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#google-adk-planners-module">google.adk.planners module</a></li>
245
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#google-adk-runners-module">google.adk.runners module</a></li>
246
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#module-google.adk.sessions">google.adk.sessions module</a></li>
247
+ <li class="toctree-l1"><a class="reference internal" href="google-adk.html#google-adk-tools-module">google.adk.tools module</a></li>
248
+ </ul>
249
+
250
+ </div>
251
+ </div>
252
+
253
+ </div>
254
+
255
+ </div>
256
+ </aside>
257
+ <div class="main">
258
+ <div class="content">
259
+ <div class="article-container">
260
+ <a href="#" class="back-to-top muted-link">
261
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
262
+ <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
263
+ </svg>
264
+ <span>Back to top</span>
265
+ </a>
266
+ <div class="content-icon-container">
267
+ <div class="theme-toggle-container theme-toggle-content">
268
+ <button class="theme-toggle">
269
+ <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
270
+ <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
271
+ <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
272
+ <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
273
+ <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
274
+ </button>
275
+ </div>
276
+ <label class="toc-overlay-icon toc-content-icon no-toc" for="__toc">
277
+ <div class="visually-hidden">Toggle table of contents sidebar</div>
278
+ <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
279
+ </label>
280
+ </div>
281
+ <article role="main" id="furo-main-content">
282
+
283
+ <noscript>
284
+ <div class="admonition error">
285
+ <p class="admonition-title">Error</p>
286
+ <p>
287
+ Please activate JavaScript to enable the search functionality.
288
+ </p>
289
+ </div>
290
+ </noscript>
291
+
292
+ <div id="search-results"></div>
293
+
294
+ </article>
295
+ </div>
296
+ <footer>
297
+
298
+ <div class="related-pages">
299
+
300
+
301
+ </div>
302
+ <div class="bottom-of-page">
303
+ <div class="left-details">
304
+ <div class="copyright">
305
+ Copyright &#169; 2025, Google
306
+ </div>
307
+ Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
308
+
309
+ <a href="https://github.com/pradyunsg/furo">Furo</a>
310
+
311
+ </div>
312
+ <div class="right-details">
313
+
314
+ </div>
315
+ </div>
316
+
317
+ </footer>
318
+ </div>
319
+ <aside class="toc-drawer no-toc">
320
+
321
+
322
+
323
+ </aside>
324
+ </div>
325
+ </div><script src="_static/documentation_options.js?v=5929fcd5"></script>
326
+ <script src="_static/doctools.js?v=9a2dae69"></script>
327
+ <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
328
+ <script src="_static/scripts/furo.js?v=5fa4622c"></script>
329
+
330
+ <script src="_static/searchtools.js"></script>
331
+ <script src="_static/language_data.js"></script>
332
+ <script src="searchindex.js"></script></body>
333
+ </html>
google/adk/docs/build/html/searchindex.js ADDED
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Copyright 2025 Google LLC
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * http://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+
17
+ Search.setIndex({"alltitles": {"Submodules": [[0, null]], "google": [[1, null]], "google.adk.agents module": [[0, "google-adk-agents-module"]], "google.adk.artifacts module": [[0, "module-google.adk.artifacts"]], "google.adk.code_executors module": [[0, "module-google.adk.code_executors"]], "google.adk.evaluation module": [[0, "google-adk-evaluation-module"]], "google.adk.events module": [[0, "module-google.adk.events"]], "google.adk.examples module": [[0, "module-google.adk.examples"]], "google.adk.memory module": [[0, "module-google.adk.memory"]], "google.adk.models module": [[0, "google-adk-models-module"]], "google.adk.planners module": [[0, "google-adk-planners-module"]], "google.adk.runners module": [[0, "google-adk-runners-module"]], "google.adk.sessions module": [[0, "module-google.adk.sessions"]], "google.adk.tools module": [[0, "google-adk-tools-module"]]}, "docnames": ["google-adk", "index"], "envversion": {"sphinx": 62, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["google-adk.rst", "index.rst"], "indexentries": {"actions (google.adk.events.event attribute)": [[0, "google.adk.events.Event.actions", false], [0, "id0", false]], "add_input_files() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.add_input_files", false]], "add_processed_file_names() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.add_processed_file_names", false]], "add_session_to_memory() (google.adk.memory.basememoryservice method)": [[0, "google.adk.memory.BaseMemoryService.add_session_to_memory", false]], "add_session_to_memory() (google.adk.memory.inmemorymemoryservice method)": [[0, "google.adk.memory.InMemoryMemoryService.add_session_to_memory", false]], "add_session_to_memory() (google.adk.memory.vertexairagmemoryservice method)": [[0, "google.adk.memory.VertexAiRagMemoryService.add_session_to_memory", false]], "app_name (google.adk.sessions.session attribute)": [[0, "google.adk.sessions.Session.app_name", false], [0, "id19", false]], "app_prefix (google.adk.sessions.state attribute)": [[0, "google.adk.sessions.State.APP_PREFIX", false]], "app_state (google.adk.sessions.inmemorysessionservice attribute)": [[0, "google.adk.sessions.InMemorySessionService.app_state", false]], "append_event() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.append_event", false]], "append_event() (google.adk.sessions.databasesessionservice method)": [[0, "google.adk.sessions.DatabaseSessionService.append_event", false]], "append_event() (google.adk.sessions.inmemorysessionservice method)": [[0, "google.adk.sessions.InMemorySessionService.append_event", false]], "append_event() (google.adk.sessions.vertexaisessionservice method)": [[0, "google.adk.sessions.VertexAiSessionService.append_event", false]], "artifact_delta (google.adk.events.eventactions attribute)": [[0, "google.adk.events.EventActions.artifact_delta", false]], "artifacts (google.adk.artifacts.inmemoryartifactservice attribute)": [[0, "google.adk.artifacts.InMemoryArtifactService.artifacts", false]], "author (google.adk.events.event attribute)": [[0, "google.adk.events.Event.author", false], [0, "id9", false]], "base_url (google.adk.code_executors.containercodeexecutor attribute)": [[0, "google.adk.code_executors.ContainerCodeExecutor.base_url", false]], "baseartifactservice (class in google.adk.artifacts)": [[0, "google.adk.artifacts.BaseArtifactService", false]], "baseexampleprovider (class in google.adk.examples)": [[0, "google.adk.examples.BaseExampleProvider", false]], "basememoryservice (class in google.adk.memory)": [[0, "google.adk.memory.BaseMemoryService", false]], "basesessionservice (class in google.adk.sessions)": [[0, "google.adk.sessions.BaseSessionService", false]], "branch (google.adk.events.event attribute)": [[0, "google.adk.events.Event.branch", false], [0, "id10", false]], "clear_input_files() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.clear_input_files", false]], "close_session() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.close_session", false]], "code_block_delimiters (google.adk.code_executors.basecodeexecutor attribute)": [[0, "google.adk.code_executors.BaseCodeExecutor.code_block_delimiters", false]], "codeexecutorcontext (class in google.adk.code_executors)": [[0, "google.adk.code_executors.CodeExecutorContext", false]], "create_session() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.create_session", false]], "create_session() (google.adk.sessions.databasesessionservice method)": [[0, "google.adk.sessions.DatabaseSessionService.create_session", false]], "create_session() (google.adk.sessions.inmemorysessionservice method)": [[0, "google.adk.sessions.InMemorySessionService.create_session", false]], "create_session() (google.adk.sessions.vertexaisessionservice method)": [[0, "google.adk.sessions.VertexAiSessionService.create_session", false]], "databasesessionservice (class in google.adk.sessions)": [[0, "google.adk.sessions.DatabaseSessionService", false]], "delete_artifact() (google.adk.artifacts.baseartifactservice method)": [[0, "google.adk.artifacts.BaseArtifactService.delete_artifact", false]], "delete_artifact() (google.adk.artifacts.gcsartifactservice method)": [[0, "google.adk.artifacts.GcsArtifactService.delete_artifact", false]], "delete_artifact() (google.adk.artifacts.inmemoryartifactservice method)": [[0, "google.adk.artifacts.InMemoryArtifactService.delete_artifact", false]], "delete_session() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.delete_session", false]], "delete_session() (google.adk.sessions.databasesessionservice method)": [[0, "google.adk.sessions.DatabaseSessionService.delete_session", false]], "delete_session() (google.adk.sessions.inmemorysessionservice method)": [[0, "google.adk.sessions.InMemorySessionService.delete_session", false]], "delete_session() (google.adk.sessions.vertexaisessionservice method)": [[0, "google.adk.sessions.VertexAiSessionService.delete_session", false]], "docker_path (google.adk.code_executors.containercodeexecutor attribute)": [[0, "google.adk.code_executors.ContainerCodeExecutor.docker_path", false]], "error_retry_attempts (google.adk.code_executors.basecodeexecutor attribute)": [[0, "google.adk.code_executors.BaseCodeExecutor.error_retry_attempts", false]], "escalate (google.adk.events.eventactions attribute)": [[0, "google.adk.events.EventActions.escalate", false]], "events (google.adk.sessions.session attribute)": [[0, "google.adk.sessions.Session.events", false], [0, "id20", false]], "execute_code() (google.adk.code_executors.basecodeexecutor method)": [[0, "google.adk.code_executors.BaseCodeExecutor.execute_code", false]], "execute_code() (google.adk.code_executors.containercodeexecutor method)": [[0, "google.adk.code_executors.ContainerCodeExecutor.execute_code", false]], "execute_code() (google.adk.code_executors.unsafelocalcodeexecutor method)": [[0, "google.adk.code_executors.UnsafeLocalCodeExecutor.execute_code", false]], "execute_code() (google.adk.code_executors.vertexaicodeexecutor method)": [[0, "google.adk.code_executors.VertexAiCodeExecutor.execute_code", false]], "execution_result_delimiters (google.adk.code_executors.basecodeexecutor attribute)": [[0, "google.adk.code_executors.BaseCodeExecutor.execution_result_delimiters", false]], "from_function_response() (google.adk.events.event class method)": [[0, "google.adk.events.Event.from_function_response", false]], "gcsartifactservice (class in google.adk.artifacts)": [[0, "google.adk.artifacts.GcsArtifactService", false]], "get() (google.adk.sessions.state method)": [[0, "google.adk.sessions.State.get", false]], "get_error_count() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.get_error_count", false]], "get_examples() (google.adk.examples.baseexampleprovider method)": [[0, "google.adk.examples.BaseExampleProvider.get_examples", false]], "get_examples() (google.adk.examples.vertexaiexamplestore method)": [[0, "google.adk.examples.VertexAiExampleStore.get_examples", false]], "get_execution_id() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.get_execution_id", false]], "get_function_calls (google.adk.events.event attribute)": [[0, "google.adk.events.Event.get_function_calls", false]], "get_function_calls() (google.adk.events.event method)": [[0, "id15", false]], "get_function_responses() (google.adk.events.event method)": [[0, "google.adk.events.Event.get_function_responses", false]], "get_input_files() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.get_input_files", false]], "get_processed_file_names() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.get_processed_file_names", false]], "get_session() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.get_session", false]], "get_session() (google.adk.sessions.databasesessionservice method)": [[0, "google.adk.sessions.DatabaseSessionService.get_session", false]], "get_session() (google.adk.sessions.inmemorysessionservice method)": [[0, "google.adk.sessions.InMemorySessionService.get_session", false]], "get_session() (google.adk.sessions.vertexaisessionservice method)": [[0, "google.adk.sessions.VertexAiSessionService.get_session", false]], "get_state_delta() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.get_state_delta", false]], "google.adk.artifacts": [[0, "module-google.adk.artifacts", false]], "google.adk.code_executors": [[0, "module-google.adk.code_executors", false]], "google.adk.events": [[0, "module-google.adk.events", false]], "google.adk.examples": [[0, "module-google.adk.examples", false]], "google.adk.memory": [[0, "module-google.adk.memory", false]], "google.adk.sessions": [[0, "module-google.adk.sessions", false]], "has_delta() (google.adk.sessions.state method)": [[0, "google.adk.sessions.State.has_delta", false]], "has_trailing_code_exeuction_result() (google.adk.events.event method)": [[0, "google.adk.events.Event.has_trailing_code_exeuction_result", false]], "id (google.adk.events.event attribute)": [[0, "google.adk.events.Event.id", false], [0, "id11", false]], "id (google.adk.sessions.session attribute)": [[0, "google.adk.sessions.Session.id", false], [0, "id21", false]], "image (google.adk.code_executors.containercodeexecutor attribute)": [[0, "google.adk.code_executors.ContainerCodeExecutor.image", false]], "increment_error_count() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.increment_error_count", false]], "inmemorymemoryservice (class in google.adk.memory)": [[0, "google.adk.memory.InMemoryMemoryService", false]], "inmemorysessionservice (class in google.adk.sessions)": [[0, "google.adk.sessions.InMemorySessionService", false]], "input (google.adk.examples.example attribute)": [[0, "google.adk.examples.Example.input", false], [0, "id17", false]], "invocation_id (google.adk.events.event attribute)": [[0, "google.adk.events.Event.invocation_id", false], [0, "id12", false]], "is_final_response (google.adk.events.event attribute)": [[0, "google.adk.events.Event.is_final_response", false]], "is_final_response() (google.adk.events.event method)": [[0, "id16", false]], "last_update_time (google.adk.sessions.session attribute)": [[0, "google.adk.sessions.Session.last_update_time", false], [0, "id22", false]], "list_artifact_keys() (google.adk.artifacts.baseartifactservice method)": [[0, "google.adk.artifacts.BaseArtifactService.list_artifact_keys", false]], "list_artifact_keys() (google.adk.artifacts.gcsartifactservice method)": [[0, "google.adk.artifacts.GcsArtifactService.list_artifact_keys", false]], "list_artifact_keys() (google.adk.artifacts.inmemoryartifactservice method)": [[0, "google.adk.artifacts.InMemoryArtifactService.list_artifact_keys", false]], "list_events() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.list_events", false]], "list_events() (google.adk.sessions.databasesessionservice method)": [[0, "google.adk.sessions.DatabaseSessionService.list_events", false]], "list_events() (google.adk.sessions.inmemorysessionservice method)": [[0, "google.adk.sessions.InMemorySessionService.list_events", false]], "list_events() (google.adk.sessions.vertexaisessionservice method)": [[0, "google.adk.sessions.VertexAiSessionService.list_events", false]], "list_sessions() (google.adk.sessions.basesessionservice method)": [[0, "google.adk.sessions.BaseSessionService.list_sessions", false]], "list_sessions() (google.adk.sessions.databasesessionservice method)": [[0, "google.adk.sessions.DatabaseSessionService.list_sessions", false]], "list_sessions() (google.adk.sessions.inmemorysessionservice method)": [[0, "google.adk.sessions.InMemorySessionService.list_sessions", false]], "list_sessions() (google.adk.sessions.vertexaisessionservice method)": [[0, "google.adk.sessions.VertexAiSessionService.list_sessions", false]], "list_versions() (google.adk.artifacts.baseartifactservice method)": [[0, "google.adk.artifacts.BaseArtifactService.list_versions", false]], "list_versions() (google.adk.artifacts.gcsartifactservice method)": [[0, "google.adk.artifacts.GcsArtifactService.list_versions", false]], "list_versions() (google.adk.artifacts.inmemoryartifactservice method)": [[0, "google.adk.artifacts.InMemoryArtifactService.list_versions", false]], "load_artifact() (google.adk.artifacts.baseartifactservice method)": [[0, "google.adk.artifacts.BaseArtifactService.load_artifact", false]], "load_artifact() (google.adk.artifacts.gcsartifactservice method)": [[0, "google.adk.artifacts.GcsArtifactService.load_artifact", false]], "load_artifact() (google.adk.artifacts.inmemoryartifactservice method)": [[0, "google.adk.artifacts.InMemoryArtifactService.load_artifact", false]], "long_running_tool_ids (google.adk.events.event attribute)": [[0, "google.adk.events.Event.long_running_tool_ids", false], [0, "id13", false]], "model_post_init() (google.adk.code_executors.containercodeexecutor method)": [[0, "google.adk.code_executors.ContainerCodeExecutor.model_post_init", false]], "model_post_init() (google.adk.code_executors.vertexaicodeexecutor method)": [[0, "google.adk.code_executors.VertexAiCodeExecutor.model_post_init", false]], "model_post_init() (google.adk.events.event method)": [[0, "google.adk.events.Event.model_post_init", false]], "module": [[0, "module-google.adk.artifacts", false], [0, "module-google.adk.code_executors", false], [0, "module-google.adk.events", false], [0, "module-google.adk.examples", false], [0, "module-google.adk.memory", false], [0, "module-google.adk.sessions", false]], "new_id() (google.adk.events.event static method)": [[0, "google.adk.events.Event.new_id", false]], "optimize_data_file (google.adk.code_executors.basecodeexecutor attribute)": [[0, "google.adk.code_executors.BaseCodeExecutor.optimize_data_file", false]], "optimize_data_file (google.adk.code_executors.containercodeexecutor attribute)": [[0, "google.adk.code_executors.ContainerCodeExecutor.optimize_data_file", false]], "optimize_data_file (google.adk.code_executors.unsafelocalcodeexecutor attribute)": [[0, "google.adk.code_executors.UnsafeLocalCodeExecutor.optimize_data_file", false]], "output (google.adk.examples.example attribute)": [[0, "google.adk.examples.Example.output", false], [0, "id18", false]], "requested_auth_configs (google.adk.events.eventactions attribute)": [[0, "google.adk.events.EventActions.requested_auth_configs", false]], "reset_error_count() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.reset_error_count", false]], "resource_name (google.adk.code_executors.vertexaicodeexecutor attribute)": [[0, "google.adk.code_executors.VertexAiCodeExecutor.resource_name", false]], "save_artifact() (google.adk.artifacts.baseartifactservice method)": [[0, "google.adk.artifacts.BaseArtifactService.save_artifact", false]], "save_artifact() (google.adk.artifacts.gcsartifactservice method)": [[0, "google.adk.artifacts.GcsArtifactService.save_artifact", false]], "save_artifact() (google.adk.artifacts.inmemoryartifactservice method)": [[0, "google.adk.artifacts.InMemoryArtifactService.save_artifact", false]], "search_memory() (google.adk.memory.basememoryservice method)": [[0, "google.adk.memory.BaseMemoryService.search_memory", false]], "search_memory() (google.adk.memory.inmemorymemoryservice method)": [[0, "google.adk.memory.InMemoryMemoryService.search_memory", false]], "search_memory() (google.adk.memory.vertexairagmemoryservice method)": [[0, "google.adk.memory.VertexAiRagMemoryService.search_memory", false]], "session_events (google.adk.memory.inmemorymemoryservice attribute)": [[0, "google.adk.memory.InMemoryMemoryService.session_events", false]], "sessions (google.adk.sessions.inmemorysessionservice attribute)": [[0, "google.adk.sessions.InMemorySessionService.sessions", false]], "set_execution_id() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.set_execution_id", false]], "skip_summarization (google.adk.events.eventactions attribute)": [[0, "google.adk.events.EventActions.skip_summarization", false]], "state (class in google.adk.sessions)": [[0, "google.adk.sessions.State", false]], "state (google.adk.sessions.session attribute)": [[0, "google.adk.sessions.Session.state", false], [0, "id23", false]], "state_delta (google.adk.events.eventactions attribute)": [[0, "google.adk.events.EventActions.state_delta", false]], "stateful (google.adk.code_executors.basecodeexecutor attribute)": [[0, "google.adk.code_executors.BaseCodeExecutor.stateful", false]], "stateful (google.adk.code_executors.containercodeexecutor attribute)": [[0, "google.adk.code_executors.ContainerCodeExecutor.stateful", false]], "stateful (google.adk.code_executors.unsafelocalcodeexecutor attribute)": [[0, "google.adk.code_executors.UnsafeLocalCodeExecutor.stateful", false]], "temp_prefix (google.adk.sessions.state attribute)": [[0, "google.adk.sessions.State.TEMP_PREFIX", false]], "timestamp (google.adk.events.event attribute)": [[0, "google.adk.events.Event.timestamp", false], [0, "id14", false]], "to_dict() (google.adk.sessions.state method)": [[0, "google.adk.sessions.State.to_dict", false]], "transfer_to_agent (google.adk.events.eventactions attribute)": [[0, "google.adk.events.EventActions.transfer_to_agent", false]], "update() (google.adk.sessions.state method)": [[0, "google.adk.sessions.State.update", false]], "update_code_execution_result() (google.adk.code_executors.codeexecutorcontext method)": [[0, "google.adk.code_executors.CodeExecutorContext.update_code_execution_result", false]], "user_id (google.adk.sessions.session attribute)": [[0, "google.adk.sessions.Session.user_id", false], [0, "id24", false]], "user_prefix (google.adk.sessions.state attribute)": [[0, "google.adk.sessions.State.USER_PREFIX", false]], "user_state (google.adk.sessions.inmemorysessionservice attribute)": [[0, "google.adk.sessions.InMemorySessionService.user_state", false]], "vertexaiexamplestore (class in google.adk.examples)": [[0, "google.adk.examples.VertexAiExampleStore", false]], "vertexairagmemoryservice (class in google.adk.memory)": [[0, "google.adk.memory.VertexAiRagMemoryService", false]], "vertexaisessionservice (class in google.adk.sessions)": [[0, "google.adk.sessions.VertexAiSessionService", false]]}, "objects": {"google.adk": [[0, 0, 0, "-", "artifacts"], [0, 0, 0, "-", "code_executors"], [0, 0, 0, "-", "events"], [0, 0, 0, "-", "examples"], [0, 0, 0, "-", "memory"], [0, 0, 0, "-", "sessions"]], "google.adk.artifacts": [[0, 1, 1, "", "BaseArtifactService"], [0, 1, 1, "", "GcsArtifactService"], [0, 3, 1, "", "InMemoryArtifactService"]], "google.adk.artifacts.BaseArtifactService": [[0, 2, 1, "", "delete_artifact"], [0, 2, 1, "", "list_artifact_keys"], [0, 2, 1, "", "list_versions"], [0, 2, 1, "", "load_artifact"], [0, 2, 1, "", "save_artifact"]], "google.adk.artifacts.GcsArtifactService": [[0, 2, 1, "", "delete_artifact"], [0, 2, 1, "", "list_artifact_keys"], [0, 2, 1, "", "list_versions"], [0, 2, 1, "", "load_artifact"], [0, 2, 1, "", "save_artifact"]], "google.adk.artifacts.InMemoryArtifactService": [[0, 4, 1, "", "artifacts"], [0, 2, 1, "", "delete_artifact"], [0, 2, 1, "", "list_artifact_keys"], [0, 2, 1, "", "list_versions"], [0, 2, 1, "", "load_artifact"], [0, 2, 1, "", "save_artifact"]], "google.adk.code_executors": [[0, 3, 1, "", "BaseCodeExecutor"], [0, 1, 1, "", "CodeExecutorContext"], [0, 3, 1, "", "ContainerCodeExecutor"], [0, 3, 1, "", "UnsafeLocalCodeExecutor"], [0, 3, 1, "", "VertexAiCodeExecutor"]], "google.adk.code_executors.BaseCodeExecutor": [[0, 4, 1, "", "code_block_delimiters"], [0, 4, 1, "", "error_retry_attempts"], [0, 2, 1, "", "execute_code"], [0, 4, 1, "", "execution_result_delimiters"], [0, 4, 1, "", "optimize_data_file"], [0, 4, 1, "", "stateful"]], "google.adk.code_executors.CodeExecutorContext": [[0, 2, 1, "", "add_input_files"], [0, 2, 1, "", "add_processed_file_names"], [0, 2, 1, "", "clear_input_files"], [0, 2, 1, "", "get_error_count"], [0, 2, 1, "", "get_execution_id"], [0, 2, 1, "", "get_input_files"], [0, 2, 1, "", "get_processed_file_names"], [0, 2, 1, "", "get_state_delta"], [0, 2, 1, "", "increment_error_count"], [0, 2, 1, "", "reset_error_count"], [0, 2, 1, "", "set_execution_id"], [0, 2, 1, "", "update_code_execution_result"]], "google.adk.code_executors.ContainerCodeExecutor": [[0, 4, 1, "", "base_url"], [0, 4, 1, "", "docker_path"], [0, 2, 1, "", "execute_code"], [0, 4, 1, "", "image"], [0, 2, 1, "", "model_post_init"], [0, 4, 1, "", "optimize_data_file"], [0, 4, 1, "", "stateful"]], "google.adk.code_executors.UnsafeLocalCodeExecutor": [[0, 2, 1, "", "execute_code"], [0, 4, 1, "", "optimize_data_file"], [0, 4, 1, "", "stateful"]], "google.adk.code_executors.VertexAiCodeExecutor": [[0, 2, 1, "", "execute_code"], [0, 2, 1, "", "model_post_init"], [0, 4, 1, "", "resource_name"]], "google.adk.events": [[0, 3, 1, "", "Event"], [0, 3, 1, "", "EventActions"]], "google.adk.events.Event": [[0, 4, 1, "id0", "actions"], [0, 4, 1, "id9", "author"], [0, 4, 1, "id10", "branch"], [0, 2, 1, "", "from_function_response"], [0, 2, 1, "id15", "get_function_calls"], [0, 2, 1, "", "get_function_responses"], [0, 2, 1, "", "has_trailing_code_exeuction_result"], [0, 4, 1, "id11", "id"], [0, 4, 1, "id12", "invocation_id"], [0, 2, 1, "id16", "is_final_response"], [0, 4, 1, "id13", "long_running_tool_ids"], [0, 2, 1, "", "model_post_init"], [0, 2, 1, "", "new_id"], [0, 4, 1, "id14", "timestamp"]], "google.adk.events.EventActions": [[0, 4, 1, "", "artifact_delta"], [0, 4, 1, "", "escalate"], [0, 4, 1, "", "requested_auth_configs"], [0, 4, 1, "", "skip_summarization"], [0, 4, 1, "", "state_delta"], [0, 4, 1, "", "transfer_to_agent"]], "google.adk.examples": [[0, 1, 1, "", "BaseExampleProvider"], [0, 3, 1, "", "Example"], [0, 1, 1, "", "VertexAiExampleStore"]], "google.adk.examples.BaseExampleProvider": [[0, 2, 1, "", "get_examples"]], "google.adk.examples.Example": [[0, 4, 1, "id17", "input"], [0, 4, 1, "id18", "output"]], "google.adk.examples.VertexAiExampleStore": [[0, 2, 1, "", "get_examples"]], "google.adk.memory": [[0, 1, 1, "", "BaseMemoryService"], [0, 1, 1, "", "InMemoryMemoryService"], [0, 1, 1, "", "VertexAiRagMemoryService"]], "google.adk.memory.BaseMemoryService": [[0, 2, 1, "", "add_session_to_memory"], [0, 2, 1, "", "search_memory"]], "google.adk.memory.InMemoryMemoryService": [[0, 2, 1, "", "add_session_to_memory"], [0, 2, 1, "", "search_memory"], [0, 5, 1, "", "session_events"]], "google.adk.memory.VertexAiRagMemoryService": [[0, 2, 1, "", "add_session_to_memory"], [0, 2, 1, "", "search_memory"]], "google.adk.sessions": [[0, 1, 1, "", "BaseSessionService"], [0, 1, 1, "", "DatabaseSessionService"], [0, 1, 1, "", "InMemorySessionService"], [0, 3, 1, "", "Session"], [0, 1, 1, "", "State"], [0, 1, 1, "", "VertexAiSessionService"]], "google.adk.sessions.BaseSessionService": [[0, 2, 1, "", "append_event"], [0, 2, 1, "", "close_session"], [0, 2, 1, "", "create_session"], [0, 2, 1, "", "delete_session"], [0, 2, 1, "", "get_session"], [0, 2, 1, "", "list_events"], [0, 2, 1, "", "list_sessions"]], "google.adk.sessions.DatabaseSessionService": [[0, 2, 1, "", "append_event"], [0, 2, 1, "", "create_session"], [0, 2, 1, "", "delete_session"], [0, 2, 1, "", "get_session"], [0, 2, 1, "", "list_events"], [0, 2, 1, "", "list_sessions"]], "google.adk.sessions.InMemorySessionService": [[0, 5, 1, "", "app_state"], [0, 2, 1, "", "append_event"], [0, 2, 1, "", "create_session"], [0, 2, 1, "", "delete_session"], [0, 2, 1, "", "get_session"], [0, 2, 1, "", "list_events"], [0, 2, 1, "", "list_sessions"], [0, 5, 1, "", "sessions"], [0, 5, 1, "", "user_state"]], "google.adk.sessions.Session": [[0, 4, 1, "id19", "app_name"], [0, 4, 1, "id20", "events"], [0, 4, 1, "id21", "id"], [0, 4, 1, "id22", "last_update_time"], [0, 4, 1, "id23", "state"], [0, 4, 1, "id24", "user_id"]], "google.adk.sessions.State": [[0, 5, 1, "", "APP_PREFIX"], [0, 5, 1, "", "TEMP_PREFIX"], [0, 5, 1, "", "USER_PREFIX"], [0, 2, 1, "", "get"], [0, 2, 1, "", "has_delta"], [0, 2, 1, "", "to_dict"], [0, 2, 1, "", "update"]], "google.adk.sessions.VertexAiSessionService": [[0, 2, 1, "", "append_event"], [0, 2, 1, "", "create_session"], [0, 2, 1, "", "delete_session"], [0, 2, 1, "", "get_session"], [0, 2, 1, "", "list_events"], [0, 2, 1, "", "list_sessions"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "pydantic_model", "Python model"], "4": ["py", "pydantic_field", "Python field"], "5": ["py", "attribute", "Python attribute"]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:pydantic_model", "4": "py:pydantic_field", "5": "py:attribute"}, "terms": {"": 0, "0": 0, "1": 0, "10": 0, "123": 0, "2": 0, "3": 0, "4": 0, "456": 0, "A": 0, "For": 0, "If": 0, "It": 0, "The": 0, "To": 0, "Will": 0, "_event__context": 0, "abc": 0, "about": 0, "abstract": 0, "action": [0, 1], "ad": 0, "add": 0, "add_input_fil": [0, 1], "add_processed_file_nam": [0, 1], "add_session_to_memori": [0, 1], "additionalproperti": 0, "adk": 1, "after": 0, "agent": 1, "agent_1": 0, "agent_2": 0, "agent_3": 0, "ai": 0, "all": 0, "an": 0, "ani": 0, "answer": 0, "anyof": 0, "app": 0, "app_nam": [0, 1], "app_prefix": [0, 1], "app_stat": [0, 1], "append": 0, "append_ev": [0, 1], "applic": 0, "ar": 0, "arg": 0, "argument": 0, "arrai": 0, "artifact": 1, "artifact_delta": [0, 1], "associ": 0, "attach": 0, "attempt": 0, "attribut": 0, "auth": 0, "author": [0, 1], "avail": 0, "base": 0, "base64": 0, "base64url": 0, "base_url": [0, 1], "baseartifactservic": [0, 1], "basecodeexecutor": [0, 1], "baseexampleprovid": [0, 1], "basememoryservic": [0, 1], "basemodel": 0, "basesessionservic": [0, 1], "been": 0, "behav": 0, "being": 0, "belong": 0, "between": 0, "blob": 0, "block": 0, "bool": 0, "boolean": 0, "branch": [0, 1], "bucket_nam": 0, "build": 0, "byte": 0, "call": 0, "can": 0, "central1": 0, "chang": 0, "chunk": 0, "citat": 0, "claim": 0, "class": 0, "classmethod": 0, "clear_input_fil": [0, 1], "client": 0, "close": 0, "close_sess": [0, 1], "cloud": 0, "code": 0, "code_block_delimit": [0, 1], "code_execution_input": 0, "code_executor": 1, "codeexecutionresult": 0, "codeexecutorcontext": [0, 1], "collect": 0, "commit": 0, "compar": 0, "complet": 0, "confid": 0, "confidencescor": 0, "config": 0, "configur": 0, "connect": 0, "consecut": 0, "consid": 0, "constitut": 0, "contain": 0, "containercodeexecutor": [0, 1], "content": 0, "context": 0, "convei": 0, "convers": 0, "conversact": 0, "core": 0, "corpu": 0, "correspond": 0, "could": 0, "count": 0, "creat": 0, "create_sess": [0, 1], "csv": 0, "current": 0, "custom": 0, "data": 0, "databas": 0, "databasesessionservic": [0, 1], "datatyp": 0, "db_url": 0, "def": 0, "default": 0, "defin": 0, "delet": 0, "delete_artifact": [0, 1], "delete_sess": [0, 1], "delimit": 0, "delta": 0, "describ": 0, "descript": 0, "detail": 0, "determin": 0, "detla": 0, "dict": 0, "differ": 0, "directli": 0, "directori": 0, "distanc": 0, "docker": 0, "docker_path": [0, 1], "dockerfil": 0, "dure": 0, "dynam": 0, "e": 0, "each": 0, "either": 0, "embed": 0, "empti": 0, "enabl": 0, "enclos": 0, "encod": 0, "end": 0, "endindex": 0, "endoffset": 0, "entri": 0, "enum": 0, "error": 0, "error_cod": 0, "error_messag": 0, "error_retry_attempt": [0, 1], "escal": [0, 1], "etc": 0, "euc": 0, "evalu": 1, "event": 1, "event_act": 0, "eventact": [0, 1], "exampl": 1, "example_stor": 0, "examples_store_nam": 0, "examplestor": 0, "exclus": 0, "execut": 0, "executablecod": 0, "execute_cod": [0, 1], "execution_result_delimit": [0, 1], "executor": 0, "exist": 0, "expect": 0, "extens": 0, "extract": 0, "fals": 0, "few": 0, "field": 0, "file": 0, "file_nam": 0, "filedata": 0, "filenam": 0, "fileuri": 0, "final": 0, "first": 0, "float": 0, "flow": 0, "follow": 0, "format": 0, "found": 0, "from": 0, "from_function_respons": [0, 1], "function": 0, "function_cal": 0, "function_call_ev": 0, "function_respons": 0, "function_result": 0, "functioncal": 0, "functioncallingconfig": 0, "functiondeclar": 0, "functionrespons": 0, "g": 0, "gc": 0, "gcsartifactservic": [0, 1], "genai": 0, "gener": 0, "get": [0, 1], "get_error_count": [0, 1], "get_exampl": [0, 1], "get_execution_id": [0, 1], "get_function_cal": [0, 1], "get_function_respons": [0, 1], "get_input_fil": [0, 1], "get_processed_file_nam": [0, 1], "get_sess": [0, 1], "get_state_delta": [0, 1], "given": 0, "googlesearchdynamicretrievalscor": 0, "ground": 0, "grounding_chunk": 0, "grounding_chunk_indic": 0, "grounding_metadata": 0, "groundingchunk": 0, "groundingchunkindic": 0, "groundingchunkretrievedcontext": 0, "groundingchunkweb": 0, "groundingmetadata": 0, "groundingsupport": 0, "ha": 0, "has_delta": [0, 1], "has_trailing_code_exeuction_result": [0, 1], "hasn": 0, "have": 0, "hello": 0, "help": 0, "higher": 0, "histori": 0, "host": 0, "how": 0, "i": 0, "iana": 0, "id": [0, 1], "identifi": 0, "imag": [0, 1], "implement": 0, "inclus": 0, "increment": 0, "increment_error_count": [0, 1], "index": 0, "indic": 0, "inform": 0, "ingest": 0, "initi": 0, "initialis": 0, "inlin": 0, "inlinedata": 0, "inmemoryartifactservic": [0, 1], "inmemorymemoryservic": [0, 1], "inmemorysessionservic": [0, 1], "input": [0, 1], "input_fil": 0, "instanc": 0, "instead": 0, "int": 0, "integ": 0, "interact": 0, "interfac": 0, "interpret": 0, "interrupt": 0, "invalid": 0, "invoc": 0, "invocation_context": 0, "invocation_id": [0, 1], "is_final_respons": [0, 1], "item": 0, "its": 0, "json": 0, "kei": 0, "keyword": 0, "know": 0, "kwarg": 0, "languag": 0, "language_unspecifi": 0, "last": 0, "last_update_tim": [0, 1], "latest": 0, "least": 0, "level": 0, "lifetim": 0, "like": 0, "list": 0, "list_artifact_kei": [0, 1], "list_ev": [0, 1], "list_sess": [0, 1], "list_vers": [0, 1], "listeventsrespons": 0, "listsessionsrespons": 0, "llmrespons": 0, "load": 0, "load_artifact": [0, 1], "local": 0, "locat": 0, "logic": 0, "long": 0, "long_running_tool_id": [0, 1], "mai": 0, "maintain": 0, "manag": 0, "match": 0, "maxitem": 0, "mean": 0, "meant": 0, "measur": 0, "media": 0, "memori": 1, "messag": 0, "metadata": 0, "method": 0, "mime": 0, "mimetyp": 0, "minitem": 0, "mode": 0, "model": 1, "model_post_init": [0, 1], "modul": 1, "most": 0, "multi": 0, "multipl": 0, "must": 0, "n": 0, "nalwai": 0, "name": 0, "nattribut": 0, "new": 0, "new_id": [0, 1], "newli": 0, "nexactli": 0, "ngener": 0, "ninstanc": 0, "nit": 0, "nof": 0, "none": 0, "ntaken": 0, "null": 0, "number": 0, "object": 0, "offset": 0, "one": 0, "onli": 0, "optim": 0, "optimize_data_fil": [0, 1], "option": 0, "other": 0, "otherwis": 0, "outcom": 0, "outcome_deadline_exceed": 0, "outcome_fail": 0, "outcome_ok": 0, "outcome_unspecifi": 0, "output": [0, 1], "page": 0, "paramet": 0, "parent": 0, "part": 0, "partial": 0, "partindex": 0, "pass": 0, "path": 0, "peer": 0, "pend": 0, "persist": 0, "planner": 1, "point": 0, "popul": 0, "post": 0, "predefin": 0, "predict": 0, "prefixitem": 0, "print": 0, "privat": 0, "process": 0, "produc": 0, "program": 0, "project": 0, "prompt": 0, "properti": 0, "prototyp": 0, "provid": 0, "purpos": 0, "pydant": 0, "python": 0, "queri": 0, "rag": 0, "rag_corpu": 0, "rag_corpus_id": 0, "ragcorpora": 0, "rang": 0, "raw": 0, "ref": 0, "refer": 0, "relat": 0, "remov": 0, "renderedcont": 0, "repres": 0, "request": 0, "requested_auth_config": [0, 1], "requir": 0, "reset": 0, "reset_error_count": [0, 1], "resourc": 0, "resource_nam": [0, 1], "respons": 0, "result": 0, "result_stderr": 0, "result_stdout": 0, "retri": 0, "retriev": 0, "retrieval_queri": 0, "retrievalmetadata": 0, "retrievalqueri": 0, "retrievedcontext": 0, "return": 0, "revis": 0, "role": 0, "run": 0, "runner": 1, "same": 0, "save": 0, "save_artifact": [0, 1], "schema": 0, "score": 0, "sdk": 0, "sdkblob": 0, "search": 0, "search_memori": [0, 1], "searchentrypoint": 0, "searchmemoryrespons": 0, "see": 0, "segment": 0, "self": 0, "semant": 0, "seri": 0, "servic": 0, "session": 1, "session_ev": [0, 1], "session_id": 0, "session_st": 0, "set": 0, "set_execution_id": [0, 1], "shot": 0, "should": 0, "shouldn": 0, "show": 0, "similarity_top_k": 0, "sinc": 0, "singl": 0, "size": 0, "skip": 0, "skip_summar": [0, 1], "smaller": 0, "snippet": 0, "so": 0, "sourc": 0, "specif": 0, "specifi": 0, "standard": 0, "start": 0, "startindex": 0, "startoffset": 0, "state": [0, 1], "state_delta": [0, 1], "static": 0, "stderr": 0, "stdout": 0, "storag": 0, "store": 0, "str": 0, "string": 0, "structur": 0, "sub": 0, "submodul": 1, "success": 0, "summar": 0, "support": 0, "t": 0, "tag": 0, "take": 0, "taken": 0, "temp": 0, "temp_prefix": [0, 1], "text": 0, "than": 0, "them": 0, "thi": 0, "thought": 0, "threshold": 0, "time": 0, "timestamp": [0, 1], "titl": 0, "to_dict": [0, 1], "tool": 1, "tool_cod": 0, "tool_output": 0, "trail": 0, "transfer": 0, "transfer_to_ag": [0, 1], "treat": 0, "trigger": 0, "true": 0, "tupl": 0, "turn": 0, "turn_complet": 0, "type": 0, "u": 0, "uniqu": 0, "uniqueitem": 0, "unsaf": 0, "unsafelocalcodeexecutor": [0, 1], "up": 0, "updat": [0, 1], "update_code_execution_result": [0, 1], "uri": 0, "url": 0, "us": 0, "user": 0, "user_id": [0, 1], "user_prefix": [0, 1], "user_st": [0, 1], "valid": 0, "valu": 0, "vector": 0, "vector_distance_threshold": 0, "version": 0, "vertex": 0, "vertexaicodeexecutor": [0, 1], "vertexaiexamplestor": [0, 1], "vertexairagmemoryservic": [0, 1], "vertexaisessionservic": [0, 1], "video": 0, "videometadata": 0, "web": 0, "websearchqueri": 0, "webview": 0, "well": 0, "what": 0, "when": 0, "where": 0, "whether": 0, "which": 0, "who": 0, "whole": 0, "within": 0, "won": 0, "zero": 0}, "titles": ["Submodules", "google"], "titleterms": {"adk": 0, "agent": 0, "artifact": 0, "code_executor": 0, "evalu": 0, "event": 0, "exampl": 0, "googl": [0, 1], "memori": 0, "model": 0, "modul": 0, "planner": 0, "runner": 0, "session": 0, "submodul": 0, "tool": 0}})
google/adk/docs/source/conf.py ADDED
@@ -0,0 +1,133 @@
1
+ # Copyright 2025 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ # Configuration file for the Sphinx documentation builder.
16
+ #
17
+ # For the full list of built-in configuration values, see the documentation:
18
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html
19
+
20
+ # -- Project information -----------------------------------------------------
21
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
22
+
23
+ project = 'Agent Development Kit'
24
+ copyright = '2025, Google'
25
+ author = 'Google'
26
+
27
+ # -- General configuration ---------------------------------------------------
28
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
29
+
30
+ extensions = []
31
+
32
+ templates_path = ['_templates']
33
+ exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
34
+
35
+ autoclass_content = 'both'
36
+
37
+ # -- Options for HTML output -------------------------------------------------
38
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
39
+
40
+ html_static_path = ['_static']
41
+
42
+ import html
43
+ import inspect
44
+ import inspect
45
+ import logging # Use logging for better output
46
+ import os
47
+ import sys
48
+ import pydantic
49
+
50
+
51
+ def skip_pydantic_init(app, what, name, obj, options, lines):
52
+ logging.info(
53
+ f'Processing: what={what}, name={name}, obj={obj}, type(obj)={type(obj)}'
54
+ )
55
+
56
+ if what == 'pydantic_model':
57
+ try:
58
+ mro = inspect.getmro(obj)
59
+ logging.info(f' MRO: {mro}')
60
+ if inspect.isclass(mro[0]) and issubclass(mro[0], pydantic.BaseModel):
61
+ # Check if the *first class in the MRO* has a default docstring
62
+ # (This is a heuristic, but it's likely to be correct for BaseModel's init)
63
+ if lines and lines[0].startswith('Create a new model by parsing'):
64
+ logging.info(" Suppressing BaseModel's __init__ docstring")
65
+ lines.clear()
66
+ lines.append('')
67
+ except TypeError:
68
+ logging.info(' obj is not a class-like object (pydantic_model)')
69
+ elif what == 'method' and name == '__init__':
70
+ # This is likely not necessary, but keep it for robustness
71
+ try:
72
+ mro = inspect.getmro(obj)
73
+ logging.info(f' MRO: {mro}')
74
+ if inspect.isclass(mro[0]) and issubclass(mro[0], pydantic.BaseModel):
75
+ logging.info(' Suppressing __init__ docstring (method)')
76
+ lines.clear()
77
+ lines.append('')
78
+ except TypeError:
79
+ logging.info(' obj is not a class-like object (method)')
80
+
81
+
82
+ def setup(app):
83
+ app.connect('autodoc-process-docstring', skip_pydantic_init)
84
+ logging.basicConfig(level=logging.INFO)
85
+
86
+
87
+ sys.path.insert(0, os.path.abspath('.')) # Add current directory to path
88
+ sys.path.insert(0, os.path.abspath('../google'))
89
+
90
+ extensions = [
91
+ 'sphinxcontrib.autodoc_pydantic',
92
+ 'myst_parser',
93
+ 'sphinx.ext.autodoc',
94
+ 'sphinx_autodoc_typehints',
95
+ 'sphinx.ext.napoleon',
96
+ ]
97
+ html_theme = 'furo'
98
+
99
+ TEXT_FONTS = (
100
+ '"Google Sans Text", Roboto, "Helvetica Neue", Helvetica, Arial, sans-serif'
101
+ )
102
+ CODE_FONTS = 'Roboto Mono, "Helvetica Neue Mono", monospace'
103
+ FONT_COLOR_FOR_LIGHT_THEME = 'black'
104
+ FONT_COLOR_FOR_DARK_THEME = 'white'
105
+
106
+ html_theme_options = {
107
+ 'light_css_variables': {
108
+ 'font-stack': TEXT_FONTS,
109
+ 'font-stack--monospace': CODE_FONTS,
110
+ 'font-stack--headings': TEXT_FONTS,
111
+ 'color-brand-primary': FONT_COLOR_FOR_LIGHT_THEME,
112
+ 'color-brand-content': FONT_COLOR_FOR_LIGHT_THEME,
113
+ },
114
+ 'dark_css_variables': {
115
+ 'font-stack': TEXT_FONTS,
116
+ 'font-stack--monospace': CODE_FONTS,
117
+ 'font-stack--headings': TEXT_FONTS,
118
+ 'color-brand-primary': FONT_COLOR_FOR_DARK_THEME,
119
+ 'color-brand-content': FONT_COLOR_FOR_DARK_THEME,
120
+ },
121
+ }
122
+
123
+ # These folders are copied to the documentation's HTML output
124
+ html_static_path = ['_static']
125
+
126
+ # These paths are either relative to html_static_path
127
+ # or fully qualified paths (eg. https://...)
128
+ html_css_files = [
129
+ 'css/custom.css',
130
+ ]
131
+
132
+ autodoc_pydantic_model_show_json = True
133
+ autodoc_pydantic_model_show_config_summary = False