О чём урок
Этот блокнот содержит базовый, вводный пример использования Gemini в Google Agent Development Kit (ADK).
Цель: Продемонстрировать, как ADK организует простой рабочий процесс, включающий переходы состояний (START -> PROCESSING -> END) вокруг основного взаимодействия с Gemini API.
Сценарий: Вы создадите "агента с эхо-ответом и сохранением состояния". Основная задача этого агента — повторять ввод пользователя. Однако он будет использовать компоненты ADK для управления своим внутренним состоянием на протяжении всего процесса: 1. Он начинает работу в состоянии START. 2. При получении ввода он использует ADK Tool для перехода в состояние PROCESSING. 3. Он готовит эхо-ответ (неявно используя модель Gemini, настроенную в агенте). 4. Он снова использует ADK Tool для перехода в состояние END. 5. Он выдает окончательный эхо-ответ.
Этот пример подчеркивает роль ADK в управлении структурированными рабочими процессами и состоянием, даже для простых задач.
Для работы Agent с Gemini требуется доступ к Google Generative AI API. Следующая ячейка кода настраивает ваш ключ API.
Важно: В этом примере используются секреты Colab (userdata.get('GEMINI_API_KEY')). Убедитесь, что вы сохранили свой ключ с именем GEMINI_API_KEY в менеджере секретов Colab (Просмотр -> Секреты).
В этом примере используются следующие ключевые компоненты ADK:
- Agent: Агент, работающий на модели Gemini. Он понимает инструкции, решает, когда использовать инструменты, и генерирует ответы.
- FunctionTool: Пользовательская возможность, предоставляемая агенту. В данном случае это инструмент для обновления статуса рабочего процесса.
- ToolContext: Объект, автоматически передаваемый нашему инструменту, позволяющий ему получать доступ к Session State и изменять его.
- SessionService (InMemorySessionService): Управляет состоянием разговора (workflow_status). InMemory означает, что состояние существует только во время выполнения этого скрипта.
- Runner: Организует все взаимодействие: передает ввод пользователя агенту, обрабатывает вызовы инструментов, управляет состоянием через SessionService и выдает окончательный ответ.
- Session State: Словарь, содержащий данные для текущего разговора (сессии). Здесь вы используете его для хранения {'workflow_status': '...'}.
Теперь давайте определим основные компоненты ADK для нашего агента с эхо-ответом и сохранением состояния:
- Tool…
План урока
- Этот блокнот был предоставлен Anand Roy.
- Настройка
- 1. Настройте ключ Google API
- 2. Основные компоненты ADK в этой демонстрации
- 3. Определите компоненты ADK (Tool, Agent, Services)
- 4. Запустите взаимодействие
- 5. Анализ результатов
- Следующие шаги и дальнейшее обучение
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.