Stop re-exploring the same codebase You give an agent a compact, persistent map of a recurring corpus. It begins oriented while still checking current evidence for each task. java academy academy/topics/peek-orientation website/content-src/academy/course.mjs academy Stop re-exploring the same codebase
Unit 7 · Give agents memory and orientation

Stop re-exploring the same codebase

You give an agent a compact, persistent map of a recurring corpus. It begins oriented while still checking current evidence for each task.

AxAgentContextMap8 focused minutesNot started
Unit example (nearest native match)

See the idea in context

AxAgent analyst = Ax.agent(signature, Map.of(
    "contextFields", List.of("codebase"),
    "contextPolicy", Map.of("preset", "adaptive", "budget", "balanced"),
    "contextMap", Map.of("maxChars", 1800, "infiniteEvolve", false, "evolveSteps", 1)));
  1. Load prior orientation

    savedSnapshot carries useful structure learned on earlier successful runs.

  2. Keep the map compact

    maxChars bounds what is injected into the agent context.

  3. Use it as a guide

    The map points the agent toward evidence but never replaces current source.

Run itIn your own project
// Gradle (build.gradle):
implementation 'dev.axllm:ax:24.0.15'
// Maven (pom.xml):
<dependency>
  <groupId>dev.axllm</groupId>
  <artifactId>ax</artifactId>
  <version>24.0.15</version>
</dependency>

import dev.axllm.ax.Ax;
import java.util.Map;

public class QuickStart {
  public static void main(String[] args) throws Exception {
    var llm = Ax.ai("openai", Map.of("apiKey", System.getenv("OPENAI_API_KEY")));
    var classify = Ax.ax("review:string -> sentiment:class \"positive, negative, neutral\"");
    var result = classify.forward(llm, Map.of(
      "review", "Useful and boring in the best way."
    ));

    System.out.println("sentiment: " + result.get("sentiment"));
  }
}

Set OPENAI_APIKEY in your environment before running provider-backed code.

In the ax repo

From a clone of the ax repo:

npm run example -- java src/examples/java/long-agents/CodebasePeekMapExample.java
Active practice

Show that you can use it

Answer 2 in a row to learn this · attempt 1
Keep exploring

Source-backed follow-up