From 8140ac49e4571f26bd89edd0b80e1715845fe1cf Mon Sep 17 00:00:00 2001
From: Dominik Kundel <dkundel@openai.com>
Date: Tue, 3 Jun 2025 10:48:38 -0700
Subject: [PATCH] docs: fixed links

---
 docs/src/content/docs/extensions/twilio.mdx   |  4 +--
 docs/src/content/docs/guides/agents.mdx       | 22 ++++++------
 docs/src/content/docs/guides/guardrails.mdx   | 10 +++---
 .../content/docs/guides/human-in-the-loop.mdx |  2 +-
 docs/src/content/docs/guides/models.mdx       | 32 ++++++++---------
 docs/src/content/docs/guides/quickstart.mdx   |  6 ++--
 docs/src/content/docs/guides/results.mdx      | 26 +++++++-------
 .../content/docs/guides/running-agents.mdx    | 36 +++++++++----------
 docs/src/content/docs/guides/tools.mdx        |  8 ++---
 docs/src/content/docs/guides/tracing.mdx      | 20 +++++------
 docs/src/content/docs/guides/voice-agents.mdx |  2 +-
 .../docs/guides/voice-agents/build.mdx        |  4 +--
 .../docs/guides/voice-agents/quickstart.mdx   | 22 ++++++------
 .../src/content/docs/ja/extensions/twilio.mdx |  2 +-
 docs/src/content/docs/ja/guides/agents.mdx    | 22 ++++++------
 .../src/content/docs/ja/guides/guardrails.mdx | 10 +++---
 .../docs/ja/guides/human-in-the-loop.mdx      |  2 +-
 docs/src/content/docs/ja/guides/models.mdx    | 32 ++++++++---------
 .../src/content/docs/ja/guides/quickstart.mdx |  6 ++--
 docs/src/content/docs/ja/guides/results.mdx   | 26 +++++++-------
 .../content/docs/ja/guides/running-agents.md  |  8 ++---
 .../content/docs/ja/guides/running-agents.mdx | 36 +++++++++----------
 docs/src/content/docs/ja/guides/tools.mdx     |  8 ++---
 docs/src/content/docs/ja/guides/tracing.mdx   |  8 ++---
 .../content/docs/ja/guides/voice-agents.mdx   |  2 +-
 .../docs/ja/guides/voice-agents/build.mdx     |  4 +--
 .../ja/guides/voice-agents/quickstart.mdx     | 22 ++++++------
 27 files changed, 189 insertions(+), 193 deletions(-)

