deep links

Author: alwell-kevin

examples/deep_research_api/how_to_build_a_deep_research_mcp_server/README.md

@@ -2,7 +2,7 @@
 
 This is a minimal example of a Deep Research style MCP server for searching and fetching files from the OpenAI file storage service.
 
-For a reference of _how_ to call this service from the Responses API, with Deep Research see [this cookbook](<./how_to_use_deep_research> ). To see how to call the MCP server with the Agents SDK, checkout [this cookbook](<./agents_deep_research_cookbook>)!
+For a reference of _how_ to call this service from the Responses API, with Deep Research see [this cookbook](https://cookbook.openai.com/examples/deep_research_api/how_to_use_deep_research_API). To see how to call the MCP server with the Agents SDK, checkout [this cookbook](https://cookbook.openai.com/examples/deep_research_api/how_to_use_deep_research_API_agents)!
 
 The Deep Research agent relies specifically on Search and Fetch tools. Search should look through your object store for a set of specfic, top-k IDs. Fetch, is a tool that takes objectIds as arguments and pulls back the relevant resources.
 

examples/deep_research_api/how_to_use_deep_research_API.ipynb

@@ -674,7 +674,9 @@
         "- Technical literature reviews and policy synthesis\n",
         "\n",
         "\n",
-        "Whether you're looking to build research agents, generate structured reports, or integrate high-quality synthesis into your workflows, we hope the examples here help you get started."
+        "Whether you're looking to build research agents, generate structured reports, or integrate high-quality synthesis into your workflows, we hope the examples here help you get started.\n",
+        "\n",
+        "What's next? [Deep Research Agents](https://cookbook.openai.com/examples/deep_research_api/how_to_use_deep_research_API_agents)"
       ]
     }
   ],

examples/deep_research_api/how_to_use_deep_research_API_agents_.ipynb

@@ -8,9 +8,9 @@
       "source": [
         "# Deep Research Agents Cookbook\n",
         "\n",
-        "This cookbook demonstrates how to build Agentic research workflows using the OpenAI Deep Research API and [Agents SDK](https://openai.github.io/openai-agents-python/). It is a continuation of \"./how_to_use_deep_research.ipynb\", if you have not already familiarized yourself with that content, please consider doing so.\n",
+        "This cookbook demonstrates how to build Agentic research workflows using the OpenAI Deep Research API and [Agents SDK](https://openai.github.io/openai-agents-python/). It is a continuation of [a fundamentals cookbook](https://cookbook.openai.com/examples/deep_research_api/how_to_use_deep_research_API), if you have not already familiarized yourself with that content, please consider doing so.\n",
         "\n",
-        "You’ll learn how to orchestrate single and multi-agent pipelines, enrich user queries to maximize output quality, stream research progress, integrate web search and MCP for internal file search, and architect a robust research application.\n",
+        "You’ll learn how to orchestrate single and multi-agent pipelines, enrich user queries to maximize output quality, stream research progress, integrate web search and [MCP for internal file search](https://cookbook.openai.com/examples/deep_research_api/how_to_build_a_deep_research_mcp_server/README), and architect a robust research application.\n",
         "\n",
         "Consider using Deep Research Agents for tasks that require planning, synthesis, tool use, or multi-step reasoning. Do not use Deep Research for trivial fact lookups, simple Q&A, or short-form chat, a vanilla openai.responsesAPI would be faster and cheaper."
       ]
@@ -260,7 +260,7 @@
         "   - Streams intermediate events for transparency\n",
         "   - Outputs final Research Artifact (which we later parse)\n",
         "\n",
-        "For more insight into _how_ the MCP server is build. See this resource."
+        "For more insight into _how_ the MCP server is build. [See this resource.](https://cookbook.openai.com/examples/deep_research_api/how_to_build_a_deep_research_mcp_server/README )"
       ]
     },
     {