TreeVoyager API

Introduction

TreeVoyager is a Python-based protocol designed to implement some principles from the papers 'Tree of Thoughts' (ToT) and 'Minecraft's Voyager' to parse, generate curriculum, select HTML IDs, generate paths, and create skills (memory) for the steps required in the agent trajectory.

We developed TreeVoyager to address the lack of a standardized protocol that allows AI agents to interact with the web. This is just one way of many to mitigate the problem. TreeVoyager aims to solve this issue while also incorporating proven concepts from other agent environments (such as Minecraft's Voyager).

This API serves the TreeVoyager API service, which provides endpoints for running tasks and sequences of actions in a web environment.

TreeVoyager Functionality Diagram:

Inside TreeVoyager:

TreeVoyager's Diagram

How to use this TreeVoyager API?

You can use the /run_step endpoint, and pass the parameters of each step:

task, page, curriculum, prev_code, step

If it's the first time you run the step, just pass the "task" and "page" (URL) parameters and TreeVoyager will know it's the first time/step to run and it will create the curriculum and code for the first step.

For subsequent steps, pass the "task", "page" (if it's the same URL as the first step, pass it, or if your agent already submitted to a new page, pass the new URL), the "prev_code" (previous code) generated in the previous step and the "step" (from the curriculum) you want to execute.

Note that you can edit the "step", it doesn't need to be the exact one from the curriculum.

Endpoints:

Version: 0.9.0 Status: Development Root Endpoint: https://treevoyager.junglegym.ai/

TreeVoyager Endpoints

1. Health Check and Welcome Message

  • URL: /

  • Method: GET

  • Rate Limit: 500 requests per minute

  • Response: Returns a welcome message.

jsonCopy code{
    "message": "Hello from TreeVoyager's server. Check the full api documentation at: https://docs.junglegym.ai"
}

2. Run a Task Step-by-Step

  • URL: /run_step

  • Method: GET

  • Rate Limit: 500 requests per minute

  • Parameters:

    • task (the task you want to accomplish, "buy coffee", "rent a car", etc)

    • page (the URL of the page)

    • curriculum (leave blank the first time you run it, for subsequent steps, pass the curriculum generated in the first step)

    • prev_code (leave blank the first time you run it, for subsequent steps pass the code generated in the first or previous step)

    • step (step name from the curriculum; edit step if needed)

  • Response: Streams a sequence of JSON objects with step-by-step task execution details.

jsonCopy code{
    "task": "buy coffee",
    "curriculum": {...},
    "step_name": "Step 1...",
    ...
}

Last updated