add more links and explaination

Author: BhAem

veadk_tutorial.ipynb

@@ -82,6 +82,13 @@
     "### 环境变量"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "这里以[方舟大模型平台](https://console.volcengine.com/ark/region:ark+cn-beijing/overview)为例，使用到的模型需要提前在方舟控制台进行[开通操作](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement)。"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -92,7 +99,7 @@
    "source": [
     "import os\n",
     "\n",
-    "os.environ[\"MODEL_AGENT_NAME\"] = \"doubao-seed-1-6-250615\"  # <-- 火山方舟大模型名称\n",
+    "os.environ[\"MODEL_AGENT_NAME\"] = \"doubao-seed-1-6-251015\"  # <-- 火山方舟大模型名称\n",
     "\n",
     "os.environ[\"MODEL_AGENT_API_KEY\"] = \"\"  # <-- 设置火山方舟的API KEY来访问模型\n",
     "\n",
@@ -238,7 +245,7 @@
     "id": "JDtvFNcAy9FK"
    },
    "source": [
-    "使用[`web_search`工具](https://www.volcengine.com/docs/85508/1650263)，使用前需提前填写火山引擎的 AK 和 SK："
+    "使用[`web_search`工具](https://www.volcengine.com/docs/85508/1650263)，使用前需提前开通[相应权限](https://www.volcengine.com/docs/85508/1544858) (简单起见，可以直接给用到的测试账号赋予[AdministratorAccess超管权限](https://console.volcengine.com/iam/policymanage/System/AdministratorAccess?tab=auth))，提前[创建并填写火山引擎的 AK 和 SK](https://www.volcengine.com/docs/6291/65568)："
    ]
   },
   {
@@ -313,7 +320,7 @@
     "id": "IoTXmqz8zAvp"
    },
    "source": [
-    "尝试使用[`VeSearch`工具](https://www.volcengine.com/docs/85508/1512748)，使用前需进行[工具创建](https://console.volcengine.com/ask-echo/my-agent)，并填写如下 `VeSearch` 工具的 ENDPOINT 和 API KEY："
+    "尝试使用[`VeSearch`工具](https://www.volcengine.com/docs/85508/1512748)，使用前需进行[工具创建](https://console.volcengine.com/ask-echo/my-agent)，并填写如下 `VeSearch`工具的 ENDPOINT (ID) 和 API KEY："
    ]
   },
   {
@@ -691,7 +698,7 @@
     "id": "aEFDAJdtiiz1"
    },
    "source": [
-    "使用 [Viking Memory](https://www.volcengine.com/docs/84313/1860687) 作为长期记忆的后端，使用前[创建 Viking Memory](https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/home?) 并填写如下信息："
+    "使用 [记忆库/Viking Memory](https://www.volcengine.com/docs/84313/1860687) 作为长期记忆的后端，使用前[创建 记忆库/Viking Memory](https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/home?) 并填写如下信息："
    ]
   },
   {
@@ -937,7 +944,7 @@
     "id": "V87HcIZXlijp"
    },
    "source": [
-    "使用 [Viking DB](https://www.volcengine.com/docs/84313/1254463) 作为知识库的后端，使用前[创建 Viking DB](https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/home?) 和 [TOS](https://www.volcengine.com/docs/6349) 并填写如下信息："
+    "使用 [知识库/Viking DB](https://www.volcengine.com/docs/84313/1254463) 作为后端，使用前[创建 知识库/Viking DB](https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/home?) 和 [TOS](https://www.volcengine.com/docs/6349/74830) 并填写如下信息："
    ]
   },
   {
@@ -1338,7 +1345,7 @@
     "id": "9j9aqke52nCz"
    },
    "source": [
-    "需要设置上报器（exporter），VeADK 当前支持将 Tracing 数据上报至[火山引擎 TLS](https://www.volcengine.com/product/tls)、[火山引擎 APMPlus](https://www.volcengine.com/product/apmplus) 以及[火山引擎 Coze Loop](https://www.coze.cn/loop) 平台。它们分别对应不同的上报器。"
+    "需要设置上报器（exporter），VeADK 当前支持将 Tracing 数据上报至[火山引擎 Coze Loop](https://www.coze.cn/loop)、[火山引擎 TLS](https://www.volcengine.com/product/tls) 以及 [火山引擎 APMPlus](https://www.volcengine.com/product/apmplus) 平台。它们分别对应不同的上报器。"
    ]
   },
   {
@@ -1347,7 +1354,7 @@
     "id": "azFOHaFe3C5x"
    },
    "source": [
-    "初始化上报器之前需要进行环境变量设置："
+    "初始化上报器之前需要进行环境变量设置，相应的获取方式可参考 [Coze Loop](https://loop.coze.cn/open/docs/cozeloop/veadk_trace_report)、[TLS](https://www.volcengine.com/docs/6470/72004)、[APMPlus](https://www.volcengine.com/docs/6431/1469364)："
    ]
   },
   {
@@ -1359,27 +1366,26 @@
    "outputs": [],
    "source": [
     "import os\n",
+    "# Coze Loop 上报器环境变量\n",
+    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_COZELOOP_ENDPOINT\"] = (\n",
+    "    \"https://api.coze.cn/v1/loop/opentelemetry/v1/traces\"\n",
+    ")\n",
+    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_COZELOOP_SERVICE_NAME\"] = \"\" # 工作空间/workspace id\n",
+    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_COZELOOP_API_KEY\"] = \"\" # 令牌/token\n",
     "\n",
     "# TLS 上报器环境变量\n",
     "os.environ[\"OBSERVABILITY_OPENTELEMETRY_TLS_ENDPOINT\"] = (\n",
     "    \"https://tls-cn-beijing.volces.com:4318/v1/traces\"\n",
     ")\n",
     "os.environ[\"OBSERVABILITY_OPENTELEMETRY_TLS_REGION\"] = \"cn-beijing\"\n",
-    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_TLS_SERVICE_NAME\"] = \"\"\n",
+    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_TLS_SERVICE_NAME\"] = \"\" # TLS 主题/topic id\n",
     "\n",
     "# APMPlus 上报器环境变量\n",
     "os.environ[\"OBSERVABILITY_OPENTELEMETRY_APMPLUS_ENDPOINT\"] = (\n",
     "    \"http://apmplus-cn-beijing.volces.com:4317\"\n",
     ")\n",
     "os.environ[\"OBSERVABILITY_OPENTELEMETRY_APMPLUS_SERVICE_NAME\"] = \"\"\n",
-    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_APMPLUS_API_KEY\"] = \"\"\n",
-    "\n",
-    "# Coze Loop 上报器环境变量\n",
-    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_COZELOOP_ENDPOINT\"] = (\n",
-    "    \"https://api.coze.cn/v1/loop/opentelemetry/v1/traces\"\n",
-    ")\n",
-    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_COZELOOP_SERVICE_NAME\"] = \"\"\n",
-    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_COZELOOP_API_KEY\"] = \"\""
+    "os.environ[\"OBSERVABILITY_OPENTELEMETRY_APMPLUS_API_KEY\"] = \"\" # app key"
    ]
   },
   {