本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 編碼客服人員洞見
<a name="coding-agents-insights"></a>

OpenAI Codex、Claude Code 和 GitHub Copilot 等 AI 編碼代理程式會發出有關開發人員如何使用它們的 OpenTelemetry (OTel) 遙測 - 權杖消耗、周轉延遲、工具呼叫、API 請求和核准。當您將此遙測傳送至 Amazon CloudWatch 時，您可以監控採用率、將用量和成本歸因於團隊和部門，以及找出開發人員機群的效能或可靠性問題。

CloudWatch 提供 **Coding Agent Insights**，這是在主控台的 **GenAI 可觀測性**、**Coding Agent Insights** 下的一組ready-to-use儀表板。儀表板可讓您跨組織、部門、團隊、成本中心和使用者等組織屬性分割和配量用量，以便比較整個機群的採用率和成本。您也可以將基礎資料匯出為 CSV 以供進一步分析。您不會建立或匯入這些儀表板。當您的客服人員以預期的形狀傳送指標時，它們會自動顯示並填入。您的唯一任務是設定每個代理程式將其 OTel 指標發佈至 CloudWatch。

**重要**  
編碼 Agent Insights 儀表板依賴特定的指標和屬性形狀。每個客服人員的原生 OTel 指標都具有儀表板的核心維度 （例如 `model`和 `token_type`)。身分和組織屬性 （例如 `user.email`、`team.id`、`cost_center`、 `department`和 `organization`) 必須做為 OTel *資源*屬性傳送。本節中的設定指南會將每個代理程式設定為發出此形狀的遙測。如果您變更指標名稱或將身分屬性移出資源，儀表板可能不會填入。

## 先決條件
<a name="coding-agents-insights-prereqs"></a>

編碼代理程式會將指標傳送至 CloudWatch 原生 OTLP 指標端點。設定代理程式之前，請先熟悉 端點。如需詳細資訊，請參閱[OTLP 端點](CloudWatch-OTLPEndpoint.md)及[開始使用](CloudWatch-OTLPGettingStarted.md)。

## 設定指南
<a name="coding-agents-insights-guides"></a>

選擇您的編碼代理程式指南。每個指南都涵蓋一或多個設定路徑，因此您可以選擇符合您開發人員執行代理程式的方式。

**Topics**
+ [為 Claude Code 設定 OpenTelemetry](coding-agents-claude-code.md) — 使用承載字符 （個人和小型團隊） 或使用公司 SSO 進行企業推展來設定 Claude Code。
+ [設定 OpenAI Codex 的 OpenTelemetry OpenAI](coding-agents-codex.md) — 使用承載字符 （個人和小型團隊） 或使用公司單一登入 (SSO) 的企業推展來設定 OpenAI Codex。
+ [設定 GitHub Copilot 的 OpenTelemetry](coding-agents-copilot.md) — 使用承載字符設定 GitHub Copilot。

## 檢視儀表板
<a name="coding-agents-insights-view"></a>

客服人員開始傳送指標後，請在 主控台中檢視儀表板。

**檢視編碼客服人員洞見儀表板**

1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇 **GenAI 可觀測性**，然後選擇**編碼客服人員洞見**。

1. 選擇編碼代理程式的索引標籤。指標通常會在客服人員傳送資料的幾分鐘內顯示。

**注意**  
指標可透過 PromQL 查詢，因此您也可以建置自己的儀表板和警示。如需詳細資訊，請參閱[PromQL 查詢](CloudWatch-PromQL-Querying.md)。