Урок из полного доступа, первые уроки курса бесплатно Официальный курс Gemini API Cookbook на русском
Урок 46 · Текст · ~5 мин

Простой агент на ADK, который помнит состояние

Урок 46 из 84 курса «Gemini API: примеры использования»: официальный курс Gemini API Cookbook (Гугл Джемини) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Этот блокнот содержит базовый, вводный пример использования 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 для нашего агента с эхо-ответом и сохранением состояния:

  1. Tool…

План урока

  1. Этот блокнот был предоставлен Anand Roy.
  2. Настройка
  3. 1. Настройте ключ Google API
  4. 2. Основные компоненты ADK в этой демонстрации
  5. 3. Определите компоненты ADK (Tool, Agent, Services)
  6. 4. Запустите взаимодействие
  7. 5. Анализ результатов
  8. Следующие шаги и дальнейшее обучение

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Google Gemini 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Google Gemini (2 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды