Skip to content

Conversation

mingshl
Copy link
Contributor

@mingshl mingshl commented Oct 1, 2025

Description

Add doc for scratchpad tools

Issues Resolved

Closes #11146

Version

_List the OpenSearch version to which this PR applies, e.g. 3.3

Frontend features

If you're submitting documentation for an OpenSearch Dashboards feature, add a video that shows how a user will interact with the UI step by step. A voiceover is optional.

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

Signed-off-by: Mingshi Liu <mingshl@amazon.com>
Copy link

github-actions bot commented Oct 1, 2025

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Editorial review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference). The doc reviewer will arrange for an editorial review.

@kolchfa-aws kolchfa-aws added In progress Issue/PR: The issue or PR is in progress. release-notes PR: Include this PR in the automated release notes v3.3.0 labels Oct 2, 2025
@kolchfa-aws
Copy link
Collaborator

@mingshl Thank you for the PR! When you connect it to an issue, you have to leave "Closes", "Fixes", or "Resolves" so it's properly linked (in this case, Closes #11146). I updated the PR description.

Signed-off-by: Mingshi Liu <mingshl@amazon.com>
@mingshl mingshl marked this pull request as ready for review October 3, 2025 21:48
@kolchfa-aws kolchfa-aws added Tech review PR: Tech review in progress and removed In progress Issue/PR: The issue or PR is in progress. labels Oct 6, 2025
{: .label .label-purple }
<!-- vale on -->

The scratchpad tools consist of `WriteToScratchPadTool` and `ReadFromScratchPadTool`, which enable agents to store and retrieve intermediate thoughts and results in persistent memory. These tools allow agents to break down complex tasks into smaller steps, maintain state across interactions, and facilitate communication between multiple agents.
Copy link
Contributor

Choose a reason for hiding this comment

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

persistent memory here implies that the contents of scratchpad are persisted across runs, but this is not case

Parameter | Type | Required/Optional | Description
:--- | :--- | :--- | :---
`question` | String | Required | The research question or task for the agent to work on
`notes` | String | Optional | Specific notes to write to the scratchpad (when using WriteToScratchPadTool directly)
Copy link
Contributor

Choose a reason for hiding this comment

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

can u show an example for this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release-notes PR: Include this PR in the automated release notes Tech review PR: Tech review in progress v3.3.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC] Introduce ReadFromScratchPads and WriteToScratchPadsTools
3 participants