clarify behavior around prereleases in langsmith deployments

src/langsmith/setup-app-requirements-txt.mdx

@@ -5,6 +5,7 @@ sidebarTitle: With requirements.txt
 
 import FrameworkAgnosticPy from '/snippets/langsmith/framework-agnostic-py.mdx';
 import FrameworkAgnosticJS from '/snippets/langsmith/framework-agnostic-js.mdx';
+import PrereleaseBehavior from '/snippets/langsmith/pre-release-behavior.mdx';
 
 An application must be configured with a [configuration file](/langsmith/cli#configuration-file) in order to be deployed to LangSmith (or to be self-hosted). This how-to guide discusses the basic steps to set up an application for deployment using `requirements.txt` to specify project dependencies.
 
@@ -107,6 +108,10 @@ my-app/
 └── .env # environment variables
 ```
 
+<Tip>
+<PrereleaseBehavior/>
+</Tip>
+
 ## Define Graphs
 
 Implement your graphs. Graphs can be defined in a single file or multiple files. Make note of the variable names of each @[CompiledStateGraph] to be included in the application. The variable names will be used later when creating the [LangGraph configuration file](/langsmith/cli#configuration-file).

src/langsmith/setup-pyproject.mdx

@@ -5,6 +5,7 @@ sidebarTitle: With pyproject.toml
 
 import FrameworkAgnosticPy from '/snippets/langsmith/framework-agnostic-py.mdx';
 import FrameworkAgnosticJS from '/snippets/langsmith/framework-agnostic-js.mdx';
+import PrereleaseBehavior from '/snippets/langsmith/pre-release-behavior.mdx';
 
 An application must be configured with a [configuration file](/langsmith/cli#configuration-file) in order to be deployed to LangSmith (or to be self-hosted). This how-to guide discusses the basic steps to set up an application for deployment using `pyproject.toml` to define your package's dependencies.
 
@@ -119,6 +120,10 @@ my-app/
 └── pyproject.toml
 ```
 
+<Tip>
+<PrereleaseBehavior/>
+</Tip>
+
 ## Define Graphs
 
 Implement your graphs. Graphs can be defined in a single file or multiple files. Make note of the variable names of each @[CompiledStateGraph] to be included in the application. The variable names will be used later when creating the [configuration file](/langsmith/cli#configuration-file).

src/snippets/langsmith/pre-release-behavior.mdx

@@ -0,0 +1,4 @@
+By default, LangSmith follows the `uv`/`pip` behavior of **not** installing prerelease versions unless explicitly allowed. If want to use prereleases, you have the following options:
+
+- With `pyproject.toml`: add `allow-prereleases = true` to your `[tool.uv]` section.
+- With `requirements.txt` or `setup.py`: you must explicitly specify every prerelease dependency, including transitive ones. For example, if you declare `a==0.0.1a1` and `a` depends on `b==0.0.1a1`, then you must also explicitly include `b==0.0.1a1` in your dependencies.