Skip to content

Commit 24c9c00

Browse files
koverholtkoverholt
authored
Merge branch 'main' into fix/ag-ui-tutorial-821
2 parents adc3634 + 7c8ffc0 commit 24c9c00

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

49 files changed

+467
-753
lines changed

‎docs/assets/toolbox.svg‎

Lines changed: 1 addition & 0 deletions
Loading

‎docs/assets/tools-gemini-spark.svg‎

Lines changed: 15 additions & 0 deletions
Loading

‎docs/community.md‎

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -49,37 +49,40 @@ Development Kit community.
4949

5050
Join the [ADK Community Google Group](https://groups.google.com/g/adk-community) for updates, calendar invites, and to connect with the ADK community.
5151

52+
See recent recordings below, or browse all past calls on our [YouTube playlist](https://www.youtube.com/playlist?list=PLwi6PfxEP7zZbBPmWiZ8QbPcuKyAY5RR3).
53+
5254
<div class="resource-grid">
53-
<a href="https://www.youtube.com/watch?v=cNVWhrbdn-E" class="resource-card">
55+
<a href="https://www.youtube.com/watch?v=h9Lueiqo89E" class="resource-card">
5456
<div class="card-image-wrapper">
55-
<img src="https://img.youtube.com/vi/cNVWhrbdn-E/maxresdefault.jpg" alt="ADK Community Call Dec 2025">
57+
<img src="https://img.youtube.com/vi/h9Lueiqo89E/maxresdefault.jpg" alt="ADK Community Call Jan 2026">
5658
</div>
5759
<div class="card-content">
5860
<div class="type">Community Call</div>
59-
<h3>📞 ADK Community Call (Dec 2025)</h3>
60-
<p>Discussions include the ADK TypeScript launch, Gemini 3 Flash support, bidirectional streaming for voice agents, and the Visual Builder UI.</p>
61+
<h3>📞 Jan 2026 Recording</h3>
62+
<p>Discussions include Session Service schema for cross-language support, TypeScript multi-agent demo, API Registry for MCP servers, and third-party tool integrations.</p>
6163
</div>
6264
</a>
63-
<a href="https://www.youtube.com/watch?v=bftUz-WBqyw" class="resource-card">
65+
<a href="https://www.youtube.com/watch?v=cNVWhrbdn-E" class="resource-card">
6466
<div class="card-image-wrapper">
65-
<img src="https://img.youtube.com/vi/bftUz-WBqyw/maxresdefault.jpg" alt="ADK Community Call Nov 2025">
67+
<img src="https://img.youtube.com/vi/cNVWhrbdn-E/maxresdefault.jpg" alt="ADK Community Call Dec 2025">
6668
</div>
6769
<div class="card-content">
6870
<div class="type">Community Call</div>
69-
<h3>📞 ADK Community Call (Nov 2025)</h3>
70-
<p>Discussions include the ADK Go launch, the reflect & retry plugin for error recovery, and time travel debugging for rewinding agent sessions.</p>
71+
<h3>📞 Dec 2025 Recording</h3>
72+
<p>Discussions include the ADK TypeScript launch, Gemini 3 Flash support, bidirectional streaming for voice agents, and the Visual Builder UI.</p>
7173
</div>
7274
</a>
73-
<a href="https://www.youtube.com/watch?v=A95mQaSRKik" class="resource-card">
75+
<a href="https://www.youtube.com/watch?v=bftUz-WBqyw" class="resource-card">
7476
<div class="card-image-wrapper">
75-
<img src="https://img.youtube.com/vi/A95mQaSRKik/maxresdefault.jpg" alt="ADK Community Call Oct 2025">
77+
<img src="https://img.youtube.com/vi/bftUz-WBqyw/maxresdefault.jpg" alt="ADK Community Call Nov 2025">
7678
</div>
7779
<div class="card-content">
7880
<div class="type">Community Call</div>
79-
<h3>📞 ADK Community Call (Oct 2025)</h3>
80-
<p>Discussions include the ADK roadmap, context compaction and caching for reducing cost and latency, and community contribution guidelines.</p>
81+
<h3>📞 Nov 2025 Recording</h3>
82+
<p>Discussions include the ADK Go launch, the reflect & retry plugin for error recovery, and time travel debugging for rewinding agent sessions.</p>
8183
</div>
8284
</a>
85+
8386
</div>
8487

8588
## Courses & Deep Dives

‎docs/get-started/typescript.md‎

Lines changed: 27 additions & 82 deletions
Original file line numberDiff line numberDiff line change
@@ -3,50 +3,56 @@
33
This guide shows you how to get up and running with Agent Development Kit
44
for TypeScript. Before you start, make sure you have the following installed:
55

6-
* Node.js 20.12.7 or later
7-
* Node Package Manager (npm) 9.2.0 or later
6+
* Node.js 24.13.0 or later
7+
* Node Package Manager (npm) 11.8.0 or later
88

99
## Create an agent project
1010

11-
Create an agent project with the following files and directory structure:
11+
Create an empty `my-agent` directory for your project:
1212

1313
```none
1414
my-agent/
15-
agent.ts # main agent code
16-
package.json # project configuration
17-
tsconfig.json # TypeScript configuration
18-
.env # API keys or project IDs
1915
```
2016

2117
??? tip "Create this project structure using the command line"
2218

2319
=== "MacOS / Linux"
2420

2521
```bash
26-
mkdir -p my-agent/ && \
27-
touch my-agent/agent.ts \
28-
touch my-agent/package.json \
29-
touch my-agent/.env
22+
mkdir -p my-agent/
3023
```
3124

3225
=== "Windows"
3326

3427
```console
35-
mkdir my-agent\
36-
type nul > my-agent\agent.ts
37-
type nul > my-agent\package.json
38-
type nul > my-agent\.env
28+
mkdir my-agent
3929
```
4030

41-
**Note:** Do not create `tsconfig.json`, you generate that
42-
file in a later step.
31+
### Configure project and dependencies
32+
33+
Use the `npm` tool to install and configure dependencies for your project,
34+
including the package file, ADK TypeScript main
35+
library, and developer tools. Run the following commands from your
36+
`my-agent/` directory to create the `package.json` file and install the
37+
project dependencies:
38+
39+
```console
40+
cd my-agent/
41+
# initialize a project as an ES module
42+
npm init --yes
43+
npm pkg set type="module"
44+
npm pkg set main="agent.ts"
45+
# install ADK libraries
46+
npm install @google/adk
47+
# install dev tools as a dev dependency
48+
npm install -D @google/adk-devtools
49+
```
4350

4451
### Define the agent code
4552

4653
Create the code for a basic agent, including a simple implementation of an ADK
4754
[Function Tool](/adk-docs/tools/function-tools/), called `getCurrentTime`.
48-
Add the following code to the `agent.ts` file in your project
49-
directory:
55+
Create an `agent.ts` file in your project directory and add the following code:
5056

5157
```typescript title="my-agent/agent.ts"
5258
import {FunctionTool, LlmAgent} from '@google/adk';
@@ -74,67 +80,6 @@ export const rootAgent = new LlmAgent({
7480
});
7581
```
7682

77-
### Configure project and dependencies
78-
79-
Use the `npm` tool to install and configure dependencies for your project,
80-
including the package file, TypeScript configuration, ADK TypeScript main
81-
library and developer tools. Run the following commands from your
82-
`my-agent/` directory:
83-
84-
```console
85-
cd my-agent/
86-
# initialize a project with default values
87-
npm init --yes
88-
# configure TypeScript
89-
npm install -D typescript
90-
npx tsc --init
91-
# install ADK libraries
92-
npm install @google/adk
93-
npm install @google/adk-devtools
94-
```
95-
96-
After completing these installation and configuration steps, open
97-
the `package.json` project file and verify that the `main:` value
98-
is set to `agent.ts`, that the TypeScript dependency is set, as
99-
well as the ADK library dependencies, as shown in this example:
100-
101-
```json title="my-agent/package.json"
102-
{
103-
"name": "my-agent",
104-
"version": "1.0.0",
105-
"description": "My ADK Agent",
106-
"main": "agent.ts",
107-
"scripts": {
108-
"test": "echo \"Error: no test specified\" && exit 1"
109-
},
110-
"devDependencies": {
111-
"typescript": "^5.9.3"
112-
},
113-
"dependencies": {
114-
"@google/adk": "^0.2.0",
115-
"@google/adk-devtools": "^0.2.0"
116-
}
117-
}
118-
```
119-
120-
For development convenience, in the `tsconfig.json` file, update the
121-
setting for `verbatimModuleSyntax` to `false` to allow simpler syntax
122-
when adding modules:
123-
124-
```json title="my-agent/tsconfig.json"
125-
// set to false to allow CommonJS module syntax:
126-
"verbatimModuleSyntax": false,
127-
```
128-
129-
### Compile the project
130-
131-
After completing the project setup, compile the project to prepare for
132-
running your ADK agent:
133-
134-
```console
135-
npx tsc
136-
```
137-
13883
### Set your API key
13984

14085
This project uses the Gemini API, which requires an API key. If you
@@ -166,7 +111,7 @@ Run your agent with the ADK TypeScript command-line interface tool
166111
using the following command:
167112

168113
```console
169-
npx @google/adk-devtools run agent.ts
114+
npx adk run agent.ts
170115
```
171116

172117
![adk-run.png](/adk-docs/assets/adk-run.png)
@@ -176,7 +121,7 @@ npx @google/adk-devtools run agent.ts
176121
Run your agent with the ADK web interface using the following command:
177122

178123
```console
179-
npx @google/adk-devtools web
124+
npx adk web
180125
```
181126

182127
This command starts a web server with a chat interface for your agent. You can

‎docs/javascript/copy-page.js‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
document.addEventListener('click', function(e) {
2+
var btn = e.target.closest('#copy-page-btn');
3+
if (!btn) return;
4+
5+
var svg = btn.querySelector('svg');
6+
var orig = svg.innerHTML;
7+
var check = '<path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z"/>';
8+
var x = '<path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/>';
9+
10+
fetch(btn.dataset.url)
11+
.then(function(r) { return r.text(); })
12+
.then(function(t) {
13+
navigator.clipboard.writeText(t);
14+
svg.innerHTML = check;
15+
setTimeout(function() { svg.innerHTML = orig; }, 1500);
16+
})
17+
.catch(function() {
18+
svg.innerHTML = x;
19+
setTimeout(function() { svg.innerHTML = orig; }, 1500);
20+
});
21+
});

‎docs/stylesheets/custom.css‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,18 @@
7878
width: 100%;
7979
}
8080

81+
/* Copy page button */
82+
83+
button.md-content__button {
84+
background: none;
85+
border: none;
86+
cursor: pointer;
87+
}
88+
89+
button.md-content__button:hover svg {
90+
color: var(--md-accent-fg-color);
91+
}
92+
8193
/* YouTube video grid */
8294

8395
.video-grid {

‎docs/tools/gemini-api/code-execution.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
catalog_title: Code Execution
3+
catalog_description: Execute code and debug using Gemini models
4+
catalog_icon: /adk-docs/assets/tools-gemini-spark.svg
5+
---
6+
17
# Code Execution with Gemini API
28

39
<div class="language-support-tag">

‎docs/tools/gemini-api/computer-use.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
catalog_title: Computer Use
3+
catalog_description: Operate computer user interfaces using Gemini models
4+
catalog_icon: /adk-docs/assets/tools-gemini-spark.svg
5+
---
6+
17
# Computer Use Toolset with Gemini API
28

39
<div class="language-support-tag">

‎docs/tools/gemini-api/google-search.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
catalog_title: Google Search
3+
catalog_description: Perform web searches using Google Search with Gemini
4+
catalog_icon: /adk-docs/assets/tools-google-search.png
5+
---
6+
17
# Google Search tool for ADK
28

39
<div class="language-support-tag">

‎docs/tools/gemini-api/index.md‎

Lines changed: 1 addition & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -7,36 +7,4 @@ hide:
77

88
Check out the following Gemini tools that you can use with ADK agents:
99

10-
<div class="tool-card-grid">
11-
12-
<a href="/adk-docs/tools/gemini-api/google-search/" class="tool-card">
13-
<div class="tool-card-image-wrapper">
14-
<img src="/adk-docs/assets/tools-google-search.png" alt="Google Search">
15-
</div>
16-
<div class="tool-card-content">
17-
<h3>Google Search</h3>
18-
<p>Perform web searches using Google Search with Gemini</p>
19-
</div>
20-
</a>
21-
22-
<a href="/adk-docs/tools/gemini-api/code-execution/" class="tool-card">
23-
<div class="tool-card-image-wrapper">
24-
<img src="/adk-docs/assets/tools-gemini.png" alt="Gemini">
25-
</div>
26-
<div class="tool-card-content">
27-
<h3>Code Execution</h3>
28-
<p>Execute code and debug using Gemini models</p>
29-
</div>
30-
</a>
31-
32-
<a href="/adk-docs/tools/gemini-api/computer-use/" class="tool-card">
33-
<div class="tool-card-image-wrapper">
34-
<img src="/adk-docs/assets/tools-gemini.png" alt="Gemini">
35-
</div>
36-
<div class="tool-card-content">
37-
<h3>Computer Use</h3>
38-
<p>Operate computer user interfaces using Gemini models</p>
39-
</div>
40-
</a>
41-
42-
</div>
10+
{{$ render_catalog('tools/gemini-api/*.md') $}}

0 commit comments

Comments
 (0)