Usa la interfaz web¶

Soportado en ADKPython v0.1.0TypeScript v0.2.0Go v0.1.0Java v0.1.0

La interfaz web del ADK te permite probar tus agentes directamente en el navegador. Esta herramienta proporciona una forma simple de desarrollar y depurar tus agentes de manera interactiva.

ADK Web Interface

Precaución: ADK Web solo para desarrollo

ADK Web no está destinado para uso en despliegues de producción. Deberías usar ADK Web únicamente para propósitos de desarrollo y depuración.

Inicia la interfaz web¶

Usa el siguiente comando para ejecutar tu agente en la interfaz web del ADK:

PythonTypeScriptGoJava

adk web

npx adk web

go run agent.go web api webui

Asegúrate de actualizar el número de puerto.

MavenGradle

Con Maven, compila y ejecuta el servidor web del ADK:

mvn compile exec:java \
 -Dexec.args="--adk.agents.source-dir=src/main/java/agents --server.port=8080"

Con Gradle, el archivo de construcción build.gradle o build.gradle.kts debe tener el siguiente plugin de Java en su sección de plugins:

plugins {
    id('java')
    // otros plugins
}

Luego, en otra parte del archivo de construcción, en el nivel superior, crea una nueva tarea:

tasks.register('runADKWebServer', JavaExec) {
    dependsOn classes
    classpath = sourceSets.main.runtimeClasspath
    mainClass = 'com.google.adk.web.AdkWebServer'
    args '--adk.agents.source-dir=src/main/java/agents', '--server.port=8080'
}

Finalmente, en la línea de comandos, ejecuta el siguiente comando:

gradle runADKWebServer

En Java, la interfaz web y el servidor API están empaquetados juntos.

El servidor inicia en http://localhost:8000 por defecto:

+-----------------------------------------------------------------------------+
| ADK Web Server started                                                      |
|                                                                             |
| For local testing, access at http://localhost:8000.                         |
+-----------------------------------------------------------------------------+

Características¶

Las características clave de la interfaz web del ADK incluyen:

Interfaz de chat: Envía mensajes a tus agentes y visualiza respuestas en tiempo real
Gestión de sesiones: Crea y cambia entre sesiones
Inspección de estado: Visualiza y modifica el estado de la sesión durante el desarrollo
Historial de eventos: Inspecciona todos los eventos generados durante la ejecución del agente

Opciones comunes¶

Opción	Descripción	Por defecto
`--port`	Puerto en el que se ejecutará el servidor	`8000`
`--host`	Dirección de enlace del host	`127.0.0.1`
`--session_service_uri`	URI de almacenamiento de sesión personalizado	En memoria
`--artifact_service_uri`	URI de almacenamiento de artefactos personalizado	Local `.adk/artifacts`
`--reload/--no-reload`	Habilitar recarga automática en cambios de código	`true`

Ejemplo con opciones¶

adk web --port 3000 --session_service_uri "sqlite:///sessions.db"