diff --git a/docs/src/content/docs/extensions/twilio.mdx b/docs/src/content/docs/extensions/twilio.mdx
index 5f7f638c..029182f4 100644
--- a/docs/src/content/docs/extensions/twilio.mdx
+++ b/docs/src/content/docs/extensions/twilio.mdx
@@ -9,7 +9,7 @@ import twilioServerExample from '../../../../../examples/realtime-twilio/index.t
 
 Twilio offers a [Media Streams API](https://www.twilio.com/docs/voice/media-streams) that sends the
 raw audio from a phone call to a WebSocket server. This set up can be used to connect your
-[voice agents](../guides/voice-agents) to Twilio. You can use the default Realtime Session transport
+[voice agents](/openai-agents-js/guides/voice-agents) to Twilio. You can use the default Realtime Session transport
 in `websocket` mode to connect the events coming from Twilio to your Realtime Session. However,
 this requires you to set the right audio format and adjust your own interruption timing as phone
 calls will naturally introduce more latency than a web-based converstaion.
@@ -63,7 +63,7 @@ connection to Twilio for you, including handling interruptions and audio forward
 </Steps>
 
 Any event and behavior that you would expect from a `RealtimeSession` will work as expected
-including tool calls, guardrails, and more. Read the [voice agents guide](/guides/voice-agents)
+including tool calls, guardrails, and more. Read the [voice agents guide](/openai-agents-js/guides/voice-agents)
 for more information on how to use the `RealtimeSession` with voice agents.
 
 ## Tips and Considerations
diff --git a/docs/src/content/docs/guides/agents.mdx b/docs/src/content/docs/guides/agents.mdx
index 164d462a..470d1e87 100644
--- a/docs/src/content/docs/guides/agents.mdx
+++ b/docs/src/content/docs/guides/agents.mdx
@@ -33,13 +33,13 @@ The rest of this page walks through every Agent feature in more detail.
 The `Agent` constructor takes a single configuration object. The most commonly‑used
 properties are shown below.
 
-| Property        | Required | Description                                                                                 |
-| --------------- | -------- | ------------------------------------------------------------------------------------------- |
-| `name`          | yes      | A short human‑readable identifier.                                                          |
-| `instructions`  | yes      | System prompt (string **or** function – see [Dynamic instructions](#dynamic-instructions)). |
-| `model`         | no       | Model name **or** a custom [`Model`](/openai/agents/interfaces/model/) implementation.      |
-| `modelSettings` | no       | Tuning parameters (temperature, top_p, etc.).                                               |
-| `tools`         | no       | Array of [`Tool`](/openai/agents/type-aliases/tool/) instances the model can call.          |
+| Property        | Required | Description                                                                                             |
+| --------------- | -------- | ------------------------------------------------------------------------------------------------------- |
+| `name`          | yes      | A short human‑readable identifier.                                                                      |
+| `instructions`  | yes      | System prompt (string **or** function – see [Dynamic instructions](#dynamic-instructions)).             |
+| `model`         | no       | Model name **or** a custom [`Model`](/openai-agents-js/openai/agents/interfaces/model/) implementation. |
+| `modelSettings` | no       | Tuning parameters (temperature, top_p, etc.).                                                           |
+| `tools`         | no       | Array of [`Tool`](/openai-agents-js/openai/agents/type-aliases/tool/) instances the model can call.     |
 
 <Code lang="typescript" code={agentWithTools} title="Agent with tools" />
 
@@ -83,7 +83,7 @@ use a _triage agent_ that routes the conversation to a more specialised sub‑ag
 
 <Code lang="typescript" code={agentWithHandoffs} title="Agent with handoffs" />
 
-You can read more about this pattern in the [handoffs guide](/guides/handoffs).
+You can read more about this pattern in the [handoffs guide](/openai-agents-js/guides/handoffs).
 
 ---
 
@@ -118,7 +118,7 @@ For advanced use‑cases you can observe the Agent lifecycle by listening on eve
 
 Guardrails allow you to validate or transform user input and agent output. They are configured
 via the `inputGuardrails` and `outputGuardrails` arrays. See the
-[guardrails guide](/guides/guardrails) for details.
+[guardrails guide](/openai-agents-js/guides/guardrails) for details.
 
 ---
 
@@ -166,6 +166,6 @@ const agent = new Agent({
 
 ## Next steps
 
-- Learn how to [run agents](/guides/running-agents).
-- Dive into [tools](/guides/tools), [guardrails](/guides/guardrails), and [models](/guides/models).
+- Learn how to [run agents](/openai-agents-js/guides/running-agents).
+- Dive into [tools](/openai-agents-js/guides/tools), [guardrails](/openai-agents-js/guides/guardrails), and [models](/openai-agents-js/guides/models).
 - Explore the full TypeDoc reference under **@openai/agents** in the sidebar.
diff --git a/docs/src/content/docs/guides/guardrails.mdx b/docs/src/content/docs/guides/guardrails.mdx
index 94cfb71d..cf179607 100644
--- a/docs/src/content/docs/guides/guardrails.mdx
+++ b/docs/src/content/docs/guides/guardrails.mdx
@@ -19,8 +19,8 @@ There are two kinds of guardrails:
 Input guardrails run in three steps:
 
 1. The guardrail receives the same input passed to the agent.
-2. The guardrail function executes and returns a [`GuardrailFunctionOutput`](/openai/agents/interfaces/guardrailfunctionoutput) wrapped inside an [`InputGuardrailResult`](/openai/agents/interfaces/inputguardrailresult).
-3. If `tripwireTriggered` is `true`, an [`InputGuardrailTripwireTriggered`](/openai/agents/classes/inputguardrailtripwiretriggered) error is thrown.
+2. The guardrail function executes and returns a [`GuardrailFunctionOutput`](/openai-agents-js/openai/agents/interfaces/guardrailfunctionoutput) wrapped inside an [`InputGuardrailResult`](/openai-agents-js/openai/agents/interfaces/inputguardrailresult).
+3. If `tripwireTriggered` is `true`, an [`InputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents/classes/inputguardrailtripwiretriggered) error is thrown.
 
 > **Note**
 > Input guardrails are intended for user input, so they only run if the agent is the _first_ agent in the workflow. Guardrails are configured on the agent itself because different agents often require different guardrails.
@@ -30,11 +30,11 @@ Input guardrails run in three steps:
 Output guardrails follow the same pattern:
 
 1. The guardrail receives the same input passed to the agent.
-2. The guardrail function executes and returns a [`GuardrailFunctionOutput`](/openai/agents/interfaces/guardrailfunctionoutput) wrapped inside an [`OutputGuardrailResult`](/openai/agents/interfaces/outputguardrailresult).
-3. If `tripwireTriggered` is `true`, an [`OutputGuardrailTripwireTriggered`](/openai/agents/classes/outputguardrailtripwiretriggered) error is thrown.
+2. The guardrail function executes and returns a [`GuardrailFunctionOutput`](/openai-agents-js/openai/agents/interfaces/guardrailfunctionoutput) wrapped inside an [`OutputGuardrailResult`](/openai-agents-js/openai/agents/interfaces/outputguardrailresult).
+3. If `tripwireTriggered` is `true`, an [`OutputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents/classes/outputguardrailtripwiretriggered) error is thrown.
 
 > **Note**
-> Output guardrails only run if the agent is the _last_ agent in the workflow. For realtime voice interactions see [the voice agents guide](./voice-agents#guardrails).
+> Output guardrails only run if the agent is the _last_ agent in the workflow. For realtime voice interactions see [the voice agents guide](/openai-agents-js/guides/voice-agents/build#guardrails).
 
 ## Tripwires
 
diff --git a/docs/src/content/docs/guides/human-in-the-loop.mdx b/docs/src/content/docs/guides/human-in-the-loop.mdx
index 1b0a1752..66cc9999 100644
--- a/docs/src/content/docs/guides/human-in-the-loop.mdx
+++ b/docs/src/content/docs/guides/human-in-the-loop.mdx
@@ -29,7 +29,7 @@ You can define a tool that requires approval by setting the `needsApproval` opti
    - If approval has not been granted or rejected, the tool will return a static message to the agent that the tool call cannot be executed.
    - If approval / rejection is missing it will trigger a tool approval request.
 3. The agent will gather all tool approval requests and interrupt the execution.
-4. If there are any interruptions, the [result](/guides/result) will contain an `interruptions` array describing pending steps. A `ToolApprovalItem` with `type: "tool_approval_item"` appears when a tool call requires confirmation.
+4. If there are any interruptions, the [result](/openai-agents-js/guides/result) will contain an `interruptions` array describing pending steps. A `ToolApprovalItem` with `type: "tool_approval_item"` appears when a tool call requires confirmation.
 5. You can call `result.state.approve(interruption)` or `result.state.reject(interruption)` to approve or reject the tool call.
 6. After handling all interruptions, you can resume execution by passing the `result.state` back into `runner.run(agent, state)` where `agent` is the original agent that triggered the overall run.
 7. The flow starts again from step 1.
diff --git a/docs/src/content/docs/guides/models.mdx b/docs/src/content/docs/guides/models.mdx
index 2f97a222..0ecd1a3f 100644
--- a/docs/src/content/docs/guides/models.mdx
+++ b/docs/src/content/docs/guides/models.mdx
@@ -14,9 +14,9 @@ import setTracingExportApiKeyExample from '../../../../../examples/docs/config/s
 Every Agent ultimately calls an LLM. The SDK abstracts models behind two lightweight
 interfaces:
 
-- [`Model`](/openai/agents/interfaces/model) – knows how to make _one_ request against a
+- [`Model`](/openai-agents-js/openai/agents/interfaces/model) – knows how to make _one_ request against a
   specific API.
-- [`ModelProvider`](/openai/agents/interfaces/modelprovider) – resolves human‑readable
+- [`ModelProvider`](/openai-agents-js/openai/agents/interfaces/modelprovider) – resolves human‑readable
   model **names** (e.g. `'gpt‑4o'`) to `Model` instances.
 
 In day‑to‑day work you normally only interact with model **names** and occasionally
@@ -67,17 +67,17 @@ The OpenAI provider defaults to `gpt‑4o`. Override per agent or globally:
 
 `ModelSettings` mirrors the OpenAI parameters but is provider‑agnostic.
 
-| Field               | Type                                       | Notes                                                       |
-| ------------------- | ------------------------------------------ | ----------------------------------------------------------- |
-| `temperature`       | `number`                                   | Creativity vs. determinism.                                 |
-| `topP`              | `number`                                   | Nucleus sampling.                                           |
-| `frequencyPenalty`  | `number`                                   | Penalise repeated tokens.                                   |
-| `presencePenalty`   | `number`                                   | Encourage new tokens.                                       |
-| `toolChoice`        | `'auto' \| 'required' \| 'none' \| string` | See [forcing tool use](/guides/agents.md#forcing-tool-use). |
-| `parallelToolCalls` | `boolean`                                  | Allow parallel function calls where supported.              |
-| `truncation`        | `'auto' \| 'disabled'`                     | Token truncation strategy.                                  |
-| `maxTokens`         | `number`                                   | Maximum tokens in the response.                             |
-| `store`             | `boolean`                                  | Persist the response for retrieval / RAG workflows.         |
+| Field               | Type                                       | Notes                                                                     |
+| ------------------- | ------------------------------------------ | ------------------------------------------------------------------------- |
+| `temperature`       | `number`                                   | Creativity vs. determinism.                                               |
+| `topP`              | `number`                                   | Nucleus sampling.                                                         |
+| `frequencyPenalty`  | `number`                                   | Penalise repeated tokens.                                                 |
+| `presencePenalty`   | `number`                                   | Encourage new tokens.                                                     |
+| `toolChoice`        | `'auto' \| 'required' \| 'none' \| string` | See [forcing tool use](/openai-agents-js/guides/agents#forcing-tool-use). |
+| `parallelToolCalls` | `boolean`                                  | Allow parallel function calls where supported.                            |
+| `truncation`        | `'auto' \| 'disabled'`                     | Token truncation strategy.                                                |
+| `maxTokens`         | `number`                                   | Maximum tokens in the response.                                           |
+| `store`             | `boolean`                                  | Persist the response for retrieval / RAG workflows.                       |
 
 Attach settings at either level:
 
@@ -118,6 +118,6 @@ inspect the complete execution graph of your workflow.
 
 ## Next steps
 
-- Explore [running agents](/guides/running-agents).
-- Give your models super‑powers with [tools](/guides/tools).
-- Add [guardrails](/guides/guardrails) or [tracing](/guides/tracing) as needed.
+- Explore [running agents](/openai-agents-js/guides/running-agents).
+- Give your models super‑powers with [tools](/openai-agents-js/guides/tools).
+- Add [guardrails](/openai-agents-js/guides/guardrails) or [tracing](/openai-agents-js/guides/tracing) as needed.
diff --git a/docs/src/content/docs/guides/quickstart.mdx b/docs/src/content/docs/guides/quickstart.mdx
index e020dd8b..f4b8aa83 100644
--- a/docs/src/content/docs/guides/quickstart.mdx
+++ b/docs/src/content/docs/guides/quickstart.mdx
@@ -169,6 +169,6 @@ To review what happened during your agent run, navigate to the
 
 Learn how to build more complex agentic flows:
 
-- Learn about configuring [Agents](/guides/agents).
-- Learn about [running agents](/guides/running-agents).
-- Learn about [tools](/guides/tools), [guardrails](/guides/guardrails), and [models](/guides/models).
+- Learn about configuring [Agents](/openai-agents-js/guides/agents).
+- Learn about [running agents](/openai-agents-js/guides/running-agents).
+- Learn about [tools](/openai-agents-js/guides/tools), [guardrails](/openai-agents-js/guides/guardrails), and [models](/openai-agents-js/guides/models).
diff --git a/docs/src/content/docs/guides/results.mdx b/docs/src/content/docs/guides/results.mdx
index f4df3b2c..46d370bb 100644
--- a/docs/src/content/docs/guides/results.mdx
+++ b/docs/src/content/docs/guides/results.mdx
@@ -7,10 +7,10 @@ import { Code } from '@astrojs/starlight/components';
 import handoffFinalOutputTypes from '../../../../../examples/docs/results/handoffFinalOutputTypes.ts?raw';
 import historyLoop from '../../../../../examples/docs/results/historyLoop.ts?raw';
 
-When you [run your agent](/guides/running-agents), you will either receive a:
+When you [run your agent](/openai-agents-js/guides/running-agents), you will either receive a:
 
-- [`RunResult`](/openai/agents/classes/runresult) if you call `run` without `stream: true`
-- [`StreamedRunResult`](/openai/agents/classes/streamedrunresult) if you call `run` with `stream: true`. For details on streaming, also check the [streaming guide](/guides/streaming).
+- [`RunResult`](/openai-agents-js/openai/agents/classes/runresult) if you call `run` without `stream: true`
+- [`StreamedRunResult`](/openai-agents-js/openai/agents/classes/streamedrunresult) if you call `run` with `stream: true`. For details on streaming, also check the [streaming guide](/openai-agents-js/guides/streaming).
 
 ## Final output
 
@@ -52,23 +52,23 @@ In streaming mode it can also be useful to access the `currentAgent` property th
 
 ## New items
 
-The `newItems` property contains the new items generated during the run. The items are [`RunItem`](/openai/agents/type-aliases/runitem)s. A run item wraps the raw item generated by the LLM. These can be used to access additionally to the output of the LLM which agent these events were associated with.
+The `newItems` property contains the new items generated during the run. The items are [`RunItem`](/openai-agents-js/openai/agents/type-aliases/runitem)s. A run item wraps the raw item generated by the LLM. These can be used to access additionally to the output of the LLM which agent these events were associated with.
 
-- [`RunMessageOutputItem`](/openai/agents/classes/runmessageoutputitem) indicates a message from the LLM. The raw item is the message generated.
-- [`RunHandoffCallItem`](/openai/agents/classes/runhandoffcallitem) indicates that the LLM called the handoff tool. The raw item is the tool call item from the LLM.
-- [`RunHandoffOutputItem`](/openai/agents/classes/runhandoffoutputitem) indicates that a handoff occurred. The raw item is the tool response to the handoff tool call. You can also access the source/target agents from the item.
-- [`RunToolCallItem`](/openai/agents/classes/runtoolcallitem) indicates that the LLM invoked a tool.
-- [`RunToolCallOutputItem`](/openai/agents/classes/runtoolcalloutputitem) indicates that a tool was called. The raw item is the tool response. You can also access the tool output from the item.
-- [`RunReasoningItem`](/openai/agents/classes/runreasoningitem) indicates a reasoning item from the LLM. The raw item is the reasoning generated.
-- [`RunToolApprovalItem`](/openai/agents/classes/runtoolapprovalitem) indicates that the LLM requested approval for a tool call. The raw item is the tool call item from the LLM.
+- [`RunMessageOutputItem`](/openai-agents-js/openai/agents/classes/runmessageoutputitem) indicates a message from the LLM. The raw item is the message generated.
+- [`RunHandoffCallItem`](/openai-agents-js/openai/agents/classes/runhandoffcallitem) indicates that the LLM called the handoff tool. The raw item is the tool call item from the LLM.
+- [`RunHandoffOutputItem`](/openai-agents-js/openai/agents/classes/runhandoffoutputitem) indicates that a handoff occurred. The raw item is the tool response to the handoff tool call. You can also access the source/target agents from the item.
+- [`RunToolCallItem`](/openai-agents-js/openai/agents/classes/runtoolcallitem) indicates that the LLM invoked a tool.
+- [`RunToolCallOutputItem`](/openai-agents-js/openai/agents/classes/runtoolcalloutputitem) indicates that a tool was called. The raw item is the tool response. You can also access the tool output from the item.
+- [`RunReasoningItem`](/openai-agents-js/openai/agents/classes/runreasoningitem) indicates a reasoning item from the LLM. The raw item is the reasoning generated.
+- [`RunToolApprovalItem`](/openai-agents-js/openai/agents/classes/runtoolapprovalitem) indicates that the LLM requested approval for a tool call. The raw item is the tool call item from the LLM.
 
 ## State
 
-The `state` property contains the state of the run. Most of what is attached to the `result` is derived from the `state` but the `state` is serializable/deserializable and can also be used as input for a subsequent call to `run` in case you need to [recover from an error](/guides/running-agents#exceptions) or deal with an [`interruption`](#interruptions).
+The `state` property contains the state of the run. Most of what is attached to the `result` is derived from the `state` but the `state` is serializable/deserializable and can also be used as input for a subsequent call to `run` in case you need to [recover from an error](/openai-agents-js/guides/running-agents#exceptions) or deal with an [`interruption`](#interruptions).
 
 ## Interruptions
 
-If you are using `needsApproval` in your agent, your `run` might trigger some `interruptions` that you need to handle before continuing. In that case `interruptions` will be an array of `ToolApprovalItem`s that caused the interruption. Check out the [human-in-the-loop guide](/guides/human-in-the-loop) for more information on how to work with interruptions.
+If you are using `needsApproval` in your agent, your `run` might trigger some `interruptions` that you need to handle before continuing. In that case `interruptions` will be an array of `ToolApprovalItem`s that caused the interruption. Check out the [human-in-the-loop guide](/openai-agents-js/guides/human-in-the-loop) for more information on how to work with interruptions.
 
 ## Other information
 
diff --git a/docs/src/content/docs/guides/running-agents.mdx b/docs/src/content/docs/guides/running-agents.mdx
index 60bdd3b3..cf098905 100644
--- a/docs/src/content/docs/guides/running-agents.mdx
+++ b/docs/src/content/docs/guides/running-agents.mdx
@@ -19,7 +19,7 @@ Alternatively, you can create your own runner instance:
 
 <Code lang="typescript" code={helloWorldWithRunnerExample} title="Simple run" />
 
-After running your agent, you will receive a [result](/guides/results) object that contains the final output and the full history of the run.
+After running your agent, you will receive a [result](/openai-agents-js/guides/results) object that contains the final output and the full history of the run.
 
 ## The agent loop
 
@@ -32,7 +32,7 @@ The runner then runs a loop:
    - **Final output** → return.
    - **Handoff** → switch to the new agent, keep the accumulated conversation history, go to 1.
    - **Tool calls** → execute tools, append their results to the conversation, go to 1.
-3. Throw [`MaxTurnsExceededError`](/openai/agents-core/classes/maxturnsexceedederror) once `maxTurns` is reached.
+3. Throw [`MaxTurnsExceededError`](/openai-agents-js/openai/agents-core/classes/maxturnsexceedederror) once `maxTurns` is reached.
 
 <Aside type="note">
   The rule for whether the LLM output is considered as a "final output" is that
@@ -50,16 +50,16 @@ scripts you can also call `run()` which uses a default runner internally.
 
 The input to the `run()` method is an initial agent to start the run on, input for the run and a set of options.
 
-The input can either be a string (which is considered a user message), or a list of [input items](/openai/agents-core/type-aliases/agentinputitem), or a [`RunState`](/openai/agents-core/classes/runstate) object in case you are building a [human-in-the-loop](/guides/human-in-the-loop) agent.
+The input can either be a string (which is considered a user message), or a list of [input items](/openai-agents-js/openai/agents-core/type-aliases/agentinputitem), or a [`RunState`](/openai-agents-js/openai/agents-core/classes/runstate) object in case you are building a [human-in-the-loop](/openai-agents-js/guides/human-in-the-loop) agent.
 
 The additional options are:
 
-| Option     | Default | Description                                                                                                       |
-| ---------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
-| `stream`   | `false` | If `true` the call returns a `StreamedRunResult` and emits events as they arrive from the model.                  |
-| `context`  | –       | Context object forwarded to every tool / guardrail / handoff. Learn more in the [context guide](/guides/context). |
-| `maxTurns` | `10`    | Safety limit – throws [`MaxTurnsExceededError`](/openai/agents-core/classes/maxturnsexceedederror) when reached.  |
-| `signal`   | –       | `AbortSignal` for cancellation.                                                                                   |
+| Option     | Default | Description                                                                                                                        |
+| ---------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `stream`   | `false` | If `true` the call returns a `StreamedRunResult` and emits events as they arrive from the model.                                   |
+| `context`  | –       | Context object forwarded to every tool / guardrail / handoff. Learn more in the [context guide](/openai-agents-js/guides/context). |
+| `maxTurns` | `10`    | Safety limit – throws [`MaxTurnsExceededError`](/openai-agents-js/openai/agents-core/classes/maxturnsexceedederror) when reached.  |
+| `signal`   | –       | `AbortSignal` for cancellation.                                                                                                    |
 
 ## Streaming
 
@@ -101,12 +101,12 @@ See [the chat example](https://github.com/openai/openai-agents-js/tree/main/exam
 
 The SDK throws a small set of errors you can catch:
 
-- [`MaxTurnsExceededError`](/openai/agents-core/classes/maxturnsexceedederror) – `maxTurns` reached.
-- [`ModelBehaviorError`](/openai/agents-core/classes/modelbehaviorerror) – model produced invalid output (e.g. malformed JSON, unknown tool).
-- [`InputGuardrailTripwireTriggered`](/openai/agents-core/classes/inputguardrailtripwiretriggered) / [`OutputGuardrailTripwireTriggered`](/openai/agents-core/classes/outputguardrailtripwiretriggered) – guardrail violations.
-- [`GuardrailExecutionError`](/openai/agents-core/classes/guardrailexecutionerror) – guardrails failed to complete.
-- [`ToolCallError`](/openai/agents-core/classes/toolcallerror) – any of function tool calls failed.
-- [`UserError`](/openai/agents-core/classes/usererror) – any error thrown based on configuration or user input.
+- [`MaxTurnsExceededError`](/openai-agents-js/openai/agents-core/classes/maxturnsexceedederror) – `maxTurns` reached.
+- [`ModelBehaviorError`](/openai-agents-js/openai/agents-core/classes/modelbehaviorerror) – model produced invalid output (e.g. malformed JSON, unknown tool).
+- [`InputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents-core/classes/inputguardrailtripwiretriggered) / [`OutputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents-core/classes/outputguardrailtripwiretriggered) – guardrail violations.
+- [`GuardrailExecutionError`](/openai-agents-js/openai/agents-core/classes/guardrailexecutionerror) – guardrails failed to complete.
+- [`ToolCallError`](/openai-agents-js/openai/agents-core/classes/toolcallerror) – any of function tool calls failed.
+- [`UserError`](/openai-agents-js/openai/agents-core/classes/usererror) – any error thrown based on configuration or user input.
 
 All extend the base `AgentsError` class, which could provide the `state` property to access the current run state.
 
@@ -129,6 +129,6 @@ Math homework guardrail tripped
 
 ## Next steps
 
-- Learn how to [configure models](/guides/models).
-- Provide your agents with [tools](/guides/tools).
-- Add [guardrails](/guides/guardrails) or [tracing](/guides/tracing) for production readiness.
+- Learn how to [configure models](/openai-agents-js/guides/models).
+- Provide your agents with [tools](/openai-agents-js/guides/tools).
+- Add [guardrails](/openai-agents-js/guides/guardrails) or [tracing](/openai-agents-js/guides/tracing) for production readiness.
diff --git a/docs/src/content/docs/guides/tools.mdx b/docs/src/content/docs/guides/tools.mdx
index 8fb25a43..5498dabc 100644
--- a/docs/src/content/docs/guides/tools.mdx
+++ b/docs/src/content/docs/guides/tools.mdx
@@ -88,7 +88,7 @@ Under the hood the SDK:
 
 ## Tool use behaviour
 
-Refer to the [Agents guide](/guides/agents#forcing-tool-use) for controlling when and how a model
+Refer to the [Agents guide](/openai-agents-js/guides/agents#forcing-tool-use) for controlling when and how a model
 must use tools (`tool_choice`, `toolUseBehavior`, etc.).
 
 ---
@@ -104,6 +104,6 @@ must use tools (`tool_choice`, `toolUseBehavior`, etc.).
 
 ## Next steps
 
-- Learn about [forcing tool use](/guides/agents#forcing-tool-use).
-- Add [guardrails](/guides/guardrails) to validate tool inputs or outputs.
-- Dive into the TypeDoc reference for [`tool()`](/openai/agents/functions/tool) and the various hosted tool types.
+- Learn about [forcing tool use](/openai-agents-js/guides/agents#forcing-tool-use).
+- Add [guardrails](/openai-agents-js/guides/guardrails) to validate tool inputs or outputs.
+- Dive into the TypeDoc reference for [`tool()`](/openai-agents-js/openai/agents/functions/tool) and the various hosted tool types.
diff --git a/docs/src/content/docs/guides/tracing.mdx b/docs/src/content/docs/guides/tracing.mdx
index 0af4d07f..25b95e48 100644
--- a/docs/src/content/docs/guides/tracing.mdx
+++ b/docs/src/content/docs/guides/tracing.mdx
@@ -16,7 +16,7 @@ workflows during development and in production.
 Tracing is enabled by default. There are two ways to disable tracing:
 
 1. You can globally disable tracing by setting the env var `OPENAI_AGENTS_DISABLE_TRACING=1`
-2. You can disable tracing for a single run by setting [`RunConfig.tracingDisabled`](/openai/agents-core/type-aliases/runconfig/#tracingdisabled) to `true`
+2. You can disable tracing for a single run by setting [`RunConfig.tracingDisabled`](/openai-agents-js/openai/agents-core/type-aliases/runconfig/#tracingdisabled) to `true`
 
 **_For organizations operating under a Zero Data Retention (ZDR) policy using OpenAI's APIs, tracing is unavailable._**
 
@@ -47,7 +47,7 @@ By default, the SDK traces the following:
 - Guardrails are wrapped in `GuardrailSpan`
 - Handoffs are wrapped in `HandoffSpan`
 
-By default, the trace is named "Agent workflow". You can set this name if you use `withTrace`, or you can can configure the name and other properties with the [`RunConfig.workflowName`](/openai/agents-core/type-aliases/runconfig/#workflowname).
+By default, the trace is named "Agent workflow". You can set this name if you use `withTrace`, or you can can configure the name and other properties with the [`RunConfig.workflowName`](/openai-agents-js/openai/agents-core/type-aliases/runconfig/#workflowname).
 
 In addition, you can set up [custom trace processors](#custom-tracing-processors) to push traces to other destinations (as a replacement, or secondary destination).
 
@@ -55,7 +55,7 @@ In addition, you can set up [custom trace processors](#custom-tracing-processors
 
 If you are using `RealtimeAgent` and `RealtimeSession` with the default OpenAI Realtime API, tracing will automatically happen on the Realtime API side unless you disable it on the `RealtimeSession` using `tracingDisabled: true` or using the `OPENAI_AGENTS_DISABLE_TRACING` environment variable.
 
-Check out the [Voice agents guide](/guides/voice-agents) for more details.
+Check out the [Voice agents guide](/openai-agents-js/guides/voice-agents) for more details.
 
 ## Higher level traces
 
@@ -67,13 +67,13 @@ Sometimes, you might want multiple calls to `run()` to be part of a single trace
 
 ## Creating traces
 
-You can use the [`withTrace()`](/openai/agents-core/functions/withtrace/) function to create a trace. Alternatively, you can use `getGlobalTraceProvider().createTrace()` to create a new trace manually and pass it into `withTrace()`.
+You can use the [`withTrace()`](/openai-agents-js/openai/agents-core/functions/withtrace/) function to create a trace. Alternatively, you can use `getGlobalTraceProvider().createTrace()` to create a new trace manually and pass it into `withTrace()`.
 
 The current trace is tracked via a [Node.js `AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage) or the respective environment polyfills. This means that it works with concurrency automatically.
 
 ## Creating spans
 
-You can use the various `create*Span()` (e.g. `createGenerationSpan()`, `createFunctionSpan()`, etc.) methods to create a span. In general, you don't need to manually create spans. A [`createCustomSpan()`](/openai/agents-core/functions/createcustomspan/) function is available for tracking custom span information.
+You can use the various `create*Span()` (e.g. `createGenerationSpan()`, `createFunctionSpan()`, etc.) methods to create a span. In general, you don't need to manually create spans. A [`createCustomSpan()`](/openai-agents-js/openai/agents-core/functions/createcustomspan/) function is available for tracking custom span information.
 
 Spans are automatically part of the current trace, and are nested under the nearest current span, which is tracked via a [Node.js `AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage) or the respective environment polyfills.
 
@@ -82,16 +82,16 @@ Spans are automatically part of the current trace, and are nested under the near
 Certain spans may capture potentially sensitive data.
 
 The `createGenerationSpan()` stores the inputs/outputs of the LLM generation, and `createFunctionSpan()` stores the inputs/outputs of function calls. These may contain sensitive data, so you can disable capturing that data via [`RunConfig.traceIncludeSensitiveData
-`](/openai/agents-core/type-aliases/runconfig/#traceincludesensitivedata).
+`](/openai-agents-js/openai/agents-core/type-aliases/runconfig/#traceincludesensitivedata).
 
 ## Custom tracing processors
 
 The high level architecture for tracing is:
 
-- At initialization, we create a global [`TraceProvider`](/openai/agents-core/classes/traceprovider), which is responsible for creating traces and can be accessed through [`getGlobalTraceProvider()`](/openai/agents-core/functions/getglobaltraceprovider/).
-- We configure the `TraceProvider` with a [`BatchTraceProcessor`](/openai/agents-core/classes/batchtraceprocessor/) that sends traces/spans in batches to a [`OpenAITracingExporter`](/openai/agents-openai/classes/openaitracingexporter/), which exports the spans and traces to the OpenAI backend in batches.
+- At initialization, we create a global [`TraceProvider`](/openai-agents-js/openai/agents-core/classes/traceprovider), which is responsible for creating traces and can be accessed through [`getGlobalTraceProvider()`](/openai-agents-js/openai/agents-core/functions/getglobaltraceprovider/).
+- We configure the `TraceProvider` with a [`BatchTraceProcessor`](/openai-agents-js/openai/agents-core/classes/batchtraceprocessor/) that sends traces/spans in batches to a [`OpenAITracingExporter`](/openai-agents-js/openai/agents-openai/classes/openaitracingexporter/), which exports the spans and traces to the OpenAI backend in batches.
 
 To customize this default setup, to send traces to alternative or additional backends or modifying exporter behavior, you have two options:
 
-1. [`addTraceProcessor()`](/openai/agents-core/functions/addtraceprocessor) lets you add an **additional** trace processor that will receive traces and spans as they are ready. This lets you do your own processing in addition to sending traces to OpenAI's backend.
-2. [`setTraceProcessors()`](/openai/agents-core/functions/settraceprocessors) lets you **replace** the default processors with your own trace processors. This means traces will not be sent to the OpenAI backend unless you include a `TracingProcessor` that does so.
+1. [`addTraceProcessor()`](/openai-agents-js/openai/agents-core/functions/addtraceprocessor) lets you add an **additional** trace processor that will receive traces and spans as they are ready. This lets you do your own processing in addition to sending traces to OpenAI's backend.
+2. [`setTraceProcessors()`](/openai-agents-js/openai/agents-core/functions/settraceprocessors) lets you **replace** the default processors with your own trace processors. This means traces will not be sent to the OpenAI backend unless you include a `TracingProcessor` that does so.
diff --git a/docs/src/content/docs/guides/voice-agents.mdx b/docs/src/content/docs/guides/voice-agents.mdx
index 4515d644..e59564d5 100644
--- a/docs/src/content/docs/guides/voice-agents.mdx
+++ b/docs/src/content/docs/guides/voice-agents.mdx
@@ -31,7 +31,7 @@ The Voice Agents SDK provides a TypeScript client for the [OpenAI Realtime API](
 
 <LinkCard
   title="Voice Agents Quickstart"
-  href="/guides/voice-agents/quickstart"
+  href="/openai-agents-js/guides/voice-agents/quickstart"
   description="Build your first realtime voice assistant using the OpenAI Agents SDK in minutes."
 />
 
diff --git a/docs/src/content/docs/guides/voice-agents/build.mdx b/docs/src/content/docs/guides/voice-agents/build.mdx
index a78493d6..534b198f 100644
--- a/docs/src/content/docs/guides/voice-agents/build.mdx
+++ b/docs/src/content/docs/guides/voice-agents/build.mdx
@@ -38,14 +38,14 @@ handle session audio yourself:
 
 ## Session configuration
 
-You can configure your session by passing additional options to either the [`RealtimeSession`](/openai/agents-realtime/classes/realtimesession/) during construction or
+You can configure your session by passing additional options to either the [`RealtimeSession`](/openai-agents-js/openai/agents-realtime/classes/realtimesession/) during construction or
 when you call `connect(...)`.
 
 <Code lang="typescript" code={configureSessionExample} />
 
 These transport layers allow you to pass any parameter that matches [session](https://platform.openai.com/docs/api-reference/realtime-client-events/session/update).
 
-For parameters that are new and don't have a matching parameter in the [RealtimeSessionConfig](/openai/agents-realtime/type-aliases/realtimesessionconfig/) you can use `providerData`. Anything passed in `providerData` will be passed directly as part of the `session` object.
+For parameters that are new and don't have a matching parameter in the [RealtimeSessionConfig](/openai-agents-js/openai/agents-realtime/type-aliases/realtimesessionconfig/) you can use `providerData`. Anything passed in `providerData` will be passed directly as part of the `session` object.
 
 ## Handoffs
 
diff --git a/docs/src/content/docs/guides/voice-agents/quickstart.mdx b/docs/src/content/docs/guides/voice-agents/quickstart.mdx
index b44511d1..89d38e37 100644
--- a/docs/src/content/docs/guides/voice-agents/quickstart.mdx
+++ b/docs/src/content/docs/guides/voice-agents/quickstart.mdx
@@ -34,8 +34,6 @@ import thinClientExample from '../../../../../../examples/docs/voice-agents/thin
    npm create vite@latest my-project --template vanilla-ts
    ```
 
-   Alternatively, you can use [Stackblitz](https://stackblitz.com/github/openai/openai-agents-js/tree/examples/realtime-demo) to create a new project directly within your browser.
-
 1. **Install the Agents SDK**
 
    ```bash
@@ -61,7 +59,7 @@ import thinClientExample from '../../../../../../examples/docs/voice-agents/thin
 
 3. **Create your first Agent**
 
-   Creating a new [`RealtimeAgent`](/openai/agents-realtime/classes/realtimeagent/) is very similar to creating a regular [`Agent`](/docs/agents).
+   Creating a new [`RealtimeAgent`](/openai-agents-js/openai/agents-realtime/classes/realtimeagent/) is very similar to creating a regular [`Agent`](/openai-agents-js/guides/agents).
 
    ```typescript
    import { RealtimeAgent } from '@openai/agents-realtime';
@@ -94,7 +92,7 @@ import thinClientExample from '../../../../../../examples/docs/voice-agents/thin
    await session.connect({ apiKey: '<client-api-key>' });
    ```
 
-   This will connect to the Realtime API using WebRTC in the browser and automatically configure your microphone and speaker for audio input and output. If you are running your `RealtimeSession` on a backend server (like Node.js) the SDK will automatically use WebSocket as a connection. You can learn more about the different transport layers in the [Realtime Transport Layer](/guides/voice-agents/transport) guide.
+   This will connect to the Realtime API using WebRTC in the browser and automatically configure your microphone and speaker for audio input and output. If you are running your `RealtimeSession` on a backend server (like Node.js) the SDK will automatically use WebSocket as a connection. You can learn more about the different transport layers in the [Realtime Transport Layer](/openai-agents-js/guides/voice-agents/transport) guide.
 
 6. **Putting it all together**
 
@@ -116,14 +114,14 @@ From here you can start designing and building your own voice agent. Voice agent
 
 - Learn how to give your voice agent:
 
-  - [Tools](/guides/voice-agents/build#tools)
-  - [Handoffs](/guides/voice-agents/build#handoffs)
-  - [Guardrails](/guides/voice-agents/build#guardrails)
-  - [Handle audio interruptions](/guides/voice-agents/build#audio-interruptions)
-  - [Manage session history](/guides/voice-agents/build#session-history)
+  - [Tools](/openai-agents-js/guides/voice-agents/build#tools)
+  - [Handoffs](/openai-agents-js/guides/voice-agents/build#handoffs)
+  - [Guardrails](/openai-agents-js/guides/voice-agents/build#guardrails)
+  - [Handle audio interruptions](/openai-agents-js/guides/voice-agents/build#audio-interruptions)
+  - [Manage session history](/openai-agents-js/guides/voice-agents/build#session-history)
 
 - Learn more about the different transport layers.
 
-  - [WebRTC](/guides/voice-agents/transport#connecting-over-webrtc)
-  - [WebSocket](/guides/voice-agents/transport#connecting-over-websocket)
-  - [Building your own transport mechanism](/guides/voice-agents/transport#building-your-own-transport-mechanism)
+  - [WebRTC](/openai-agents-js/guides/voice-agents/transport#connecting-over-webrtc)
+  - [WebSocket](/openai-agents-js/guides/voice-agents/transport#connecting-over-websocket)
+  - [Building your own transport mechanism](/openai-agents-js/guides/voice-agents/transport#building-your-own-transport-mechanism)
diff --git a/docs/src/content/docs/ja/extensions/twilio.mdx b/docs/src/content/docs/ja/extensions/twilio.mdx
index 5ea5028f..ad0e89d5 100644
--- a/docs/src/content/docs/ja/extensions/twilio.mdx
+++ b/docs/src/content/docs/ja/extensions/twilio.mdx
@@ -53,7 +53,7 @@ Twilio は [Media Streams API](https://www.twilio.com/docs/voice/media-streams)
 
 </Steps>
 
-`RealtimeSession` で期待できるすべてのイベントや挙動 ― ツール呼び出し、ガードレール など ― がそのまま機能します。`RealtimeSession` を音声エージェントで使用する方法は、[音声エージェントの概要](/ja/guides/voice-agents) を参照してください。
+`RealtimeSession` で期待できるすべてのイベントや挙動 ― ツール呼び出し、ガードレール など ― がそのまま機能します。`RealtimeSession` を音声エージェントで使用する方法は、[音声エージェントの概要](/openai-agents-js/ja/guides/voice-agents) を参照してください。
 
 ## ヒントと注意事項
 
diff --git a/docs/src/content/docs/ja/guides/agents.mdx b/docs/src/content/docs/ja/guides/agents.mdx
index fa53c345..9937bf53 100644
--- a/docs/src/content/docs/ja/guides/agents.mdx
+++ b/docs/src/content/docs/ja/guides/agents.mdx
@@ -30,13 +30,13 @@ OpenAI Agents SDK の主要な構成要素は **エージェント** です。**
 
 `Agent` コンストラクターは 1 つの設定オブジェクトを受け取ります。よく利用されるプロパティは次のとおりです。
 
-| Property        | Required | Description                                                                                     |
-| --------------- | -------- | ----------------------------------------------------------------------------------------------- |
-| `name`          | yes      | 人間が読みやすい短い識別子                                                                      |
-| `instructions`  | yes      | システムプロンプト (文字列 **または** 関数 – [動的 instructions](#dynamic-instructions) を参照) |
-| `model`         | no       | モデル名 **または** カスタム [`Model`](/openai/agents/interfaces/model/) 実装                   |
-| `modelSettings` | no       | チューニングパラメーター (temperature, top_p など)                                              |
-| `tools`         | no       | モデルが呼び出せる [`Tool`](/openai/agents/type-aliases/tool/) インスタンスの配列               |
+| Property        | Required | Description                                                                                        |
+| --------------- | -------- | -------------------------------------------------------------------------------------------------- |
+| `name`          | yes      | 人間が読みやすい短い識別子                                                                         |
+| `instructions`  | yes      | システムプロンプト (文字列 **または** 関数 – [動的 instructions](#dynamic-instructions) を参照)    |
+| `model`         | no       | モデル名 **または** カスタム [`Model`](/openai-agents-js/openai/agents/interfaces/model/) 実装     |
+| `modelSettings` | no       | チューニングパラメーター (temperature, top_p など)                                                 |
+| `tools`         | no       | モデルが呼び出せる [`Tool`](/openai-agents-js/openai/agents/type-aliases/tool/) インスタンスの配列 |
 
 <Code lang="typescript" code={agentWithTools} title="Agent with tools" />
 
@@ -73,7 +73,7 @@ OpenAI Agents SDK の主要な構成要素は **エージェント** です。**
 
 <Code lang="typescript" code={agentWithHandoffs} title="Agent with handoffs" />
 
-このパターンの詳細は [ハンドオフ](/ja/guides/handoffs) を参照してください。
+このパターンの詳細は [ハンドオフ](/openai-agents-js/ja/guides/handoffs) を参照してください。
 
 ---
 
@@ -105,7 +105,7 @@ OpenAI Agents SDK の主要な構成要素は **エージェント** です。**
 
 ## ガードレール
 
-ガードレールを使用すると、ユーザー入力やエージェント出力の検証・変換が可能です。`inputGuardrails` と `outputGuardrails` 配列で設定します。詳細は [ガードレール](/ja/guides/guardrails) をご覧ください。
+ガードレールを使用すると、ユーザー入力やエージェント出力の検証・変換が可能です。`inputGuardrails` と `outputGuardrails` 配列で設定します。詳細は [ガードレール](/openai-agents-js/ja/guides/guardrails) をご覧ください。
 
 ---
 
@@ -148,6 +148,6 @@ const agent = new Agent({
 
 ## 次のステップ
 
-- [エージェントの実行](/ja/guides/running-agents) を学ぶ
-- [ツール](/ja/guides/tools)、[ガードレール](/ja/guides/guardrails)、[モデル](/ja/guides/models) をさらに深掘り
+- [エージェントの実行](/openai-agents-js/ja/guides/running-agents) を学ぶ
+- [ツール](/openai-agents-js/ja/guides/tools)、[ガードレール](/openai-agents-js/ja/guides/guardrails)、[モデル](/openai-agents-js/ja/guides/models) をさらに深掘り
 - サイドバーの **@openai/agents** で TypeDoc 全リファレンスを確認
diff --git a/docs/src/content/docs/ja/guides/guardrails.mdx b/docs/src/content/docs/ja/guides/guardrails.mdx
index ee91c5e8..d430ff3d 100644
--- a/docs/src/content/docs/ja/guides/guardrails.mdx
+++ b/docs/src/content/docs/ja/guides/guardrails.mdx
@@ -19,8 +19,8 @@ import outputGuardrailExample from '../../../../../../examples/docs/guardrails/g
 Input guardrails は次の 3 ステップで実行されます。
 
 1. ガードレールはエージェントに渡されたものと同じ入力を受け取ります
-2. ガードレール関数が実行され、[`GuardrailFunctionOutput`](/openai/agents/interfaces/guardrailfunctionoutput) を [`InputGuardrailResult`](/openai/agents/interfaces/inputguardrailresult) にラップして返します
-3. `tripwireTriggered` が `true` の場合、[`InputGuardrailTripwireTriggered`](/openai/agents/classes/inputguardrailtripwiretriggered) エラーがスローされます
+2. ガードレール関数が実行され、[`GuardrailFunctionOutput`](/openai-agents-js/openai/agents/interfaces/guardrailfunctionoutput) を [`InputGuardrailResult`](/openai-agents-js/openai/agents/interfaces/inputguardrailresult) にラップして返します
+3. `tripwireTriggered` が `true` の場合、[`InputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents/classes/inputguardrailtripwiretriggered) エラーがスローされます
 
 > **Note**  
 > Input guardrails はユーザー入力を対象としているため、ワークフローでエージェントが _最初_ のエージェントである場合にのみ実行されます。ガードレールはエージェントごとに設定します。異なるエージェントでは必要なガードレールが異なることが多いためです。
@@ -30,11 +30,11 @@ Input guardrails は次の 3 ステップで実行されます。
 Output guardrails も同じパターンで動作します。
 
 1. ガードレールはエージェントに渡されたものと同じ入力を受け取ります
-2. ガードレール関数が実行され、[`GuardrailFunctionOutput`](/openai/agents/interfaces/guardrailfunctionoutput) を [`OutputGuardrailResult`](/openai/agents/interfaces/outputguardrailresult) にラップして返します
-3. `tripwireTriggered` が `true` の場合、[`OutputGuardrailTripwireTriggered`](/openai/agents/classes/outputguardrailtripwiretriggered) エラーがスローされます
+2. ガードレール関数が実行され、[`GuardrailFunctionOutput`](/openai-agents-js/openai/agents/interfaces/guardrailfunctionoutput) を [`OutputGuardrailResult`](/openai-agents-js/openai/agents/interfaces/outputguardrailresult) にラップして返します
+3. `tripwireTriggered` が `true` の場合、[`OutputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents/classes/outputguardrailtripwiretriggered) エラーがスローされます
 
 > **Note**  
-> Output guardrails はワークフローでエージェントが _最後_ のエージェントである場合にのみ実行されます。リアルタイム音声インタラクションについては [the voice agents guide](./voice-agents#guardrails) を参照してください。
+> Output guardrails はワークフローでエージェントが _最後_ のエージェントである場合にのみ実行されます。リアルタイム音声インタラクションについては [the voice agents guide](/openai-agents-js/ja/guides/voice-agents#guardrails) を参照してください。
 
 ## Tripwires
 
diff --git a/docs/src/content/docs/ja/guides/human-in-the-loop.mdx b/docs/src/content/docs/ja/guides/human-in-the-loop.mdx
index 032b66bd..eb4e7029 100644
--- a/docs/src/content/docs/ja/guides/human-in-the-loop.mdx
+++ b/docs/src/content/docs/ja/guides/human-in-the-loop.mdx
@@ -29,7 +29,7 @@ import toolApprovalDefinition from '../../../../../../examples/docs/human-in-the
    - まだ許可・拒否されていない場合、ツールは「ツール呼び出しを実行できない」という固定メッセージをエージェントに返します
    - 許可 / 拒否が未決の場合、ツール承認リクエストをトリガーします
 3. エージェントはすべてのツール承認リクエストを集め、実行を中断します
-4. 中断がある場合、[実行結果](/ja/guides/result) には保留中のステップを示す `interruptions` 配列が含まれます。ツール呼び出しに確認が必要なときは `type: "tool_approval_item"` の `ToolApprovalItem` が現れます
+4. 中断がある場合、[実行結果](/openai-agents-js/ja/guides/result) には保留中のステップを示す `interruptions` 配列が含まれます。ツール呼び出しに確認が必要なときは `type: "tool_approval_item"` の `ToolApprovalItem` が現れます
 5. `result.state.approve(interruption)` または `result.state.reject(interruption)` を呼び出してツール呼び出しを許可・拒否できます
 6. すべての中断を処理したら、`result.state` を `runner.run(agent, state)` に渡して実行を再開します。ここで `agent` は最初に実行を開始させたエージェントです
 7. フローは 1 に戻ります
diff --git a/docs/src/content/docs/ja/guides/models.mdx b/docs/src/content/docs/ja/guides/models.mdx
index adee91c6..1da7dd9c 100644
--- a/docs/src/content/docs/ja/guides/models.mdx
+++ b/docs/src/content/docs/ja/guides/models.mdx
@@ -13,8 +13,8 @@ import setTracingExportApiKeyExample from '../../../../../../examples/docs/confi
 
 最終的にすべての エージェント は LLM を呼び出します。SDK はモデルを次の 2 つの軽量インターフェースの背後に抽象化します:
 
-- [`Model`](/openai/agents/interfaces/model) – 特定 API への _1 回_ のリクエスト方法を知っています
-- [`ModelProvider`](/openai/agents/interfaces/modelprovider) – 人間が読みやすいモデル **名** (例: `'gpt-4o'`) を `Model` インスタンスへ解決します
+- [`Model`](/openai-agents-js/openai/agents/interfaces/model) – 特定 API への _1 回_ のリクエスト方法を知っています
+- [`ModelProvider`](/openai-agents-js/openai/agents/interfaces/modelprovider) – 人間が読みやすいモデル **名** (例: `'gpt-4o'`) を `Model` インスタンスへ解決します
 
 日常的にはモデル **名** と、時折 `ModelSettings` のみを扱います。
 
@@ -61,17 +61,17 @@ OpenAI プロバイダーのデフォルトは `gpt-4o` です。エージェン
 
 `ModelSettings` は OpenAI のパラメーターを反映しつつ、プロバイダー非依存です。
 
-| フィールド          | 型                                         | メモ                                                            |
-| ------------------- | ------------------------------------------ | --------------------------------------------------------------- |
-| `temperature`       | `number`                                   | 創造性と決定論のバランス                                        |
-| `topP`              | `number`                                   | ニュークリアスサンプリング                                      |
-| `frequencyPenalty`  | `number`                                   | 繰り返しトークンのペナルティ                                    |
-| `presencePenalty`   | `number`                                   | 新しいトークンを促進                                            |
-| `toolChoice`        | `'auto' \| 'required' \| 'none' \| string` | [ツールの使用を強制する](/ja/guides/agents.md#forcing-tool-use) |
-| `parallelToolCalls` | `boolean`                                  | 対応している場合に並列関数呼び出しを許可                        |
-| `truncation`        | `'auto' \| 'disabled'`                     | トークン切り詰め戦略                                            |
-| `maxTokens`         | `number`                                   | 応答内の最大トークン数                                          |
-| `store`             | `boolean`                                  | 応答を永続化し、取得 / RAG ワークフローで利用                   |
+| フィールド          | 型                                         | メモ                                                                          |
+| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------- |
+| `temperature`       | `number`                                   | 創造性と決定論のバランス                                                      |
+| `topP`              | `number`                                   | ニュークリアスサンプリング                                                    |
+| `frequencyPenalty`  | `number`                                   | 繰り返しトークンのペナルティ                                                  |
+| `presencePenalty`   | `number`                                   | 新しいトークンを促進                                                          |
+| `toolChoice`        | `'auto' \| 'required' \| 'none' \| string` | [ツールの使用を強制する](/openai-agents-js/ja/guides/agents#forcing-tool-use) |
+| `parallelToolCalls` | `boolean`                                  | 対応している場合に並列関数呼び出しを許可                                      |
+| `truncation`        | `'auto' \| 'disabled'`                     | トークン切り詰め戦略                                                          |
+| `maxTokens`         | `number`                                   | 応答内の最大トークン数                                                        |
+| `store`             | `boolean`                                  | 応答を永続化し、取得 / RAG ワークフローで利用                                 |
 
 設定はどちらのレベルにも添付できます:
 
@@ -109,6 +109,6 @@ OpenAI プロバイダー使用時に API キーを渡せば、自動トレー
 
 ## 次のステップ
 
-- [エージェントの実行](/ja/guides/running-agents) を確認
-- [ツール](/ja/guides/tools) でモデルにスーパーパワーを付与
-- 必要に応じて [ガードレール](/ja/guides/guardrails) や [トレーシング](/ja/guides/tracing) を追加
+- [エージェントの実行](/openai-agents-js/ja/guides/running-agents) を確認
+- [ツール](/openai-agents-js/ja/guides/tools) でモデルにスーパーパワーを付与
+- 必要に応じて [ガードレール](/openai-agents-js/ja/guides/guardrails) や [トレーシング](/openai-agents-js/ja/guides/tracing) を追加
diff --git a/docs/src/content/docs/ja/guides/quickstart.mdx b/docs/src/content/docs/ja/guides/quickstart.mdx
index 03d335f0..e554c4c3 100644
--- a/docs/src/content/docs/ja/guides/quickstart.mdx
+++ b/docs/src/content/docs/ja/guides/quickstart.mdx
@@ -159,6 +159,6 @@ Agents SDK はトレースを自動生成します。これにより、エージ
 
 より複雑なエージェントフローの構築方法を学びましょう:
 
-- [エージェント](/ja/guides/agents) の設定について学ぶ
-- [エージェントの実行](/ja/guides/running-agents) について学ぶ
-- [ツール](/ja/guides/tools)、[ガードレール](/ja/guides/guardrails)、[モデル](/ja/guides/models) について学ぶ
+- [エージェント](/openai-agents-js/ja/guides/agents) の設定について学ぶ
+- [エージェントの実行](/openai-agents-js/ja/guides/running-agents) について学ぶ
+- [ツール](/openai-agents-js/ja/guides/tools)、[ガードレール](/openai-agents-js/ja/guides/guardrails)、[モデル](/openai-agents-js/ja/guides/models) について学ぶ
diff --git a/docs/src/content/docs/ja/guides/results.mdx b/docs/src/content/docs/ja/guides/results.mdx
index 54c93632..ff774f5b 100644
--- a/docs/src/content/docs/ja/guides/results.mdx
+++ b/docs/src/content/docs/ja/guides/results.mdx
@@ -7,10 +7,10 @@ import { Code } from '@astrojs/starlight/components';
 import handoffFinalOutputTypes from '../../../../../../examples/docs/results/handoffFinalOutputTypes.ts?raw';
 import historyLoop from '../../../../../../examples/docs/results/historyLoop.ts?raw';
 
-[エージェントの実行](/ja/guides/running-agents) を行うと、結果として次のいずれかを受け取ります。
+[エージェントの実行](/openai-agents-js/ja/guides/running-agents) を行うと、結果として次のいずれかを受け取ります。
 
-- `stream: true` を付けずに `run` を呼び出した場合 — [`RunResult`](/openai/agents/classes/runresult)
-- `stream: true` を付けて `run` を呼び出した場合 — [`StreamedRunResult`](/openai/agents/classes/streamedrunresult)。ストリーミングの詳細は [ストリーミング](/ja/guides/streaming) も参照してください。
+- `stream: true` を付けずに `run` を呼び出した場合 — [`RunResult`](/openai-agents-js/openai/agents/classes/runresult)
+- `stream: true` を付けて `run` を呼び出した場合 — [`StreamedRunResult`](/openai-agents-js/openai/agents/classes/streamedrunresult)。ストリーミングの詳細は [ストリーミング](/openai-agents-js/ja/guides/streaming) も参照してください。
 
 ## 最終出力
 
@@ -52,23 +52,23 @@ import historyLoop from '../../../../../../examples/docs/results/historyLoop.ts?
 
 ## 新規アイテム
 
-`newItems` プロパティには実行中に生成された新しいアイテムが入ります。アイテムは [`RunItem`](/openai/agents/type-aliases/runitem) で、LLM が生成した元アイテムをラップしています。これにより、LLM の出力に加え、そのイベントがどのエージェントに紐づくかを取得できます。
+`newItems` プロパティには実行中に生成された新しいアイテムが入ります。アイテムは [`RunItem`](/openai-agents-js/openai/agents/type-aliases/runitem) で、LLM が生成した元アイテムをラップしています。これにより、LLM の出力に加え、そのイベントがどのエージェントに紐づくかを取得できます。
 
-- [`RunMessageOutputItem`](/openai/agents/classes/runmessageoutputitem) — LLM からのメッセージ。`raw` は生成されたメッセージ
-- [`RunHandoffCallItem`](/openai/agents/classes/runhandoffcallitem) — LLM がハンドオフ ツールを呼び出したことを示します。`raw` はツール呼び出しアイテム
-- [`RunHandoffOutputItem`](/openai/agents/classes/runhandoffoutputitem) — ハンドオフが発生したことを示します。`raw` はツールのレスポンス。ソース／ターゲット エージェントにもアクセス可能
-- [`RunToolCallItem`](/openai/agents/classes/runtoolcallitem) — LLM がツールを呼び出したことを示します
-- [`RunToolCallOutputItem`](/openai/agents/classes/runtoolcalloutputitem) — ツールが呼び出されたことを示します。`raw` はツールのレスポンス。ツール出力にもアクセス可能
-- [`RunReasoningItem`](/openai/agents/classes/runreasoningitem) — LLM からの推論アイテム。`raw` は生成された推論
-- [`RunToolApprovalItem`](/openai/agents/classes/runtoolapprovalitem) — LLM がツール呼び出しの承認を要求したことを示します。`raw` はツール呼び出しアイテム
+- [`RunMessageOutputItem`](/openai-agents-js/openai/agents/classes/runmessageoutputitem) — LLM からのメッセージ。`raw` は生成されたメッセージ
+- [`RunHandoffCallItem`](/openai-agents-js/openai/agents/classes/runhandoffcallitem) — LLM がハンドオフ ツールを呼び出したことを示します。`raw` はツール呼び出しアイテム
+- [`RunHandoffOutputItem`](/openai-agents-js/openai/agents/classes/runhandoffoutputitem) — ハンドオフが発生したことを示します。`raw` はツールのレスポンス。ソース／ターゲット エージェントにもアクセス可能
+- [`RunToolCallItem`](/openai-agents-js/openai/agents/classes/runtoolcallitem) — LLM がツールを呼び出したことを示します
+- [`RunToolCallOutputItem`](/openai-agents-js/openai/agents/classes/runtoolcalloutputitem) — ツールが呼び出されたことを示します。`raw` はツールのレスポンス。ツール出力にもアクセス可能
+- [`RunReasoningItem`](/openai-agents-js/openai/agents/classes/runreasoningitem) — LLM からの推論アイテム。`raw` は生成された推論
+- [`RunToolApprovalItem`](/openai-agents-js/openai/agents/classes/runtoolapprovalitem) — LLM がツール呼び出しの承認を要求したことを示します。`raw` はツール呼び出しアイテム
 
 ## 状態
 
-`state` プロパティには実行の状態が入ります。`result` に付随する多くの情報は `state` から導出されていますが、`state` はシリアライズ／デシリアライズ可能で、[エラーからの復旧](/ja/guides/running-agents#exceptions) や [`割り込み`](#interruptions) に対処するために、後続の `run` 呼び出しの入力として利用できます。
+`state` プロパティには実行の状態が入ります。`result` に付随する多くの情報は `state` から導出されていますが、`state` はシリアライズ／デシリアライズ可能で、[エラーからの復旧](/openai-agents-js/ja/guides/running-agents#exceptions) や [`割り込み`](#interruptions) に対処するために、後続の `run` 呼び出しの入力として利用できます。
 
 ## 割り込み
 
-エージェントで `needsApproval` を使用している場合、`run` 中に処理すべき `interruptions` が発生することがあります。その場合、`interruptions` は割り込みを引き起こした `ToolApprovalItem` の配列になります。割り込みの扱いについては [人間の介入（HITL）](/ja/guides/human-in-the-loop) を参照してください。
+エージェントで `needsApproval` を使用している場合、`run` 中に処理すべき `interruptions` が発生することがあります。その場合、`interruptions` は割り込みを引き起こした `ToolApprovalItem` の配列になります。割り込みの扱いについては [人間の介入（HITL）](/openai-agents-js/ja/guides/human-in-the-loop) を参照してください。
 
 ## その他の情報
 
diff --git a/docs/src/content/docs/ja/guides/running-agents.md b/docs/src/content/docs/ja/guides/running-agents.md
index cf99a1bf..ae54713c 100644
--- a/docs/src/content/docs/ja/guides/running-agents.md
+++ b/docs/src/content/docs/ja/guides/running-agents.md
@@ -48,7 +48,7 @@ config を指定しない場合は、OpenAI プロバイダーやトレーシン
 runner.run(agent, input, options?) → Promise<RunResult | StreamedRunResult>
 ```
 
-- `agent` – 開始 [`Agent`](/ja/guides/agents) インスタンス
+- `agent` – 開始 [`Agent`](/openai-agents-js/ja/guides/agents) インスタンス
 - `input` – プレーン文字列 **または** [`ResponseInputItem`](/openai/agents/type-aliases/modelrequest) オブジェクトの配列
 - `options` – 下表を参照
 
@@ -249,6 +249,6 @@ Math homework guardrail tripped
 
 ## 次のステップ
 
-- [モデルを設定](/ja/guides/models) する方法を学ぶ
-- エージェントに [tools](/ja/guides/tools) を提供する
-- 本番環境に向けて [guardrails](/ja/guides/guardrails) や [tracing](/ja/guides/tracing) を追加する
+- [モデルを設定](/openai-agents-js/ja/guides/models) する方法を学ぶ
+- エージェントに [tools](/openai-agents-js/ja/guides/tools) を提供する
+- 本番環境に向けて [guardrails](/openai-agents-js/ja/guides/guardrails) や [tracing](/openai-agents-js/ja/guides/tracing) を追加する
diff --git a/docs/src/content/docs/ja/guides/running-agents.mdx b/docs/src/content/docs/ja/guides/running-agents.mdx
index 013eb6ee..c59996ec 100644
--- a/docs/src/content/docs/ja/guides/running-agents.mdx
+++ b/docs/src/content/docs/ja/guides/running-agents.mdx
@@ -19,7 +19,7 @@ import chatLoopExample from '../../../../../../examples/docs/running-agents/chat
 
 <Code lang="typescript" code={helloWorldWithRunnerExample} title="Simple run" />
 
-エージェントを実行すると、最終出力と実行の完全な履歴を含む [エージェントの実行結果](/ja/guides/results) オブジェクトが返されます。
+エージェントを実行すると、最終出力と実行の完全な履歴を含む [エージェントの実行結果](/openai-agents-js/ja/guides/results) オブジェクトが返されます。
 
 ## エージェントループ
 
@@ -32,7 +32,7 @@ import chatLoopExample from '../../../../../../examples/docs/running-agents/chat
    - **最終出力** → 返却
    - **ハンドオフ** → 新しいエージェントに切り替え、これまでの会話履歴を保持して 1 へ
    - **ツール呼び出し** → ツールを実行し、その結果を会話に追加して 1 へ
-3. `maxTurns` に達すると [`MaxTurnsExceededError`](/openai/agents-core/classes/maxturnsexceedederror) をスロー
+3. `maxTurns` に達すると [`MaxTurnsExceededError`](/openai-agents-js/openai/agents-core/classes/maxturnsexceedederror) をスロー
 
 <Aside type="note">
   LLM
@@ -47,16 +47,16 @@ import chatLoopExample from '../../../../../../examples/docs/running-agents/chat
 
 `run()` メソッドには、開始エージェント、実行入力、およびオプションを渡します。
 
-入力は文字列、[入力アイテム](/openai/agents-core/type-aliases/agentinputitem) のリスト、または [Human in the loop](/ja/guides/human-in-the-loop) エージェントを構築する場合の [`RunState`](/openai/agents-core/classes/runstate) オブジェクトのいずれかです。
+入力は文字列、[入力アイテム](/openai-agents-js/openai/agents-core/type-aliases/agentinputitem) のリスト、または [Human in the loop](/openai-agents-js/ja/guides/human-in-the-loop) エージェントを構築する場合の [`RunState`](/openai-agents-js/openai/agents-core/classes/runstate) オブジェクトのいずれかです。
 
 追加オプションは次のとおりです。
 
-| Option     | Default | 説明                                                                                                                             |
-| ---------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `stream`   | `false` | `true` の場合、`StreamedRunResult` が返り、モデルから届くイベントを随時受け取ります                                              |
-| `context`  | –       | すべてのツール / ガードレール / ハンドオフに転送されるコンテキスト オブジェクト。詳しくは [コンテキスト管理](/ja/guides/context) |
-| `maxTurns` | `10`    | セーフティ制限 — 到達時に [`MaxTurnsExceededError`](/openai/agents-core/classes/maxturnsexceedederror) をスロー                  |
-| `signal`   | –       | キャンセル用の `AbortSignal`                                                                                                     |
+| Option     | Default | 説明                                                                                                                                              |
+| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `stream`   | `false` | `true` の場合、`StreamedRunResult` が返り、モデルから届くイベントを随時受け取ります                                                               |
+| `context`  | –       | すべてのツール / ガードレール / ハンドオフに転送されるコンテキスト オブジェクト。詳しくは [コンテキスト管理](/openai-agents-js/ja/guides/context) |
+| `maxTurns` | `10`    | セーフティ制限 — 到達時に [`MaxTurnsExceededError`](/openai-agents-js/openai/agents-core/classes/maxturnsexceedederror) をスロー                  |
+| `signal`   | –       | キャンセル用の `AbortSignal`                                                                                                                      |
 
 ## ストリーミング
 
@@ -97,12 +97,12 @@ import chatLoopExample from '../../../../../../examples/docs/running-agents/chat
 
 SDK は次の少数のエラーをスローします。必要に応じてキャッチしてください。
 
-- [`MaxTurnsExceededError`](/openai/agents-core/classes/maxturnsexceedederror) — `maxTurns` に到達
-- [`ModelBehaviorError`](/openai/agents-core/classes/modelbehaviorerror) — モデルが無効な出力を生成（例: JSON 形式不正、未知のツール）
-- [`InputGuardrailTripwireTriggered`](/openai/agents-core/classes/inputguardrailtripwiretriggered) / [`OutputGuardrailTripwireTriggered`](/openai/agents-core/classes/outputguardrailtripwiretriggered) — ガードレール違反
-- [`GuardrailExecutionError`](/openai/agents-core/classes/guardrailexecutionerror) — ガードレールの実行に失敗
-- [`ToolCallError`](/openai/agents-core/classes/toolcallerror) — 関数ツール呼び出しが失敗
-- [`UserError`](/openai/agents-core/classes/usererror) — 設定やユーザー入力に基づくエラー
+- [`MaxTurnsExceededError`](/openai-agents-js/openai/agents-core/classes/maxturnsexceedederror) — `maxTurns` に到達
+- [`ModelBehaviorError`](/openai-agents-js/openai/agents-core/classes/modelbehaviorerror) — モデルが無効な出力を生成（例: JSON 形式不正、未知のツール）
+- [`InputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents-core/classes/inputguardrailtripwiretriggered) / [`OutputGuardrailTripwireTriggered`](/openai-agents-js/openai/agents-core/classes/outputguardrailtripwiretriggered) — ガードレール違反
+- [`GuardrailExecutionError`](/openai-agents-js/openai/agents-core/classes/guardrailexecutionerror) — ガードレールの実行に失敗
+- [`ToolCallError`](/openai-agents-js/openai/agents-core/classes/toolcallerror) — 関数ツール呼び出しが失敗
+- [`UserError`](/openai-agents-js/openai/agents-core/classes/usererror) — 設定やユーザー入力に基づくエラー
 
 これらはすべて基底クラス `AgentsError` を継承しており、現在の実行状態にアクセスできる `state` プロパティを提供する場合があります。
 
@@ -125,6 +125,6 @@ Math homework guardrail tripped
 
 ## 次のステップ
 
-- [モデル](/ja/guides/models) の設定方法を学ぶ
-- エージェントに [ツール](/ja/guides/tools) を提供する
-- 本番環境に向けて [ガードレール](/ja/guides/guardrails) や [トレーシング](/ja/guides/tracing) を追加する
+- [モデル](/openai-agents-js/ja/guides/models) の設定方法を学ぶ
+- エージェントに [ツール](/openai-agents-js/ja/guides/tools) を提供する
+- 本番環境に向けて [ガードレール](/openai-agents-js/ja/guides/guardrails) や [トレーシング](/openai-agents-js/ja/guides/tracing) を追加する
diff --git a/docs/src/content/docs/ja/guides/tools.mdx b/docs/src/content/docs/ja/guides/tools.mdx
index b88833ff..041e4cc6 100644
--- a/docs/src/content/docs/ja/guides/tools.mdx
+++ b/docs/src/content/docs/ja/guides/tools.mdx
@@ -84,7 +84,7 @@ import agentsAsToolsExample from '../../../../../../examples/docs/tools/agentsAs
 
 ## ツール使用時の挙動
 
-モデルにツールを必ず使用させるタイミング・方法の制御（`tool_choice`, `toolUseBehavior` など）については [エージェント](/ja/guides/agents#forcing-tool-use) を参照してください。
+モデルにツールを必ず使用させるタイミング・方法の制御（`tool_choice`, `toolUseBehavior` など）については [エージェント](/openai-agents-js/ja/guides/agents#forcing-tool-use) を参照してください。
 
 ---
 
@@ -99,6 +99,6 @@ import agentsAsToolsExample from '../../../../../../examples/docs/tools/agentsAs
 
 ## 次のステップ
 
-- [ツール使用の強制](/ja/guides/agents#forcing-tool-use) について学ぶ
-- [ガードレール](/ja/guides/guardrails) を追加してツールの入力・出力を検証
-- [`tool()`](/openai/agents/functions/tool) と各種組み込みツール型の TypeDoc リファレンスを確認
+- [ツール使用の強制](/openai-agents-js/ja/guides/agents#forcing-tool-use) について学ぶ
+- [ガードレール](/openai-agents-js/ja/guides/guardrails) を追加してツールの入力・出力を検証
+- [`tool()`](/openai-agents-js/openai/agents/functions/tool) と各種組み込みツール型の TypeDoc リファレンスを確認
diff --git a/docs/src/content/docs/ja/guides/tracing.mdx b/docs/src/content/docs/ja/guides/tracing.mdx
index 2943d9f7..6315da86 100644
--- a/docs/src/content/docs/ja/guides/tracing.mdx
+++ b/docs/src/content/docs/ja/guides/tracing.mdx
@@ -13,7 +13,7 @@ Agents SDK には組み込みのトレーシング機能があり、エージェ
 トレーシングはデフォルトで有効になっています。無効化する方法は 2 つあります。
 
 1. 環境変数 `OPENAI_AGENTS_DISABLE_TRACING=1` を設定してグローバルに無効化する
-2. 1 回の実行だけ無効化したい場合は、[`RunConfig.tracingDisabled`](/openai/agents-core/type-aliases/runconfig/#tracingdisabled) を `true` に設定する
+2. 1 回の実行だけ無効化したい場合は、[`RunConfig.tracingDisabled`](/openai-agents-js/openai/agents-core/type-aliases/runconfig/#tracingdisabled) を `true` に設定する
 
 **_OpenAI の API を Zero Data Retention (ZDR) ポリシーで利用している組織では、トレーシングは利用できません。_**
 
@@ -85,12 +85,12 @@ Agents SDK には組み込みのトレーシング機能があり、エージェ
 トレーシングの高レベルアーキテクチャは次のとおりです。
 
 - 初期化時にグローバルな [`TraceProvider`](/openai/agents-core/classes/traceprovider) を生成し、[`getGlobalTraceProvider()`](/openai/agents-core/functions/getglobaltraceprovider/) からアクセスします
-- `TraceProvider` には [`BatchTraceProcessor`](/openai/agents-core/classes/batchtraceprocessor/) を設定し、これがトレース／スパンをバッチで [`OpenAITracingExporter`](/openai/agents-openai/classes/openaitracingexporter/) に送信します
+- `TraceProvider` には [`BatchTraceProcessor`](/openai-agents-js/openai/agents-core/classes/batchtraceprocessor/) を設定し、これがトレース／スパンをバッチで [`OpenAITracingExporter`](/openai-agents-js/openai/agents-openai/classes/openaitracingexporter/) に送信します
 - `OpenAITracingExporter` はバッチで OpenAI バックエンドへエクスポートします
 
 このデフォルト設定をカスタマイズし、別のバックエンドへ送信したりエクスポーターの動作を変更したりするには 2 つの方法があります。
 
-1. [`addTraceProcessor()`](/openai/agents-core/functions/addtraceprocessor)  
+1. [`addTraceProcessor()`](/openai-agents-js/openai/agents-core/functions/addtraceprocessor)  
    デフォルトの処理に **追加** して、準備が整ったトレースやスパンを受け取る独自のトレースプロセッサを追加します。これにより、OpenAI バックエンドに送信しつつ独自処理を行えます。
-2. [`setTraceProcessors()`](/openai/agents-core/functions/settraceprocessors)  
+2. [`setTraceProcessors()`](/openai-agents-js/openai/agents-core/functions/settraceprocessors)  
    デフォルトのプロセッサを **置換** し、独自のトレースプロセッサのみを使用します。OpenAI バックエンドへは `TracingProcessor` を含めない限り送信されません。
diff --git a/docs/src/content/docs/ja/guides/voice-agents.mdx b/docs/src/content/docs/ja/guides/voice-agents.mdx
index 57b806f7..08760c4d 100644
--- a/docs/src/content/docs/ja/guides/voice-agents.mdx
+++ b/docs/src/content/docs/ja/guides/voice-agents.mdx
@@ -31,7 +31,7 @@ Voice Agents SDK は [OpenAI Realtime API](https://platform.openai.com/docs/guid
 
 <LinkCard
   title="クイックスタート"
-  href="/ja/guides/voice-agents/quickstart"
+  href="/openai-agents-js/ja/guides/voice-agents/quickstart"
   description="OpenAI Agents SDK を使って数分で最初のリアルタイム音声アシスタントを構築します。"
 />
 
diff --git a/docs/src/content/docs/ja/guides/voice-agents/build.mdx b/docs/src/content/docs/ja/guides/voice-agents/build.mdx
index b51db6a3..1892ba71 100644
--- a/docs/src/content/docs/ja/guides/voice-agents/build.mdx
+++ b/docs/src/content/docs/ja/guides/voice-agents/build.mdx
@@ -37,13 +37,13 @@ import turnDetectionExample from '../../../../../../../examples/docs/voice-agent
 
 ## セッション設定
 
-[`RealtimeSession`](/openai/agents-realtime/classes/realtimesession/) を生成するとき、または `connect(...)` を呼び出すときに追加オプションを渡すことでセッションを設定できます。
+[`RealtimeSession`](/openai-agents-js/openai/agents-realtime/classes/realtimesession/) を生成するとき、または `connect(...)` を呼び出すときに追加オプションを渡すことでセッションを設定できます。
 
 <Code lang="typescript" code={configureSessionExample} />
 
 これらのトランスポートレイヤーでは、[session](https://platform.openai.com/docs/api-reference/realtime-client-events/session/update) と一致する任意のパラメーターを渡せます。
 
-[RealtimeSessionConfig](/openai/agents-realtime/type-aliases/realtimesessionconfig/) に対応するパラメーターがまだ存在しない場合は `providerData` を使用してください。`providerData` に渡した内容は `session` オブジェクトの一部としてそのまま送信されます。
+[RealtimeSessionConfig](/openai-agents-js/openai/agents-realtime/type-aliases/realtimesessionconfig/) に対応するパラメーターがまだ存在しない場合は `providerData` を使用してください。`providerData` に渡した内容は `session` オブジェクトの一部としてそのまま送信されます。
 
 ## ハンドオフ
 
diff --git a/docs/src/content/docs/ja/guides/voice-agents/quickstart.mdx b/docs/src/content/docs/ja/guides/voice-agents/quickstart.mdx
index e4715c35..f24a414e 100644
--- a/docs/src/content/docs/ja/guides/voice-agents/quickstart.mdx
+++ b/docs/src/content/docs/ja/guides/voice-agents/quickstart.mdx
@@ -34,8 +34,6 @@ import thinClientExample from '../../../../../../../examples/docs/voice-agents/t
    npm create vite@latest my-project --template vanilla-ts
    ```
 
-   あるいは、[Stackblitz](https://stackblitz.com/github/openai/openai-agents-js/tree/examples/realtime-demo) を使ってブラウザ上で直接新しいプロジェクトを作成することもできます。
-
 1. **Agents SDK をインストールする**
 
    ```bash
@@ -61,7 +59,7 @@ import thinClientExample from '../../../../../../../examples/docs/voice-agents/t
 
 3. **最初のエージェントを作成する**
 
-   新しい [`RealtimeAgent`](/openai/agents-realtime/classes/realtimeagent/) の作成方法は、通常の [`Agent`](/docs/agents) とほとんど同じです。
+   新しい [`RealtimeAgent`](/openai-agents-js/openai/agents-realtime/classes/realtimeagent/) の作成方法は、通常の [`Agent`](/openai-agents-js/guides/agents) とほとんど同じです。
 
    ```typescript
    import { RealtimeAgent } from '@openai/agents-realtime';
@@ -94,7 +92,7 @@ import thinClientExample from '../../../../../../../examples/docs/voice-agents/t
    await session.connect({ apiKey: '<client-api-key>' });
    ```
 
-   これによりブラウザで WebRTC を使用して Realtime API に接続し、マイクとスピーカーが自動的に設定されます。`RealtimeSession` をバックエンドサーバー（Node.js など）で実行している場合、SDK は自動的に WebSocket を利用します。さまざまなトランスポートレイヤーについては [リアルタイムトランスポート](/ja/guides/voice-agents/transport) ガイドを参照してください。
+   これによりブラウザで WebRTC を使用して Realtime API に接続し、マイクとスピーカーが自動的に設定されます。`RealtimeSession` をバックエンドサーバー（Node.js など）で実行している場合、SDK は自動的に WebSocket を利用します。さまざまなトランスポートレイヤーについては [リアルタイムトランスポート](/openai-agents-js/ja/guides/voice-agents/transport) ガイドを参照してください。
 
 6. **すべてをまとめる**
 
@@ -116,13 +114,13 @@ import thinClientExample from '../../../../../../../examples/docs/voice-agents/t
 
 - 音声エージェントに次の機能を追加する方法
 
-  - [ツール](/ja/guides/voice-agents/build#tools)
-  - [ハンドオフ](/ja/guides/voice-agents/build#handoffs)
-  - [ガードレール](/ja/guides/voice-agents/build#guardrails)
-  - [音声割り込みへの対応](/ja/guides/voice-agents/build#audio-interruptions)
-  - [セッション履歴の管理](/ja/guides/voice-agents/build#session-history)
+  - [ツール](/openai-agents-js/ja/guides/voice-agents/build#tools)
+  - [ハンドオフ](/openai-agents-js/ja/guides/voice-agents/build#handoffs)
+  - [ガードレール](/openai-agents-js/ja/guides/voice-agents/build#guardrails)
+  - [音声割り込みへの対応](/openai-agents-js/ja/guides/voice-agents/build#audio-interruptions)
+  - [セッション履歴の管理](/openai-agents-js/ja/guides/voice-agents/build#session-history)
 
 - さまざまなトランスポートレイヤーについて詳しく学ぶ
-  - [WebRTC](/ja/guides/voice-agents/transport#connecting-over-webrtc)
-  - [WebSocket](/ja/guides/voice-agents/transport#connecting-over-websocket)
-  - [独自のトランスポート機構を構築する](/ja/guides/voice-agents/transport#building-your-own-transport-mechanism)
+  - [WebRTC](/openai-agents-js/ja/guides/voice-agents/transport#connecting-over-webrtc)
+  - [WebSocket](/openai-agents-js/ja/guides/voice-agents/transport#connecting-over-websocket)
+  - [独自のトランスポート機構を構築する](/openai-agents-js/ja/guides/voice-agents/transport#building-your-own-transport-mechanism)