想喺自己嘅 App 入面跑 AI agent，而唔只係用 ChatGPT 網頁？OpenAI Agents SDK 俾你用 TypeScript 或 Python 定義 agent、tools、handoffs、guardrails，喺自己嘅伺服器跑 agent loop。
Agents SDK 係咩
Code-first 方案：你喺自己伺服器或 App 入面寫 agent 定義，SDK 處理 agent loop 執行。適合需要接公司 API、資料庫、審批流程嘅產品——唔同於「只喺 ChatGPT 網頁傾偈」。
官方文件：Agents SDK · Quickstart
最短安裝
# TypeScript
npm install @openai/agents zod
# Python
pip install openai-agents
export OPENAI_API_KEY=你的金鑰金鑰喺 OpenAI API keys 建立。香港用正式帳戶同公司卡或預付即可。
第一個 Agent（概念）
基本流程：
- 定義
Agent：設定name、instructions，可選model - 用
run（TypeScript）或Runner.run（Python）執行一句輸入 - 讀取
finalOutput或final_output
官方 Quickstart 有完整可複製例子。
下一步通常係：
- 加 function tool
- 設定 handoffs 分流去專科 agent
- 開 Traces 睇工具呼叫記錄
香港開發者實務建議
| 場景 | 建議 |
|---|---|
| 內部客服分流 | triage agent + 專科 handoff，加 human review |
| 讀公司文件 | hosted file search 或自建 tool，留意個資處理 |
| 費用預算 | 跟 OpenAI API 價目，另見 Gemini API 價錢比較 |
| 合規 | 唔好把客戶個資寫死喺 prompt log，跟公司 DPO 政策 |
進階資源
相關文章
更新於 2026-10-26（Asia/Hong_Kong）。
