Agent Development Kit エージェントを使用する

このページでは、エージェントの使用に関する一般的な手順に加えて、AdkApp に固有の機能について説明します。

始める前に

このチュートリアルは、次の手順を読んで理解していることを前提としています。

サポートされているオペレーション

AdkApp でサポートされているオペレーションは次のとおりです。

  • stream_query: クエリへのレスポンスをストリーミングします。

  • create_session: 新しいセッションを作成する。

  • list_sessions: 利用可能なセッションを一覧表示します。

  • get_session: 特定のセッションを取得します。

  • delete_session: 特定のセッションを削除します。

サポートされているすべてのオペレーションを一覧表示するには、次のコマンドを実行します。

import pprint

pprint.pprint(remote_app.operation_schemas())

セッションの管理

AdkApp は、エージェントを Vertex AI Agent Engine にデプロイした後に、クラウドベースのマネージド セッションを使用します。このセクションでは、マネージド セッションの使用方法について説明します。

セッションを作成する

ユーザーのセッションを作成するには:

session = remote_app.create_session(user_id="USER_ID")

ここで、USER_ID は文字数制限が 128 のユーザー定義 ID です。

セッションを一覧表示する

ユーザーのセッションを一覧表示するには:

remote_app.list_sessions(user_id="USER_ID")

ここで、USER_ID は文字数制限が 128 のユーザー定義 ID です。

セッションを取得する

特定のセッションを取得するには、ユーザー ID とセッション ID の両方が必要です。

session = remote_app.get_session(user_id="USER_ID", session_id="SESSION_ID")

セッションを削除する

セッションを削除するには、ユーザー ID とセッション ID の両方が必要です。

remote_app.delete_session(user_id="USER_ID", session_id="SESSION_ID")

クエリへのレスポンスをストリーミングする

セッションでエージェントからのレスポンスをストリーミングするには:

for event in remote_app.stream_query(
    user_id="USER_ID",
    session_id="SESSION_ID",  # Optional
    message="What is the exchange rate from US dollars to SEK today?",
):
   print(event)

次のステップ