Experience library user guide
In this tutorial, you create an experience library in AgentLoop, monitor the experience mining progress, and integrate experience recall into your Agent application. By the end, your Agent can query historical experiences on demand during task execution to improve response quality and efficiency.
Workflow: Enable Agent trace collection → Create an experience library → Wait for experience mining → Browse experiences or integrate recall into your Agent
Prerequisites
Before you start, make sure the following conditions are met:
An AgentSpace is available in the AgentLoop console.
An Agent application is created and running within the AgentSpace.
The Agent application has generated trace data. The experience library can only mine data from traces that have been collected and processed.
Step 1: Enable agent trace collection
Before you create an experience library, enable Agent trace collection for your AgentSpace. After you enable this feature, AgentLoop processes ingested traces into standardized Agent traces for experience mining.
Log on to the AgentLoop console and go to the target AgentSpace.
In the left-side navigation pane, choose .
Check whether trace collection is enabled:
If the page displays Disable Trace Collection, trace collection is already enabled. No action is required.
If the page displays Enable Trace Collection, click the button to enable it.
Step 2: Create an experience library
In the left-side navigation pane, choose .
Click Create Experience Library.
Configure the following settings:
Experience Library Name: Enter a name. Only lowercase letters, digits, and underscores are supported.
Experience Library Description: (Optional) Describe the purpose of the experience library.
Agent Application: Select the Agent application that generates trace data.
Experience Extraction Start Time: Select the start time for experience mining. The system processes eligible Agent traces from this time onward.
Verify the settings and click OK.
After the experience library is created, you can view the library details on the Basic Information page.
The Agent application and experience extraction start time cannot be modified after the experience library is created. Select the appropriate Agent application and trace time range based on your actual requirements.
Step 3: Check experience mining progress
After the experience library is created, AgentLoop continuously processes Agent traces and extracts experiences at fixed mining intervals.
Go to the Basic Information page of the experience library to view the following information:
Mining Status: The running state of the current experience mining task.
Processed Until: The trace timestamp up to which the system has processed.
Data Source: The AgentSpace, Agent application, and extraction start time bound to the experience library.
When the Processed Until timestamp continues to advance, the system is processing trace data normally. After experiences are mined, you can view them on the Experience List page.
If no experiences are generated for an extended period, verify that the selected Agent application has available Agent traces after the extraction start time.
Step 4: Use the experience library
Browse experiences in the console
Go to the Experience List page of the experience library to browse mined experiences and view experience details. Use the console to review experience content and verify whether the experiences meet your expectations.
Integrate experience recall into your Agent
Install the experience recall Skill to enable your Agent to query the experience library on demand during task execution. After the Agent recalls relevant historical experiences, it can reference existing problem identification methods, solutions, and reusable workflows to improve task execution quality and efficiency.
Go to the API Key page of the experience library. Create and copy an API key.
Go to the Integration page.
Select an integration method based on your use case:
Temporary Skill installation: Suitable for quick validation or temporary integration.
Configuration file method: Suitable for long-term use in a project.
Follow the on-page instructions to complete the following steps:
Install the recall Skill.
Configure the experience library endpoint and API key.
Run a recall verification.
Use the Copy Configuration button on the right side of each step on the Integration page. The console automatically generates the endpoint and other parameters for the current experience library, which helps you avoid manual entry errors. Do not copy the example parameters from screenshots in this document.
The API key is sensitive information. Store it securely. Do not commit it to Git or write it to publicly accessible configuration files.