Skip to content

Conversation

@b4sjoo
Copy link
Contributor

@b4sjoo b4sjoo commented Oct 22, 2025

Description

Describe what this change achieves.
Add a security disclaimer for our agentic memory framework introduced in 3.3

Issues Resolved

Closes #11405

Version

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.

@github-actions
Copy link

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.

Copy link
Collaborator

@kolchfa-aws kolchfa-aws left a comment

Choose a reason for hiding this comment

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

Thanks, @b4sjoo. Please format this as a warning:

>   ****DISCLAIMER****
>
>   Lines before the list
>   * list item 1
>   * list item 2
{: .warning}

Currently, agentic memory is designed for integration with external agent frameworks like LangChain and LangGraph. OpenSearch's internal [agents]({{site.url}}{{site.baseurl}}/ml-commons-plugin/agents-tools/agents/) cannot interact with agentic memory.
{: .note}

## Disclaimer
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
## Disclaimer

{: .note}

## Disclaimer
Please be advised that the Agentic Memory capability within OpenSearch is provided as a **framework** designed to empower developers to build and manage memory for AI agents. As the administrator or owner of a memory container, you are solely responsible for the configuration, management, and security of your implementation.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Please be advised that the Agentic Memory capability within OpenSearch is provided as a **framework** designed to empower developers to build and manage memory for AI agents. As the administrator or owner of a memory container, you are solely responsible for the configuration, management, and security of your implementation.
The agentic memory capability in OpenSearch is provided as a framework that enables you to build and manage memory for AI agents. As the administrator or owner of a memory container, you are responsible for the configuration, management, and security of your implementation.


## Disclaimer
Please be advised that the Agentic Memory capability within OpenSearch is provided as a **framework** designed to empower developers to build and manage memory for AI agents. As the administrator or owner of a memory container, you are solely responsible for the configuration, management, and security of your implementation.
Specifically, you are responsible for the following:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Specifically, you are responsible for the following:
You are responsible for the following:

## Disclaimer
Please be advised that the Agentic Memory capability within OpenSearch is provided as a **framework** designed to empower developers to build and manage memory for AI agents. As the administrator or owner of a memory container, you are solely responsible for the configuration, management, and security of your implementation.
Specifically, you are responsible for the following:
1. **Data Access Control:** You are responsible for implementing and enforcing all necessary data access controls for the conversation data stored within the memory container. This includes, but is not limited to, configuring appropriate index-level permissions, document-level security (DLS), or other mechanisms to restrict access. This responsibility is especially critical when the use_system_index option is set to false, as data will be stored in a standard index that requires explicit permission management.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
1. **Data Access Control:** You are responsible for implementing and enforcing all necessary data access controls for the conversation data stored within the memory container. This includes, but is not limited to, configuring appropriate index-level permissions, document-level security (DLS), or other mechanisms to restrict access. This responsibility is especially critical when the use_system_index option is set to false, as data will be stored in a standard index that requires explicit permission management.
- Data access control: Implement and enforce all necessary data access controls for the conversation data stored within the memory container. This includes, but is not limited to, configuring appropriate index-level permissions, document-level security (DLS), or other mechanisms to restrict access. This responsibility is especially critical when the use_system_index option is set to false, because data will be stored in a standard index that requires explicit permission management.

Please be advised that the Agentic Memory capability within OpenSearch is provided as a **framework** designed to empower developers to build and manage memory for AI agents. As the administrator or owner of a memory container, you are solely responsible for the configuration, management, and security of your implementation.
Specifically, you are responsible for the following:
1. **Data Access Control:** You are responsible for implementing and enforcing all necessary data access controls for the conversation data stored within the memory container. This includes, but is not limited to, configuring appropriate index-level permissions, document-level security (DLS), or other mechanisms to restrict access. This responsibility is especially critical when the use_system_index option is set to false, as data will be stored in a standard index that requires explicit permission management.
2. **Custom System Prompt Management:** If you opt to use a customized system prompt instead of the default, you are solely responsible for the content, management, and behavior of that prompt. OpenSearch is not responsible for the outputs or interactions resulting from user-defined system prompts.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
2. **Custom System Prompt Management:** If you opt to use a customized system prompt instead of the default, you are solely responsible for the content, management, and behavior of that prompt. OpenSearch is not responsible for the outputs or interactions resulting from user-defined system prompts.
- Custom system prompt management: If you choose to use a customized system prompt instead of the default, you are responsible for the content, management, and behavior of that prompt. OpenSearch is not responsible for the outputs or interactions resulting from user-defined system prompts.

Specifically, you are responsible for the following:
1. **Data Access Control:** You are responsible for implementing and enforcing all necessary data access controls for the conversation data stored within the memory container. This includes, but is not limited to, configuring appropriate index-level permissions, document-level security (DLS), or other mechanisms to restrict access. This responsibility is especially critical when the use_system_index option is set to false, as data will be stored in a standard index that requires explicit permission management.
2. **Custom System Prompt Management:** If you opt to use a customized system prompt instead of the default, you are solely responsible for the content, management, and behavior of that prompt. OpenSearch is not responsible for the outputs or interactions resulting from user-defined system prompts.
Failure to properly configure and secure your Agentic Memory implementation may result in unauthorized data access, data leakage, or unintended agent behavior.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Failure to properly configure and secure your Agentic Memory implementation may result in unauthorized data access, data leakage, or unintended agent behavior.
Failure to properly configure and secure your agentic memory implementation may result in unauthorized data access, data leakage, or unintended agent behavior.

@kolchfa-aws
Copy link
Collaborator

@b4sjoo Also, please fix DCO

@kolchfa-aws kolchfa-aws added the Doc review PR: Doc review in progress label Oct 24, 2025
@natebower
Copy link
Collaborator

As a note prior to editorial, please don't label this a "disclaimer". A heading such as "Important", "Usage considerations", "Before you begin", or "User responsibilities" would be more appropriate.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 3.3 Doc review PR: Doc review in progress

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOC] Add a security disclaimer on agentic memory framework

3 participants