# 使用 Amazon Bedrock AgentCore Code Interpreter 執行程式碼和分析資料
<a name="code-interpreter-tool"></a>

Amazon Bedrock AgentCore Code Interpreter 可讓 AI 代理器在沙盒環境中安全地撰寫和執行程式碼，提高其準確性並擴展其解決複雜end-to-end任務的能力。這在代理程式 AI 應用程式中至關重要，其中代理程式可能會執行任意程式碼，這可能會導致資料洩露或安全風險。AgentCore Code Interpreter 工具提供安全的程式碼執行，可協助您避免遇到這些問題。

Code Interpreter 隨附適用於多種語言和進階功能的預先建置執行時間，包括大型檔案支援和網際網路存取，以及 CloudTrail 記錄功能。對於內嵌上傳，檔案大小最多可達 100 MB。對於透過終端機命令上傳至 Amazon S3，檔案大小最多可達 5 GB。

開發人員可以使用工作階段屬性和網路模式自訂環境，以滿足其企業和安全性需求。AgentCore Code Interpreter 可減少手動介入，同時啟用複雜的 AI 開發，而不會犧牲安全性或效能。

**Topics**
+ [概觀](#code-interpreter-overview)
+ [為什麼在代理程式開發中使用 Code Interpreter](#code-interpreter-why-important)
+ [最佳實務](#code-interpreter-best-practices)
+ [預先安裝的程式庫](code-interpreter-preinstalled-libraries.md)
+ [AgentCore Code Interpreter 入門](code-interpreter-getting-started.md)
+ [在 代理程式的程式碼解譯器中執行程式碼](code-interpreter-building-agents.md)
+ [將檔案寫入工作階段](code-interpreter-file-operations.md)
+ [使用具有 執行角色的終端機命令](code-interpreter-s3-integration.md)
+ [資源和工作階段管理](code-interpreter-resource-session-management.md)
+ [程式碼解譯器 API 參考範例](code-interpreter-api-reference-examples.md)
+ [可觀測性](code-interpreter-observability.md)
+ [設定 Amazon Bedrock AgentCore 程式碼解譯器的根憑證授權機構](code-interpreter-root-ca-certificates.md)
+ [故障診斷 AgentCore 程式碼解譯器](code-interpreter-troubleshooting.md)

## 概觀
<a name="code-interpreter-overview"></a>

AgentCore Code Interpreter 是一項功能，可讓 AI 代理器在沙盒環境中安全地寫入、執行和偵錯程式碼。它提供自然語言理解和運算執行之間的橋樑，讓客服人員能夠以程式設計方式操作資料和執行計算。

AgentCore Code Interpreter 會在 Amazon Bedrock AgentCore 內的容器化環境中執行，確保程式碼執行保持隔離和安全。

![顯示內建工具產品以及瀏覽器和 CI 工具的架構。](http://docs.aws.amazon.com/zh_tw/bedrock-agentcore/latest/devguide/images/code-interpreter.png)


## 為什麼在代理程式開發中使用 Code Interpreter
<a name="code-interpreter-why-important"></a>

AgentCore Code Interpreter 以下列方式增強代理程式開發：
+ 安全地執行程式碼：開發可在沙盒環境中執行複雜工作流程和資料分析的代理程式，同時存取內部資料來源，而不會暴露敏感資料或危及安全性。
+ 多種程式設計語言：Code Interpreter 支援各種程式設計語言，包括 Python、JavaScript 和 TypeScript，使其適用於不同的使用案例。
+ 監控和大規模資料處理：追蹤和疑難排解程式碼執行。使用大型資料集時，您可以輕鬆參考存放在 Amazon S3 中的檔案，從而有效地處理 GB 級資料，而不受 API 限制。
+ 易用性：使用全受管預設模式搭配預先建置的執行時間，以支援預先安裝常見程式庫的熱門程式設計語言。
+ 擴展問題解決功能：允許客服人員解決難以單獨透過推理解決的運算問題，並大規模實現精確的數學計算和資料處理。
+ 長時間執行持續時間支援：Code Interpreter 工具支援預設執行時間為 15 分鐘，最多可延長 8 小時。
+ 處理結構化資料：處理 CSV、Excel、JSON 和其他資料格式，並執行資料清理和分析。
+ 啟用複雜的工作流程：允許將推理與運算結合的多步驟問題解決，並促進反覆開發和偵錯。

AgentCore Code Interpreter 透過運算執行來補充代理程式的推理能力，讓他們能夠有效地處理更廣泛的任務。

## 最佳實務
<a name="code-interpreter-best-practices"></a>

若要充分利用 AgentCore Code Interpreter：
+ 保持程式碼片段簡潔並專注於特定任務
+ 使用註解記錄您的程式碼
+ 使用大型資料集時最佳化效能的程式碼
+ 執行複雜操作時儲存中繼結果
+ 使用`code_session`內容管理員來確保適當的清除
+ 在程式碼中包含 try/except 區塊，以正常處理錯誤
+ 程式碼執行結果會傳回並處理為串流
+ 不再需要時清除暫存檔案
+ 當您完成釋放資源時關閉工作階段