Usar um agente do Kit de desenvolvimento de agentes

Além das instruções gerais para usar um agente, esta página descreve os recursos específicos do AdkApp.

Antes de começar

Este tutorial pressupõe que você leu e seguiu as instruções em:

Operações suportadas

As seguintes operações são compatíveis com AdkApp:

Para listar todas as operações com suporte, execute o seguinte comando:

import pprint

pprint.pprint(remote_app.operation_schemas())

Gerenciar sessões

O AdkApp usa sessões gerenciadas baseadas na nuvem depois que você implanta o agente no Vertex AI Agent Engine. Esta seção descreve como usar sessões gerenciadas.

Criar uma sessão

Para criar uma sessão para um usuário:

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

em que USER_ID é um ID definido pelo usuário com um limite de 128 caracteres.

Listar sessões

Para listar as sessões de um usuário:

remote_app.list_sessions(user_id="USER_ID")

em que USER_ID é um ID definido pelo usuário com um limite de 128 caracteres.

Acessar uma sessão

Para acessar uma sessão específica, você precisa do ID do usuário e do ID da sessão:

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

Excluir uma sessão

Para excluir uma sessão, você precisa do ID do usuário e do ID da sessão:

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

Transmitir uma resposta a uma consulta

Para transmitir as respostas de um agente em uma sessão:

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)

A seguir