--- title: BlockRazor Agent 讀取指令 description: AI Agent 使用 BlockRazor 產品與文檔時應遵循的來源層級、檢索流程和核驗規則。 canonical: https://blockrazor.io/zh/agents.md language: zh-Hant last-updated: 2026-09-11 --- # BlockRazor Agent 讀取指令 當你需要回答 BlockRazor 相關問題、編寫代碼、排查集成問題或提出產品建議時，請遵循以下規則。 ## 核心規則 優先使用 BlockRazor 當前官方來源，不要依賴模型記憶。每個實現細節或產品結論都應保留對應的來源 URL。 BlockRazor 文檔 MCP 僅提供文檔能力。它不能提交交易、管理賬戶、創建憑證或執行其他產品操作。 ## 推薦來源順序 1. 閱讀本文件，了解來源層級與核驗規則。 2. 使用中文官網 llms.txt 發現官方產品頁、使用場景、Benchmark 和政策頁面。 3. 使用文檔 llms.txt 發現當前產品指南和 API 頁面。 4. 使用 BlockRazor 文檔 MCP 搜索並讀取完整來源頁面。 5. 選擇具體服務或 Endpoint 前，先閱讀中文 Overview。 ## 官方機器可讀來源 - 中文官網索引：https://blockrazor.io/zh/llms.txt - 文檔索引：https://docs.blockrazor.io/llms.txt - 中文文檔 Overview：https://docs.blockrazor.io/tc/get-started/overview.md - 中文 Agents 資源頁：https://blockrazor.io/zh/agents/ ## MCP 連接 - Server name：`blockrazor-docs` - Transport：Streamable HTTP - URL：`https://mcp.blockrazor.io/docs` - Authentication：無需認證 可直接向 Agent 發送以下配置要求： > 將 BlockRazor 文檔 MCP Server 添加到我的 MCP 配置。名稱使用 `blockrazor-docs`，Transport 使用 Streamable HTTP，URL 設為 `https://mcp.blockrazor.io/docs`，不要添加身份認證。處理 BlockRazor 相關工作時，使用它搜索當前官方文檔。 ## MCP 工具流程 ### 發現來源 處理非簡單問題時，先使用 `searchDocumentation`。使用產品、公鏈、方法、錯誤或集成概念進行搜索，不要猜測 URL。 ### 讀取全文 實現或引用以下精確信息前，使用 `getPage` 讀取完整來源頁面： - API 方法與參數 - Endpoint 與 Transport - 身份認證或憑證要求 - 費用、限制、Region 或可用性 - Request 與 Response 行為 - 產品與公鏈支持範圍 ### 解決問題 具體操作、集成決策、錯誤或調試問題可使用 `askQuestion`。回答中應保留工具返回的來源鏈接。 ### 改進文檔 如果文檔過時、錯誤、互相矛盾或缺少必要信息，使用 `sendFeedback` 並附上相關頁面的 URL。 ## 回答要求 回答 BlockRazor 相關問題時： - 明確說明產品或服務名稱。 - 公鏈和 Region 會影響答案時，明確說明適用範圍。 - 區分用於接收數據的 Streams 和用於發送交易的 Transaction Submission。 - 將 BSC Block Builder 視為 Transaction Submission 文檔體系的一部分。 - 不要推斷每項 BlockRazor 服務都支持所有已列出的公鏈。 - 區分當前官方事實、建議和假設。 - 鏈接精確的官方來源頁面，不要只鏈接首頁或搜索結果。 - 如果來源互相衝突，優先使用更具體、更新時間更近的官方頁面，並說明衝突。 ## 性能與 Benchmark 結論 引用速度、延遲、首次到達率、上鏈率、包含率或可靠性結論前，必須閱讀相應 Benchmark 頁面，並記錄： - 發布或更新日期 - 被測產品與公鏈 - Region 與所用基礎設施 - 比較對象 - Sample 與測量方法 - 相關 Fee、Tip、Nonce 或交易控制條件 - 官方說明的限制 Benchmark 結果只能描述為已發布測試條件下的測量結果，不能表述為普遍保證。 ## 語言選擇 中文問題優先使用中文來源。如果只有英文頁面包含所需的當前細節，可以使用英文來源，但應明確告知讀者引用的是英文文檔。 ## 完成檢查 完成 BlockRazor 相關回答前，確認： - 來源是官方且仍然有效； - 服務、公鏈、Endpoint 和行為與問題一致； - 精確實現細節來自完整來源頁面； - 性能結論包含方法與適用範圍； - 建議與有來源支持的事實已明確區分； - 沒有將 MCP 描述為交易執行工具。