Skip to main content
Vijil Evaluate lets you evaluate agents that are hosted on popular LLM and Agent cloud service providers. If you do not have an agent hosted on any of these hubs, you can use the Vijil Python Client to evaluate any agent you have access to with just a few lines of code. The Vijil client can automatically spin up an endpoint for your agent, allowing you to use to test it just like you would any other model.

Prerequisites

To get started, make sure you have the following:
  1. A Vijil client. In this topic we will assume you have instantiated a Vijil client called client.
  2. An agent you want to evaluate
  3. If you are not a Vijil Premium user, an ngrok Authorization Token
You use Ngrok to create private, protected endpoints to your agent. If you are on a Free plan, you will need to get an ngrok authorization token. If you are subscribed to the premium version of Vijil, you do not need to worry about this - we take care of it for you.
Due to how Jupyter handles event loops, Vijil does NOT recommend running this code in a Jupyter notebook. Please run it in a regular Python .py script

Step 1 - Create a Local Agent Executor

In order to make your agent compatible with Vijil’s APIs, you need to create an input_adapter and an output_adapter. Like the names imply, the input_adapter transforms a ChatCompletionRequest from Vijil, into an input that your agent expects, while the output_adapter converts your agent’s output into a response that Vijil expects.
Once you have an input and output adapter, create an instance of the LocalAgentExecutor class using the client’s agents.create method, your adapters and your agent’s main function.
Note that the LocalAgentExecutor can support any function if the input and output adapters are built correctly, so you can use it to evaluate an agent written in any framework, or hosted on any platform!

Step 2 - Evaluate!

After creating the LocalAgentExecutor, use the local_agents.evaluate method to evaluate your agent. You spin up an authenticated ephemeral endpoint for your agent that can only communicate with Vijil Evaluate. This enables you to evaluate your agent without you needing to deploy it beforehand.
This method will automatically create the endpoint, register it and begin the evaluation. You will see live progress of your evaluation while it runs, and you can cancel it midway any time by pressing Ctrl + C Report generation progress If you are a power user, you can register your agent with Evaluate, trigger an evaluation via the registered url, and then shut down the server when you are done. This method is not recommended for most users because it requires you to manage the server lifecycle.

Examples

Here are some examples of how you can use this feature to evaluate agents built using some popular frameworks

LangChain

The code snippet below showcases how you can evaluate an agent built using Langchain

Google Agent Development Kit (ADK)

Google ADK is a popular and flexible new framework to develop agents. Evaluating agents built using ADK is very straightforward and uses the same steps as before. In this example, you will use the sample Travel Concierge agent from ADK’s sample agents. This is a multi-agent workflow and involves multiple agent-to-agent interactions, but you can test the entire workflow’s reliability, safety and security without needing to worry about the underlying components of the agent. You just need to create an instance of the LocalAgentExecutor class that you can run an evaluation on. To create the agent executor, you first create an ADK runner which lets you interact with the agent as a standalone function
We can now create the LocalAgentExecutor using the run_agent function and run our evaluation
Last modified on July 16, 2026