什么是 JSON 和 Markdown？為何它們如此重要？
在現代軟件開發和應用中，JSON 和 Markdown 是兩個非常重要的工具。它們不僅在數據傳輸和文本處理方面發揮著關鍵作用，而且在諸如 Coze 平臺等應用中也有廣泛的應用。
本文將詳細介紹 JSON 和 Markdown 的概念、用法，并結合 Coze 平臺的功能進行舉例說明，希望能夠幫助技術小白全面理解這兩個工具的重要性和應用場景。
JSON：JavaScript 對象表示法
JSON（JavaScript Object Notation）是一種輕量級的數據交換格式，易于人閱讀和編寫，同時也便于機器解析和生成。盡管它源于 JavaScript 語言，但如今已被廣泛用于各種編程語言中。JSON 使用了一種完全獨立于編程語言的文本格式，但它使用了類似于 JavaScript 語言的約定。
JSON 的數據格式由兩種結構組成。
- 對象：用花括號
{}包裹，包含鍵值對。例如：
{
"name": "John",
"age": 30,
"city": "New York"
}在這個例子中，name、age 和 city 是鍵，每個鍵對應一個值。
- 數組：用方括號
[]包裹，包含一組值。例如：
["Apple", "Banana", "Cherry"]在這個例子中，數組包含三個字符串值：Apple、Banana 和 Cherry。
JSON 支持以下幾種數據類型：
- 字符串：用雙引號括起來的文本。例如
"Hello, world!"。 - 數字：整數或浮點數。例如
42或3.14。 - 對象：鍵值對的集合，用花括號括起來。例如
{"key": "value"}。 - 數組：值的有序集合，用方括號括起來。例如
["value1", "value2"]。 - 布爾值：
true或false。 - 空值：
null。
JSON 被廣泛用于 web 開發和數據傳輸。它的主要優點包括：
- 輕量級：相比 XML，JSON 更加簡潔，數據量更小。
- 易于解析：大多數編程語言都提供了用于處理 JSON 的庫和方法，使其解析和生成都非常方便。
- 可讀性強：JSON 的結構簡單明了，容易閱讀和理解。
假設我們有一個簡單的用戶信息表單，用戶輸入姓名、年齡和城市后提交。這些數據可以被轉換為 JSON 格式，發送到服務器進行處理。例如：
{
"name": "Alice",
"age": 25,
"city": "Los Angeles"
}服務器接收到這個 JSON 對象后，可以解析并處理這些數據，完成用戶信息的存儲或更新。
JSON 在 Coze 平臺中的應用
在 Coze 平臺中，JSON 被廣泛用于插件參數設置和數據傳輸。比如，當我們在 Coze 平臺上創建一個 Bot，并為其添加插件時，需要配置插件的輸入輸出參數。這些參數通常以 JSON 格式表示，確保數據的結構和內容能夠被正確解析和處理。
例子 1：設置插件參數
在 Coze 平臺上，假設我們添加了一個墨跡天氣的查詢插件，大模型會根據我們的提問配置對應的查詢參數。具體的交互就是使用 JSON 格式來設置這些參數，以下是這個插件的詳細輸入參數信息：
圖片
圖片
假設當用戶提問請問今天的北京天氣如何？，大模型就會根據用戶的提問，理解后決定使用這個天氣插件，然后提取出兩個關鍵詞：北京、今天。然后轉換成輸入參數能識別的 JSON 結果，如下：
{
"city": "Beijing",
"start_time": "20240505"
}這個 JSON 對象包含兩個鍵值對：city 指定查詢的城市地點，start_time 指定查詢開始時間。
你可以留意到，上圖中的輸入參數的必填項都是非必填的，這樣的設計是為了讓用戶更加自由地選擇是否填寫這些參數，用戶只需按需填寫即可。當然如果輸入參數是一個必填項，那么用戶就必須填寫這個參數，不過這也是大模型幫你去填寫，不用我們操心，我們只要知道這個原理就好了。
例子 2：Bing 搜索
假設我們要創建一個工作流，用于調用 Bing 搜索插件來獲取指定搜索結果。我們先看看，對應這個插件需要什么輸入參數：
圖片
這里需要三個輸入參數，其實類比到大模型將我們的自然語言轉換成對應的 JSON 數據請求，如下：
{
"count": 5,
"query": "今天有什么最新的 AI 新聞？"
}這里的query則是假設用戶開始提問的自然語言，然后大模型將其轉換成對應的 JSON 數據請求，然后發送給 Bing 搜索插件，然后插件返回對應的搜索結果。以下是具體演示結果：
圖片
但我看到的輸入或輸出數據結果不是 JSON 格式啊？沒事，這只是平臺優化了輸出的樣式給我們用戶看而已，你可以點擊下圖中輸入或者輸出隔壁的復制圖標，然后粘貼到你的編輯器中，你會看到對應的 JSON 數據格式，如下：
圖片
輸入：
{
"count": "5",
"query": "今天有什么最新的 AI 新聞？"
}輸出（因篇幅有限，省略了其中一些數據結果）：
{
"code": 0,
"data": {
"webPages": {
"value": [
{
"datePublished": "",
"displayUrl": "https://ai-bot.cn/daily-ai-news",
"snippet": "AI工具集每日更新AI行業的最新資訊、新聞、熱點、融資、產品動態，讓你隨時了解人工智能領域的最新趨勢、更新突破和熱門大事件。 AI應用集 AI寫作工具",
"url": "https://ai-bot.cn/daily-ai-news/",
"cachedPageUrl": "http://cncc.bingj.com/cache.aspx?q=%E4%BB%8A%E5%A4%A9%E6%9C%89%E4%BB%80%E4%B9%88%E6%9C%80%E6%96%B0%E7%9A%84+AI+%E6%96%B0%E9%97%BB%EF%BC%9F&d=4611304940784490&mkt=zh-CN&setlang=zh-CN&w=dyVq2wP2UdUw-tiNoGDwjxVidIq-DNyI",
"datePublishedDisplayText": "",
"id": "https://api.bing.microsoft.com/api/v7/#WebPages.0",
"language": "zh_chs",
"primaryImageOfPage": {
"height": 0,
"imageId": "",
"thumbnailUrl": "",
"width": 0
},
"thumbnailUrl": "",
"dateLastCrawled": "2024-06-09T17:22:00Z",
"name": "每日AI快訊、熱點、動態、融資、產品發布 | AI工具集",
"isFamilyFriendly": true,
"isNavigational": true
}
],
"webSearchUrl": "https://www.bing.com/search?q=%E4%BB%8A%E5%A4%A9%E6%9C%89%E4%BB%80%E4%B9%88%E6%9C%80%E6%96%B0%E7%9A%84+AI+%E6%96%B0%E9%97%BB%EF%BC%9F",
"totalEstimatedMatches": 11600000,
"someResultsRemoved": true
},
"_type": "SearchResponse",
"images": {
"id": "",
"readLink": "",
"webSearchUrl": "",
"isFamilyFriendly": false
},
"queryContext": {
"originalQuery": "今天有什么最新的 AI 新聞？"
},
"rankingResponse": {
"mainline": {
"items": [
{
"answerType": "News",
"value": {
"id": "https://api.bing.microsoft.com/api/v7/#News"
}
}
]
}
},
"videos": {
"value": [
{
"contentUrl": "https://www.bilibili.com/bangumi/play/ep289483",
"datePublished": "2024-04-02T16:00:00.0000000",
"hostPageDisplayUrl": "https://www.bilibili.com/bangumi/play/ep289483",
"width": 1656,
"creator": {
"name": "央視網"
},
"description": "央視網最有意思的原創短視頻欄目，專注于解釋熱點，分享知識，闡述流行，把嚴肅新聞、晦澀知識和熱搜話題一一“解剖”，讓知識流動起來，回應年輕人的好奇心。任何事情，用正常的方式講都很“無聊”，來“比劃”一下？",
"duration": "PT5M19S",
"name": "比劃：第108集 今天你看新聞了嗎？",
"embedHtml": "",
"hostPageUrl": "https://www.bilibili.com/bangumi/play/ep289483",
"publisher": [
{
"name": "bilibili"
}
],
"viewCount": 0,
"encodingFormat": "mp4",
"height": 1035,
"thumbnail": {
"height": 100,
"width": 160
},
"thumbnailUrl": "https://tse2-mm.cn.bing.net/th?id=OVP.OnK_Ket-fsNMpXE4TszL6wIIFF&pid=Api",
"webSearchUrl": "https://www.bing.com/videos/search?q=%E4%BB%8A%E5%A4%A9%E6%9C%89%E4%BB%80%E4%B9%88%E6%9C%80%E6%96%B0%E7%9A%84%20AI%20%E6%96%B0%E9%97%BB%EF%BC%9F&view=detail&mid=A9B1B240C84114F4EBCFA9B1B240C84114F4EBCF",
"allowMobileEmbed": false,
"allowHttpsEmbed": false,
"isSuperfresh": false
}
],
"webSearchUrl": "https://www.bing.com/videos/search?q=%E4%BB%8A%E5%A4%A9%E6%9C%89%E4%BB%80%E4%B9%88%E6%9C%80%E6%96%B0%E7%9A%84+AI+%E6%96%B0%E9%97%BB%EF%BC%9F",
"id": "https://api.bing.microsoft.com/api/v7/#Videos",
"readLink": "https://api.bing.microsoft.com/api/v7/videos/search?q=%E4%BB%8A%E5%A4%A9%E6%9C%89%E4%BB%80%E4%B9%88%E6%9C%80%E6%96%B0%E7%9A%84+AI+%E6%96%B0%E9%97%BB%EF%BC%9F",
"scenario": "List",
"isFamilyFriendly": true
}
},
"log_id": "202406101456135DFC496359DA858A1FB2",
"msg": "success",
"response_for_model": "["每日AI快訊、熱點、動態、融資、產品發布 | AI工具集\
AI工具集每日更新AI行業的最新資訊、新聞、熱點、融資、產品動態，讓你隨時了解人工智能領域的最新趨勢、更新突破和熱門大事件。 AI應用集 AI寫作工具\
link:https://ai-bot.cn/daily-ai-news/","澎湃新聞 - 推理性能提升30倍！英偉達發布史上最強AI芯片 ...\
在兩個小時的演講中，黃仁勛圍繞五大板塊，介紹了英偉達的最新研發進展：新的產業發展、Blackwell平臺、創新軟件NIMs、AI平臺NEMO和AI工坊（AI foundry）服務，以及仿真平臺Omniverse和適用于自主移動機器人的Isaac Robotics平臺。\
link:https://www.thepaper.cn/newsDetail_forward_26730539\
datePublished:2024-03-19T08:00:00.0000000","阿里、騰訊、百度發布 AI 最新進展；谷歌下一代大模型 ...\
AI 圈今天都發生了什么？. 速覽：. 阿里達摩院發布癌癥通用模型，可輔助診斷八種主流癌癥. 抖音、火山引擎、中國電影資料館將利用“AI + 人工”修復經典香港電影. 騰訊云智能推出基于大模型的文案創作工具. 阿里大文娛 CTO 鄭勇：妙鴨相機將并入新 ...\
link:https://new.qq.com/rain/a/20230817A076GL00\
datePublished:2023-08-17T08:00:00.0000000","李飛飛、吳恩達開年對話：AI 寒冬、2024新突破、智能體 ...\
李飛飛、吳恩達暢談 2024 AI 趨勢。. 在人工智能發展史上，2023 已經成為非常值得紀念的一年。. 在這一年，OpenAI 引領的 AI 大模型浪潮席卷了整個科技領域，把實用的 AI 工具送到了每個人手里。. 但與此同時，人工智能的發展也引起了廣泛的討論和爭議，尤其在 ...\
link:https://www.thepaper.cn/newsDetail_forward_26097944\
datePublished:2024-01-23T08:00:00.0000000","人工智能_人工智能最新資訊_CNMO\
百川智能發布Baichuan 4及首款 AI 智能助手“百小應”. 2024-05-22. 【CNMO科技消息】5月22日，百川智能發布最新一代基座大模型Baichuan4，并推出成立之后的首款AI助手“百小應”。. Baichuan4相較Baichuan3在各項能力上均有極大提升，其中通用能力提升超過10%，數學和代碼 ...\
link:https://ai.cnmo.com/\
datePublished:2024-05-27T08:00:00.0000000"]"
}通過這種方式，我們可以確保每個步驟的數據輸入和輸出都是結構化的，便于調試和維護。
Markdown：輕量級標記語言
Markdown 是一種輕量級標記語言，旨在使文本內容易于編寫和閱讀，同時可以轉換為結構化的格式（如 HTML）。它由 John Gruber 于 2004 年創建，最初目的是讓寫作 Web 內容變得更簡單。Markdown 的語法非常簡潔，只需要使用簡單的標記符號，就可以實現文本的格式化。
Markdown 使用特定的符號和字符來表示不同的格式，例如標題、列表、鏈接、圖片等。以下是一些常用的 Markdown 語法及對應的圖示效果：
- 標題：使用
#符號表示標題，數量表示標題級別。例如：
# 一級標題
## 二級標題
### 三級標題
圖片
- 列表：
無序列表使用 - 或 * 符號。例如：
- 項目一
- 項目二
- 項目三
圖片
- 有序列表使用數字加句點。例如：
1. 第一項
2. 第二項
3. 第三項
圖片
- 加粗和斜體：
加粗使用雙星號 ** 或雙下劃線 __ 括起來。例如：**加粗文本** 或 __加粗文本__。
斜體使用單星號 * 或單下劃線 _ 括起來。例如：*斜體文本* 或 _斜體文本_。
圖片
- 鏈接：使用方括號加圓括號表示。例如：
[鏈接文字](https://www.example.com)
圖片
- 圖片：使用感嘆號加方括號和圓括號表示。例如：
Markdown 被廣泛用于編寫文檔、博客文章、README 文件等。它的主要優點包括：
- 易讀易寫：相比 HTML，Markdown 的語法更加簡潔明了，更易于閱讀和編寫。
- 可轉換性強：Markdown 可以很容易地轉換為 HTML 或其他格式，適用于各種文本編輯和發布場景。
- 兼容性好：許多平臺和工具都支持 Markdown，用戶可以在不同環境中無縫使用。
假設我們需要編寫一篇關于 Markdown 的教程，可以使用以下 Markdown 語法來創建結構化的文檔：
# Markdown 教程
## 什么是 Markdown？
Markdown 是一種輕量級標記語言，旨在使文本內容易于編寫和閱讀，同時可以轉換為結構化的格式（如 HTML）。
## 基本語法
### 標題
使用 `#` 符號表示標題，數量表示標題級別。
### 列表
- 無序列表使用 `-` 或 `*` 符號。
- 有序列表使用數字加句點。
### 加粗和斜體
- **加粗** 使用雙星號 `**` 或雙下劃線 `__` 括起來。
- _斜體_ 使用單星號 `*` 或單下劃線 `_` 括起來。
### 鏈接和圖片
- 鏈接使用方括號加圓括號表示。
- 圖片使用感嘆號加方括號和圓括號表示。這是文檔的預覽效果：
圖片
Markdown 在 Coze 平臺中的應用
在 Coze 平臺上，Markdown 被廣泛用于撰寫和格式化文本內容。用戶可以使用 Markdown 來編寫或定義 Bot 的回復內容、說明文檔、開場白甚至是人設與回復邏輯等。
例子 1：編寫 Bot 的開場白
假設我們在 Coze 平臺上創建了一個 FAQ Bot，用于回答用戶的常見問題。我們可以使用 Markdown 來編寫開場白，使其更加清晰和結構化。例如：
# 你好，我是 FAQ Bot！
很高興見到你！我是一個專門為回答常見問題而設計的智能助手，隨時準備為你提供準確、詳細的解答。
## 我的技能
### 回答常見問題
1. **快速響應**：你有任何疑問，我會迅速從豐富的知識庫中找到答案，確保信息準確無誤。
2. **智能搜索**：如果遇到知識庫中沒有的問題，我會利用強大的搜索工具，為你整理出最佳的解決方案。
## 我的特點
- **專注可靠**：我只專注于回答與你的問題相關的內容，避免無關討論。
- **信息透明**：我所有的回答都基于可靠的知識庫和搜索結果，從不編造信息。
- **易于理解**：我會用清晰、簡潔的語言，確保你能輕松理解我的回答。
圖片
例子 2：定義工作流的輸出結果
假設我們在 Coze 平臺上創建了一個旅行規劃 Bot，用于根據我指定的旅行地點來推送我相關的旅行攻略。我們可以使用 Markdown 來定義工作流的輸出結果，使其更加易讀和清晰（記得前提是工作流的最終輸出區塊需要選擇使用設定的內容直接回答的回答模式才能生效）。例如：
## 旅游攻略推薦
{{default_llm_output}}
## 目的地附近酒店推薦
{{hotels_info}}
## 目的地天氣情況
{{weathers}}
圖片
對了，{{}}括號的內容是工作流處理后的輸入參數，方便我們在 Markdown 中引用，這樣我們就可以在 Markdown 中引用工作流的輸出結果，這里細節我會在后續的文章中詳細介紹。
最后我們來看看演示結果：
圖片
你會發現，經過調用這個工作流的輸出結果，它是完全按照我們指定的 Markdown 格式輸出的，這樣就可以更加方便地展示我們的數據結果和增加可讀性了。
總結
JSON 和 Markdown 是現代軟件開發中不可或缺的工具。通過本文的介紹，我們深入探討了這兩個工具的概念、結構、常用語法以及它們在 Coze 平臺中的具體應用。通過實際案例，我們展示了如何利用 JSON 和 Markdown 來配置插件參數、處理動態數據、創建結構化的文檔和幫助信息，從而提升 Bot 的開發效率和用戶體驗。
JSON 的重要性
JSON 作為一種輕量級的數據交換格式，被廣泛應用于客戶端和服務器之間的數據傳輸。它的輕量級、易于解析和高度兼容性，使其成為跨平臺數據交換的理想選擇。在 Coze 平臺中，JSON 被廣泛用于配置插件參數和復雜的工作流，確保數據的結構化和一致性。
Markdown 的重要性
Markdown 作為一種輕量級標記語言，以其簡潔的語法和良好的可讀性，成為編寫文檔和筆記的首選工具。它可以很容易地轉換為 HTML、PDF 等多種格式，適用于各種發布場景。在 Coze 平臺中，Markdown 被用于撰寫和格式化文本內容，使用戶能夠輕松創建清晰、結構化的文檔和幫助信息，提升用戶體驗和操作效率。
通過結合 Coze 平臺的功能，我們看到 JSON 和 Markdown 在實際應用中的廣泛應用和重要性。希望本文能幫助技術小白全面理解這兩個工具，并在實際開發和使用中充分發揮它們的優勢。無論是數據傳輸還是文本處理，這兩個工具都將繼續在軟件開發中發揮關鍵作用。無論你是開發者還是普通用戶，掌握 JSON 和 Markdown 都將大大提升你的工作效率和信息處理能力。
最后，記住：
- JSON 幫助我們高效地進行數據交換和配置，確保數據的準確性和一致性。
- Markdown 讓我們能夠快速編寫和格式化文檔，提高文本內容的可讀性和發布效率。
Reference
[1] https://www.runoob.com/json/json-tutorial.html: https://www.runoob.com/json/json-tutorial.html
[2] https://www.runoob.com/markdown/md-tutorial.html: https://www.runoob.com/markdown/md-tutorial.html
