"
def require_env(name: str) -> str:
value = os.getenv(name)
if not value:
raise RuntimeError(f"Missing required environment variable: {name}")
return value
cloud_client = Client(
api_key=require_env("LANGSMITH_CLOUD_API_KEY"),
api_url=CLOUD_ENDPOINT,
workspace_id=os.getenv("LANGSMITH_CLOUD_WORKSPACE_ID"),
)
byoc_client = Client(
api_key=require_env("LANGSMITH_BYOC_API_KEY"),
api_url=BYOC_ENDPOINT,
workspace_id=os.getenv("LANGSMITH_BYOC_WORKSPACE_ID"),
)
def get_workspace_routing(tenant_id: str):
"""Determine the tracing destination based on application routing logic."""
if tenant_id.startswith("byoc_"):
return byoc_client, os.getenv("LANGSMITH_BYOC_PROJECT", "byoc-customer-project")
return cloud_client, os.getenv("LANGSMITH_CLOUD_PROJECT", "cloud-customer-project")
@traceable
def run_agent_workflow(query: str):
return f"Processed: {query}"
def handle_request(tenant_id: str, query: str):
client, project_name = get_workspace_routing(tenant_id)
with tracing_context(enabled=True, client=client, project_name=project_name):
return run_agent_workflow(query)
```
## See also
* [BYOC onboarding](/langsmith/byoc-onboarding)
* [BYOC architecture](/langsmith/byoc-architecture)
***
[Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
[Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/byoc-usage.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
Use data planes for physical separation of data, and workspaces for logical separation within a data plane. Common combinations are:
| Data planes | Workspaces |
| ---------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| Per region, such as `us-east-1` and `us-west-2` | Per environment, such as dev, staging, and prod |
| Per environment and region, such as prod `us-east-1`, staging `us-east-1`, and dev `us-east-1` | Per team |
| Per business unit | Per team |
## Find your data plane endpoint
Each data plane has a base URL. Navigate to **Settings > Data Planes** to see each of your data planes, its state, and its API URL.