mirror of
https://github.com/langchain-ai/langsmith-java.git
synced 2026-08-24 22:01:31 -04:00
ericdong-langchain
97 lines
2.9 KiB
Markdown
97 lines
2.9 KiB
Markdown
# LangSmith Examples
|
|
|
|
This module contains runnable Kotlin examples organized by feature:
|
|
- **`example/`** - SDK examples (ListRuns, Dataset, PromptManagement, RecordExperiment, E2eEval)
|
|
- **`example/otel/`** - OpenTelemetry tracing examples
|
|
|
|
## Prerequisites
|
|
|
|
All examples require:
|
|
```bash
|
|
./gradlew :langsmith-java-example:run -Pexample=ExampleName -Dlangchain.langsmithApiKey=your_api_key
|
|
```
|
|
|
|
Alternatively, you can use environment variables:
|
|
```bash
|
|
export LANGSMITH_API_KEY=your_api_key
|
|
```
|
|
|
|
The `langchain.baseUrl` system property (or `LANGSMITH_ENDPOINT` environment variable) is optional and defaults to `https://api.smith.langchain.com/` if not set.
|
|
|
|
## OpenTelemetry Tracing Examples
|
|
|
|
Located in `src/main/kotlin/com/langchain/smith/example/otel/`
|
|
|
|
### OpenAI + LangSmith (Real API Calls)
|
|
|
|
Make actual OpenAI API calls with automatic tracing to LangSmith.
|
|
|
|
```bash
|
|
./gradlew :langsmith-java-example:run -Pexample=OtelOpenAI \
|
|
-Dlangchain.langsmithApiKey=your_api_key \
|
|
-DOPENAI_API_KEY=your_openai_key \
|
|
-DLANGSMITH_PROJECT=my-project # optional, defaults to "default"
|
|
```
|
|
|
|
View traces at https://smith.langchain.com
|
|
|
|
### LangSmith (Standalone)
|
|
|
|
Send mock traces to LangSmith without external API calls.
|
|
|
|
```bash
|
|
./gradlew :langsmith-java-example:run -Pexample=OtelLangSmith \
|
|
-Dlangchain.langsmithApiKey=your_api_key \
|
|
-DLANGSMITH_PROJECT=my-project # optional, defaults to "default"
|
|
```
|
|
|
|
View traces at https://smith.langchain.com
|
|
|
|
### Spring Boot API to LangSmith
|
|
|
|
REST API with OpenTelemetry traces sent to LangSmith.
|
|
|
|
```bash
|
|
# Start server
|
|
./gradlew :langsmith-java-example:run -Pexample=SpringBootLangSmith \
|
|
-Dlangchain.langsmithApiKey=your_api_key \
|
|
-DLANGSMITH_PROJECT=my-project # optional
|
|
|
|
# In another terminal, test endpoints:
|
|
curl -X POST http://localhost:8080/api/chat \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"message": "Hello!"}'
|
|
|
|
curl "http://localhost:8080/api/analyze?text=This%20is%20great"
|
|
```
|
|
|
|
## Prompt Management Example
|
|
|
|
Located in `src/main/kotlin/com/langchain/smith/example/`
|
|
|
|
### Prompt Management (Getting Started)
|
|
|
|
**RECOMMENDED** - Clean, simple example following the same pattern as the Dataset example.
|
|
|
|
```bash
|
|
./gradlew :langsmith-java-example:run -Pexample=PromptManagement \
|
|
-Dlangchain.langsmithApiKey=your_api_key
|
|
```
|
|
|
|
**Features demonstrated:**
|
|
1. Create prompt repositories using `client.repos().create()`
|
|
2. Add prompt content with variables using `client.commits().update()`
|
|
3. List and filter prompts using `client.repos().list()`
|
|
4. Retrieve prompt content using `client.commits().retrieve()`
|
|
5. View prompts in the LangSmith UI
|
|
|
|
This example follows the [LangSmith Prompt Management docs](https://docs.langchain.com/langsmith/manage-prompts-programmatically) and uses the SDK directly.
|
|
|
|
```
|
|
|
|
**Additional features:**
|
|
- Use prompts with OpenAI to generate responses
|
|
- Update prompt metadata and descriptions
|
|
- Pull specific commit versions
|
|
- System + user message prompts
|