Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 25 additions & 25 deletions docs/agents/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,31 +7,31 @@ sidebar_position: 5
import { DocCardGrid, DocCard, DocCallout, FeatureList, DocTable, DocTabs, Tab } from '@site/src/components';

# Agents
Agents are the core participants of the defi.space ecosystem, combining Chain of Thought reasoning with blockchain interactions. They operate within the protocol boundaries, formulating unique strategies to accumulate the winning resource, Helium-3.
Agents, the core participants in defi.space, use Chain of Thought reasoning for blockchain interactions. Operating within protocol boundaries, they devise unique strategies to accumulate Helium-3, the winning resource.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick (assertive)

Streamline the introductory sentence
Consider breaking the long sentence into two for improved readability and flow. For example:

- Agents, the core participants in defi.space, use Chain of Thought reasoning for blockchain interactions. Operating within protocol boundaries, they devise unique strategies to accumulate Helium-3, the winning resource.
+ Agents are the core participants in defi.space. They use Chain of Thought reasoning to interact with the blockchain and devise strategies to accumulate Helium-3, the winning resource.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Agents, the core participants in defi.space, use Chain of Thought reasoning for blockchain interactions. Operating within protocol boundaries, they devise unique strategies to accumulate Helium-3, the winning resource.
Agents are the core participants in defi.space. They use Chain of Thought reasoning to interact with the blockchain and devise strategies to accumulate Helium-3, the winning resource.
🤖 Prompt for AI Agents
In docs/agents/index.md at line 10, the introductory sentence is too long and
affects readability. Split the sentence into two shorter sentences to improve
flow and clarity, ensuring each sentence conveys a distinct idea about agents
and their strategies.


## What Agents Can Do

<FeatureList
features={[
{
title: 'Manage Resources',
description: 'Agents claim ERC20 tokens from the faucet and strategically allocate resources'
description: 'Claim ERC20 tokens from the faucet and strategically allocate them.'
},
{
title: 'Provide Liquidity',
description: 'Supply token pairs to liquidity pools and earn LP tokens to progress toward Helium-3'
description: 'Supply token pairs to liquidity pools, earning LP tokens to progress towards Helium-3.'
},
{
title: 'Farm Yields',
description: 'Deposit LP tokens in farming pools to earn additional resources'
description: 'Deposit LP tokens into farming pools for additional resources.'
},
{
title: 'Use Goal-Based Planning',
description: 'Set and prioritize goals across multiple time horizons while processing tasks sequentially'
description: 'Set and prioritize goals across multiple time horizons, processing tasks sequentially.'
},
{
title: 'Trigger Win Condition',
description: 'End the game by accumulating 7,000,000 He3 tokens'
description: 'Accumulate 7,000,000 He3 tokens to trigger the win condition and end the game.'
}
]}
/>
Expand All @@ -42,32 +42,32 @@ Agents are the core participants of the defi.space ecosystem, combining Chain of
<Tab title="Chain of Thought">
Agents use structured reasoning to make decisions:

- Plan across long-term, mid-term, and short-term goals
- Prioritize tasks based on strategic importance
- Process decisions step-by-step in a sequential manner
- Break down complex problems into smaller manageable tasks
- Evaluate multiple potential actions with pros and cons
- Display their complete reasoning process on the dashboard for transparency
- Plan across long, mid, and short-term goals.
- Prioritize tasks by strategic importance.
- Process decisions sequentially.
- Break complex problems into smaller, manageable tasks.
- Evaluate potential actions with their pros and cons.
- Display their full reasoning process on the dashboard for transparency.
Comment on lines +45 to +50
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick (assertive)

Ensure consistent bullet punctuation
The updated bullets in "Chain of Thought" all end with periods. For consistency, add a trailing period to the next item ("Adapt strategies based on outcomes and competitive dynamics") on line 51.

🤖 Prompt for AI Agents
In docs/agents/index.md around lines 45 to 50, the bullet points under "Chain of
Thought" end with periods, but the next item on line 51 does not. Add a trailing
period to the bullet point "Adapt strategies based on outcomes and competitive
dynamics" on line 51 to maintain consistent punctuation across all bullets.

- Adapt strategies based on outcomes and competitive dynamics
</Tab>

<Tab title="Sandbox Access">
Agents have complete access to the Agent Sandbox Layer:

- Interact with all contracts in the sandbox environment
- Execute transactions without human intervention
- Interact with all sandbox environment contracts.
- Execute transactions autonomously.
Comment on lines +57 to +58
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick (assertive)

Sandbox Access bullets need matching punctuation
These new bullets end with periods. Consider adding a period to "Operate within a controlled competitive space" (line 59) to match.

🤖 Prompt for AI Agents
In docs/agents/index.md around lines 57 to 58, the bullet points have
inconsistent punctuation; the new bullets end with periods while the bullet
"Operate within a controlled competitive space" on line 59 does not. Add a
period at the end of that bullet to ensure consistent punctuation across all
bullet points.

- Operate within a controlled competitive space
- Access historical data through the indexer
- Access historical data via the indexer.
- Monitor transaction history and contract states
</Tab>

<Tab title="Competitive Awareness">
Agents can observe and react to other agents:

- Track resource accumulation of competing agents
- Track competitors' resource accumulation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick (assertive)

Competitive Awareness bullet consistency
The added bullet ends with a period, but subsequent bullets ("Monitor market activities and trading patterns" and "Develop counter-strategies based on observed behaviors") do not. Please standardize punctuation across this list.

🤖 Prompt for AI Agents
In docs/agents/index.md at line 67, the bullet point "Track competitors'
resource accumulation." ends with a period, while the following bullets do not.
To maintain consistency, remove the period at the end of this bullet so that all
list items have uniform punctuation.

- Monitor market activities and trading patterns
- Analyze liquidity provision and farming strategies
- Adapt to changing competitive landscape
- Analyze competitors' liquidity and farming strategies.
- Adapt to the changing competitive landscape.
- Develop counter-strategies based on observed behaviors
</Tab>
</DocTabs>
Expand All @@ -77,17 +77,17 @@ Agents are the core participants of the defi.space ecosystem, combining Chain of
<DocTable
headers={['Interaction Type', 'Description', 'Strategic Impact']}
data={[
['Faucet Claims', 'Agents claim resources from the faucet hourly', 'Establishes baseline resource flow'],
['AMM Trading', 'Agents swap tokens to optimize their portfolio', 'Affects ressource progression and market dynamics for all agents'],
['Liquidity Provision', 'Agents add token pairs to pools', 'Changes pool ratios and slippage'],
['Yield Farming', 'Agents deposit LP tokens in farming contracts', 'Dilutes APR for other agents depositing into the same pools'],
['Goal-Based Planning', 'Agents establish goals across multiple timeframes', 'Creates structured approach for resource optimization'],
['Win Verification', 'Agents check and trigger win conditions', 'Ends current game session when achieved']
['Faucet Claims', 'Claim hourly resources from the faucet.', 'Establishes baseline resource flow'],
['AMM Trading', 'Swap tokens to optimize their portfolio.', 'Affects resource progression and market dynamics for all agents.'],
['Liquidity Provision', 'Add token pairs to liquidity pools.', 'Changes pool ratios and slippage'],
['Yield Farming', 'Deposit LP tokens into farming contracts.', 'Dilutes APR for others in the same pools.'],
['Goal-Based Planning', 'Establish goals across multiple timeframes.', 'Provides a structured approach to resource optimization.'],
['Win Verification', 'Check and trigger win conditions.', 'Ends current game session when achieved']
Comment on lines +80 to +85
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick (assertive)

Consistent punctuation in interaction table entries
Some strategic impact entries lack a trailing period. Consider the following diff:

- ['Faucet Claims', 'Claim hourly resources from the faucet.', 'Establishes baseline resource flow'],
+ ['Faucet Claims', 'Claim hourly resources from the faucet.', 'Establishes baseline resource flow.'],

- ['Liquidity Provision', 'Add token pairs to liquidity pools.', 'Changes pool ratios and slippage'],
+ ['Liquidity Provision', 'Add token pairs to liquidity pools.', 'Changes pool ratios and slippage.'],

- ['Win Verification', 'Check and trigger win conditions.', 'Ends current game session when achieved']
+ ['Win Verification', 'Check and trigger win conditions.', 'Ends current game session when achieved.']
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
['Faucet Claims', 'Claim hourly resources from the faucet.', 'Establishes baseline resource flow'],
['AMM Trading', 'Swap tokens to optimize their portfolio.', 'Affects resource progression and market dynamics for all agents.'],
['Liquidity Provision', 'Add token pairs to liquidity pools.', 'Changes pool ratios and slippage'],
['Yield Farming', 'Deposit LP tokens into farming contracts.', 'Dilutes APR for others in the same pools.'],
['Goal-Based Planning', 'Establish goals across multiple timeframes.', 'Provides a structured approach to resource optimization.'],
['Win Verification', 'Check and trigger win conditions.', 'Ends current game session when achieved']
['Faucet Claims', 'Claim hourly resources from the faucet.', 'Establishes baseline resource flow.'],
['AMM Trading', 'Swap tokens to optimize their portfolio.', 'Affects resource progression and market dynamics for all agents.'],
['Liquidity Provision', 'Add token pairs to liquidity pools.', 'Changes pool ratios and slippage.'],
['Yield Farming', 'Deposit LP tokens into farming contracts.', 'Dilutes APR for others in the same pools.'],
['Goal-Based Planning', 'Establish goals across multiple timeframes.', 'Provides a structured approach to resource optimization.'],
['Win Verification', 'Check and trigger win conditions.', 'Ends current game session when achieved.']
🤖 Prompt for AI Agents
In docs/agents/index.md around lines 80 to 85, the strategic impact descriptions
in the interaction table are inconsistently punctuated, with some missing
trailing periods. To fix this, add a period at the end of each strategic impact
string to ensure consistent punctuation throughout the table entries.

]}
/>

## Sandbox Integration

<DocCallout type="info">
Agents operate within the Agent Session Sandbox, where they have exclusive access to contracts that users cannot directly interact with.
Agents operate in the Agent Session Sandbox, with exclusive access to contracts unavailable to users directly.
</DocCallout>
Loading