跳轉到

第一個 Agent

這頁帶你親手做出第一個 Agent——一個會對話的 AI 助理（例如客服小幫手、採購助理、法規顧問）。全程在瀏覽器上點選操作，不需要寫任何程式。

預計花費：約 5–10 分鐘。

開始前

你需要：可登入的 Headquarter.ai 帳號，以及至少一個已設定好的 LLM 資源（也就是 Agent 背後的 AI 模型）。若還沒有，請參考 LLM Resource 指南，或請你的管理員協助準備。

Agent 還是 Workflow？

還不確定該用哪一種？先看 概念 → Agent 還是 Workflow？。簡單說：要一個會聊天、能多輪互動的助理，就用 Agent（本頁）；要一條固定步驟、跑完就結束的自動流程，就看 第一個工作流程。

動手做：最簡單的對話助理

一個能對話的 Agent，最少只要三樣東西：名稱、要用的 AI 模型，以及一段告訴它「你是誰、要做什麼」的 Agent 提示詞。填好這三項就能存檔開聊，其餘設定都有預設值、日後再調即可。

flowchart LR
    Name[名稱] --> Save[儲存後即可對話]
    LLM[大型語言模型] --> Save
    Prompt[Agent 提示詞] --> Save

步驟 1：建立新的 Agent

  1. 從左側選單進入「Agents」。
  2. 按右上角的 +（新增）按鈕，會跳出選單。

  3. 選擇「從空白開始」。

    Agents 清單頁的建立選單，顯示「從空白開始」與「從生成器建立」兩個選項

兩種建立方式

選單裡還有一個「從生成器建立」，是三步驟精靈，會幫你上傳文件、自動接好知識庫，適合做「會讀自家文件」的問答助理。本頁先走最單純的「從空白開始」；兩種方式的完整說明見 建立 Agent。

步驟 2：填三個必要欄位

進入設定表單後，先把下面三項填好就夠了：

  1. 在「名稱」欄位填一個好辨識的名稱，例如 customer-support-agent。
  2. 點「大型語言模型」欄位，在跳出的資源選擇對話框選一個你要用的 LLM 資源那一列，按對話框右上角的「儲存」確認。

  3. 在「Agent 提示詞」欄位寫一段話，告訴 Agent 它是誰、要做什麼、語氣如何。

    建立 Agent 的設定表單，依序為名稱、大型語言模型、描述、Agent 提示詞，以及內建工具、自訂工具、進階設定、介面設定四個可展開區塊

欄位 必填 說明
名稱 是 好辨識的名稱。最長 64 字，不可空白，且不能以 default 開頭。
大型語言模型 是 Agent 預設使用的 AI 模型，從資源選擇對話框挑一個 LLM 資源。
Agent 提示詞 否（強烈建議） 告訴 Agent 它的身分、任務與語氣。不填也能建立，但回答品質會差很多。

Agent 提示詞怎麼寫

把它想成「給新進助理的工作說明」。例如：

你是一位客服助理，負責回答本公司產品的問題。請用親切、簡潔的繁體中文回答；若不確定答案，請誠實告知並建議聯絡真人客服。

不知道怎麼寫得更完整？可以先寫幾句草稿，再用輸入框右上角的 「改寫」功能請 AI 幫你優化——做法見 建立 Agent → 用「改寫」優化提示詞。

其餘欄位（描述、可切換的大型語言模型、最大對話輪數、工具、介面設定等）都有合理預設值，初次使用一律維持預設即可，日後再到 Agent 設定總覽 調整。

步驟 3：儲存

填好三個欄位後，點右上角的「儲存」，系統就會建立這個 Agent。

步驟 4：開始對話

  1. 回到「Agents」清單，把滑鼠移到剛建立的那一列上，列尾會出現「前往聊天」入口，點它進入對話畫面。

    Agents 清單中每列的「前往聊天」入口

  2. 在下方輸入框輸入問題，按 「送出」，Agent 會即時逐字回覆。

    Agent 對話畫面，中間顯示開場白與一段 Markdown 內文，下方為輸入框

🎉 完成！你已經做出第一個會對話的 AI 助理。完整的對話操作與測試技巧見 與 Agent 對話。

你做出來的 Agent 長這樣

設定項 你填了什麼
名稱 好辨識的助理名稱（例如 customer-support-agent）。
大型語言模型 Agent 背後實際作答的 AI 模型資源。
Agent 提示詞 它的身分、任務與語氣——決定了回答的風格與品質。

這個 Agent 目前只會用模型本身的知識聊天。想讓它查你自己的文件、上網、或呼叫外部系統，下一步就是幫它加上「工具」。

下一步