OIIT ASI - Setting Up and Using Google Jules

Anthony Westover Updated by Anthony Westover

This document quickly summarizes how to log in to Google Jules, connect it to your GitHub account and request repo access, and how to initiate autonomous tasks. These steps are distilled from Google's docs, which should be referenced for more in depth documentation: https://jules.google/docs/

Login

First, users need to login to Jules and if prompted, accept privacy notices and grant access to Workspace apps.

  1. Visit https://jules.google.com/
  2. Log in with your BPS Google account.
  3. Accept privacy notice upon first login.
  4. If prompted, grant access to your Workspace.

GitHub Connection

Jules' value is in its ability to perform autonomous work on GitHub repos. Jules needs to be connected to a GitHub with access to the BostonPublicSchools organization.

  1. In the Jules web interface, click Connect to GitHub account.
  2. Complete the necessary login for the connecting GitHub account.
  3. Select the necessary repositories under the BostonPublicSchools organization requiring access by Jules.
  4. Upon selecting repositories, you may be alerted that access needs to be reviewed by the organization owner.

Request Access (if necessary)

If access needs to be granted to the GitHub repo, follow these steps.

  1. Reach out to Bryce Avery via email or chat to ask that your request to grant access to Jules be approved.
  2. Upon having access granted, refresh the Jules web interface to confirm that the desired repos are now visible to Jules.

Initiating First Task

Now Jules can view the desired repos, so work can begin. There are several ways to initiate a task with Jules; the preferred method is via an Issue in GitHub. This creates a traceable record of Jules requests, similarly to how PRs are preferred to merge changes.

  1. Navigate to the desired repo and click the Issues tab.
  2. Click the New issue button.
  3. Give the issue a title.
  4. Fill in the description. This behave similarly to a prompt; here you should explain the task. Issues tend to lend themselves to bug reporting, but this can also be used for refactoring work as well as new features.
  5. When ready to have Jules work on the task, on the right sidebar click Labels which will pop up possible labels for the issue.
  6. Type in jules. If this is the first time, create the label. Otherwise it will be available for future issues.
  7. The Jules GitHub app listens for the jules label to be assigned to issues. Jules will post when it has started working on the task.

Reviewing Jules' Work

Jules works autonomously; it will alert when it has started a task and when it has posted a PR.

  1. Issue text is automatically pasted as the prompt into a new session. Click on the link that Jules writes to the issue to follow or review the progress of the task.
  2. When complete, review the PR that Jules creates.
  3. Review the changes.
  4. If changes are necessary, post a comment. Jules will react with an eyes emoji to indicate it sees the comment and is working on it.
  5. Wait for Jules to commit and push any necessary changes.
  6. When ready, merge Jules' changes. NOTE: Make sure to set the correct target branch. Jules may choose master, and if following Gitflow the PR should target a release branch.

How did we do?

How to Update XML T-Pass File

Report Address Issue to Google

Contact