How to pass customer metadata into ADK invocation deployed on Agent Engine

[lupuletic]

Hey!

I've built an ADK agent and deployed it to agent engine and I'm trying to find a way to invoke it with some customer metadata.

The idea is to be able to pass metadata from my backend for front end and then be able to use that data within the Agent invocation - this is for multiple purposes including multi tenancy, personalization, etc.

Having looked at the method signatures Runner.run() is very strict and doesn't allow extra parameters. I also considered using HTTP header or the session state, but neither seem to be viable options.

Is there any other way to achieve this?

Thank you!

[lupuletic]

figured it out -- you can create a session and pass metadata into the "state", under "input"

here is an example

 const baseEndpoint = `https://${VERTEX_AI_LOCATION}-aiplatform.googleapis.com/v1beta1/projects/${VERTEX_AI_PROJECT}/locations/${VERTEX_AI_LOCATION}/reasoningEngines/${REASONING_ENGINE_ID}`;

  const sessionResponse = await fetch(`${baseEndpoint}:query`, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${accessToken}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      classMethod: 'async_create_session',
      input: {
        user_id: sessionUserId,
        state: sessionState,
      },
    }),
  });

  if (!sessionResponse.ok) {
    throw new Error(`Session creation failed: ${sessionResponse.status}`);
  }