Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Nhập một agent khai báo của Microsoft Agent Framework

Hướng dẫn từng bước này nhập một agent khai báo của Microsoft Agent Framework — một trợ lý trả lời câu hỏi dựa trên tài liệu mà nó tìm kiếm thông qua một máy chủ MCP — và dựng ứng dụng cho Docker Compose. Quá trình nhập soạn nháp mọi tệp mà bản dựng đọc: agent và mô hình của nó, khóa mà agent trình cho mô hình dưới dạng một tham chiếu biến, và các hiện thực hóa của từng thứ. Nó chỉ hỏi một lần về giá trị duy nhất mà không agent khai báo nào chứa, đó là image mà ứng dụng của bạn chạy trong đó. Mọi tệp và mọi khối đầu ra bên dưới đều đến từ một lần chạy thực; agent khai báo và từng giai đoạn của hướng dẫn nằm trong ví dụ import-agent-framework, nơi một script kiểm tra chạy lại quá trình nhập, so sánh những gì nó ghi, những gì nó in ra và các khối mà trang này trích dẫn với các tệp được lưu ở đó, rồi xác thực và dựng những gì quá trình nhập đã ghi.

Tạo ví dụ

Bạn có thể chạy lần nhập này bằng các lệnh trên trang này, hoặc để trợ lý AI của bạn chạy giúp bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example import-agent-framework

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới; lệnh tiếp sau đó, ở bên dưới, chuyển vào thư mục source của thư mục mới, nơi chứa những gì trang này nhập và là nơi chạy lệnh nhập:

Terminal window
cd import-agent-framework

Thư mục source của ví dụ được tạo, mở trong Visual Studio Code, hiển thị prompt agent SupportAgent với mô hình OpenAI và công cụ MCP Microsoft Learn của nó.

Dự án

Một ứng dụng xây dựng trên Agent Framework có thể tải một agent từ một agent khai báo: một tài liệu YAML thuộc loại Prompt nêu tên mô hình của agent, các chỉ dẫn và các công cụ của nó. Tài liệu này, được viết cho hướng dẫn này, nêu tên gpt-4.1-mini của OpenAI và máy chủ MCP mà Microsoft Learn phát hành:

kind: Prompt
name: SupportAgent
displayName: Support Assistant
description: Answers a customer's question about the product from its documentation.
instructions: You answer customers' questions about the product, from its documentation only.
model:
id: gpt-4.1-mini
provider: OpenAI
apiType: Responses
options:
temperature: 0.2
connection:
kind: key
key: =Env.OPENAI_API_KEY
tools:
- kind: mcp
name: microsoft_learn
description: Search Microsoft's documentation on Microsoft Learn.
url: https://learn.microsoft.com/api/mcp
approvalMode:
kind: never
allowedTools:
- microsoft_docs_search
- microsoft_docs_fetch

Khóa của mô hình được viết là =Env.OPENAI_API_KEY, nên tệp không chứa khóa nào. Agent Framework chỉ đọc biểu thức đó từ biến môi trường OPENAI_API_KEY khi ứng dụng tải agent khai báo bằng AgentFactory(safe_mode=False), thiết lập bảo mật riêng của Agent Framework, và có sẵn một runtime .NET; nếu không, khóa chính là văn bản của biểu thức như đã viết. Mã của ứng dụng, phần tải agent khai báo, không bao giờ được quá trình nhập đọc, và không thuộc ví dụ. Bên cạnh tệp, một .aggrega-config.yaml biến thư mục thành một không gian làm việc:

# The workspace key marks this directory as the workspace root, so an import run
# here writes its drafts beside support-agent.yaml.
workspace: {}
# The registry the importer is fetched from the first time an import needs it.
default_registry: hub.aggrega.ai

Quá trình nhập tham chiếu đến các Components agent Agent Framework và mô hình OpenAI của danh mục, và --target soạn nháp một Manifest từ các Recipes của nó. Không gian làm việc không chỉ định thư mục danh mục nào, nên quá trình nhập đọc danh mục thư viện chuẩn từ registry mà nó tải trình nhập của mình về: một bản chụp nhanh đã ký của danh mục đã phát hành, được lần nhập đầu tiên tải về, xác minh và giữ trong bộ nhớ đệm nội dung của không gian làm việc, và được nêu bằng digest của nó trong bản ghi mà quá trình nhập ghi cạnh các bản nháp của nó. Một không gian làm việc có chỉ định các thư mục danh mục riêng — trong AGGREGA_CATALOG_DIRS, hoặc dưới workspace.catalog_dirs — thì thay vào đó nhập so với các thư mục đó.

Quá trình nhập hỏi những gì

Một agent khai báo nêu tên mô hình của nó, không bao giờ nêu image mà ứng dụng chạy trong đó: bạn dựng image đó từ dự án của mình. Danh mục không có image mặc định cho một ứng dụng xây dựng trên Agent Framework, nên quá trình nhập hỏi về nó. Khi chạy trong một terminal mà không có sẵn câu trả lời, nó hỏi:

The drafts leave values empty that the source cannot hold. Answer each one, or press Enter to leave it for later in the answers file:
release.yaml spec.components.supportagent.infra.image
Container image running the application built on Microsoft Agent Framework.
>

và ghi câu trả lời vào các bản nháp và vào import-answers.yaml, cạnh support-agent.yaml, để lần nhập tiếp theo đọc nó từ đó và không hỏi gì. Khi không có terminal — trong tích hợp liên tục, hoặc qua một pipe — nó không hỏi gì: nó ghi tệp với khóa để trống, rồi dừng lại, nêu tên tệp. Ví dụ đã chứa sẵn tệp này, với image đã được trả lời, ghcr.io/example/support-agent:1.0.0, đại diện cho image mà bạn dựng:

# Values the import could not draft from the source, keyed by the drafted file and the key path inside
# it. Write each one beside its key; an import of the same source, and a sync, read them from here and
# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable
# name, ${NAME}, or the name of a Kubernetes Secret.
release.yaml:
# Container image running the application built on Microsoft Agent Framework.
spec.components.supportagent.infra.image: "ghcr.io/example/support-agent:1.0.0"
# The origin of the secret value, written by the operator in the Release. Read exactly as
# values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes
# from, never the value.
spec.components.supportagent.uses.model.gpt-4-1-mini.features.credential.infra.origin: "openai-api-key"

Câu trả lời thứ hai dành cho bản dựng cho Kubernetes, với --target helm: ở đó agent đọc khóa OpenAI từ một Secret của Kubernetes, và câu trả lời là tên của Secret, openai-api-key, không bao giờ là khóa. Một bản dựng cho Docker Compose thì đọc khóa từ shell của bạn, nên lần nhập này không dùng câu trả lời đó. Tệp câu trả lời của quá trình nhập mô tả tệp, các câu hỏi và các quy tắc cho câu trả lời của một bí mật.

aggrega import liệt kê mọi cờ mà lệnh nhận, trong đó có --answers, cờ nêu tên một tệp câu trả lời được lưu ở nơi khác.

Chuyển vào source:

Terminal window
cd source

Chạy lệnh nhập

Chỉ định tệp của agent khai báo. Quá trình nhập đọc mỗi agent khai báo như một tệp riêng và không bao giờ như một thư mục:

Terminal window
aggrega import support-agent.yaml --target compose

Trên đầu ra chuẩn, nó liệt kê những gì đã ghi:

wrote aggregate.yaml
wrote release.yaml
wrote manifest.yaml
wrote .aggrega-import.json

Trên luồng lỗi chuẩn, với <workspace> đại diện cho thư mục nơi bạn đã chạy nó:

[… omitted: a warning that the importer runs unverified, printed where its module is read from beside its Plugin entity in a catalog folder rather than fetched]
read as the agent-framework format, with drafted paths relative to <workspace>
warn: the value of tools.microsoft_learn.url of node SupportAgent is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
info: the answers file <workspace>/import-answers.yaml also answers spec.components.supportagent.uses.model.gpt-4-1-mini.features.credential.infra.origin in release.yaml, which these drafts do not leave empty; those answers are kept there and not applied
mapped SupportAgent (agent) to core/ai-agent/agent-framework as a reference, NONE
mapped gpt-4.1-mini (model) to core/ai-model/openai as a reference, NONE
made no choice for SupportAgent#microsoft_learn (tool)
Pull complete: <workspace>/release.lock (entities=8, source_artifacts=0, external_inputs=0)

Lần nhập được chạy từ trình soạn thảo: Aggregate, Release và Manifest đã soạn nháp xuất hiện bên cạnh agent khai báo, đầu ra Aggrega liệt kê cách agent và mô hình của nó được ánh xạ cùng các tệp đã ghi, và một thông báo cho biết lần nhập đã soạn nháp 3 tệp, được nhận diện là agent-framework.

  • Dòng warn nêu tên một giá trị có thể mang khóa — địa chỉ của một máy chủ MCP — và cho biết nó được mang đi đúng như đã viết. Địa chỉ này không mang khóa nào.
  • Dòng info nêu tên câu trả lời mà các bản nháp Docker Compose không dùng, được giữ trong tệp câu trả lời cho một bản dựng cho Kubernetes.
  • Các dòng mapped cho biết agent là một thực thể của agent Agent Framework trong thư viện chuẩn, core/ai-agent/agent-framework, và mô hình của nó là một thực thể của core/ai-model/openai. Cấp của chúng ghi NONE: quá trình nhập Agent Framework tham chiếu đến các Components này theo những gì agent khai báo nêu tên, thay vì so sánh từng cái với danh mục.
  • Dòng made no choice là máy chủ MCP, thứ mà quá trình nhập không soạn nháp thành Component nào, vì lý do mà các chú thích trong aggregate.yaml đưa ra.
  • Dòng Pull complete là quá trình nhập đang tải những gì mà Release bản nháp phụ thuộc vào, như aggrega pull làm, vào release.lock, để các bản nháp được xác thực và build ngay lập tức. Với --offline, quá trình nhập không tải gì và nêu lệnh aggrega pull cần chạy.

Những gì được ghi

Aggregate, Release và Manifest được đặt tên imported/supportagent, theo name của tác tử, SupportAgent, rút gọn thành supportagent — displayName của nó không được đọc — dưới namespace mà thiết lập target_namespace của trình nhập đặt ra, là imported trừ khi bạn đặt namespace khác (Thiết lập).

aggregate.yaml — agent, được nối với mô hình của nó với khóa mà nó xuất trình được khai báo trên kết nối, và mô hình đó:

# Not read: the application's code, which loads each declarative agent and binds the functions of its function tools; the application runs in the image the Release names for each instance, and loads its declarative agents itself.
apiVersion: aggrega.ai/v1beta1
kind: Aggregate
metadata:
name: imported/supportagent
version: 0.1.0
description: Draft Aggregate imported from a source in the agent-framework format.
spec:
components:
# The declarative agent SupportAgent.
# Read by the application from the declarative agent, and taken by no key of core/ai-agent/agent-framework: instructions, the options of its model requests (temperature).
# The MCP server microsoft_learn, drafted as no Component and no connection, since Agent Framework sends it to the model's provider as a hosted tool, and the provider, not the application, reaches it at its url, which must therefore be reachable from the provider; its url is written above supportagent's entry in the Release.
# Stated by the declarative agent for microsoft_learn: its description, "Search Microsoft's documentation on Microsoft Learn."; its approval mode, never; the tools of the server it allows, microsoft_docs_search, microsoft_docs_fetch.
supportagent:
type: core/ai-agent/agent-framework
values:
display_name: "Support Assistant"
description: "Answers a customer's question about the product from its documentation."
uses:
model:
gpt-4-1-mini:
target: gpt-4-1-mini
# For the compose target, the lines below declare credential on gpt-4-1-mini: a secret the Release alone attaches arrives under the key value, so each is declared with a key of its own and no two arrive under one; the Release attaches its origin, naming this type or none.
features:
credential:
type: core/secret-value
values:
key: OPENAI_API_KEY
# The model gpt-4.1-mini, which SupportAgent names with the OpenAI provider.
gpt-4-1-mini:
type: core/ai-model/openai
values:
model: "gpt-4.1-mini"

Máy chủ MCP không phải là Component và cũng không phải là kết nối của agent: Agent Framework gửi nó tới nhà cung cấp của mô hình dưới dạng một công cụ được lưu trữ, và chính nhà cung cấp, chứ không phải ứng dụng, tiếp cận nó tại url của nó, vì vậy địa chỉ này phải truy cập được từ phía nhà cung cấp. Các chỉ dẫn, các tùy chọn của yêu cầu gửi tới mô hình, cùng phần mô tả, chế độ phê duyệt và các công cụ được phép của máy chủ vẫn nằm trong agent khai báo, thứ mà ứng dụng đọc; các chú thích nêu tên từng thứ. API của OpenAI là một dịch vụ được lưu trữ, nên Component của agent từ chối một kết nối tới nó mà không mang thông tin xác thực nào; kết nối khai báo một thông tin xác thực, dưới khóa OPENAI_API_KEY, biến mà agent khai báo đọc khóa của nó từ đó.

release.yaml — môi trường, image, cổng được công bố và nguồn của khóa:

apiVersion: aggrega.ai/v1beta1
kind: Release
metadata:
name: imported/supportagent
# environment is a drafted default, since no source names the environment this Release deploys to; change it to name the one it deploys to.
environment: development
version: 0.1.0
description: Draft Release imported from a source in the agent-framework format.
spec:
aggregate: imported/supportagent
manifest: imported/supportagent
components:
# The declarative agent also states these values for its model and its MCP servers, written here for review:
# - model.connection.key, written as =Env.OPENAI_API_KEY, which Agent Framework reads from the environment variable OPENAI_API_KEY only where the application loads the declarative agent with AgentFactory(safe_mode=False), Agent Framework's own security setting, and a .NET runtime is present; otherwise the value is the expression's text as written
# - tools.microsoft_learn.url: "https://learn.microsoft.com/api/mcp"
supportagent:
infra:
# Left for the Release, since the source cannot supply it: infra.image, the container image running the application built on Agent Framework, holding its declarative agent
image: "ghcr.io/example/support-agent:1.0.0"
# Published on this machine's loopback address, 127.0.0.1: reachable from this machine only, by any process running on it. Delete this line to keep the service internal.
published_port: 8000
uses:
model:
gpt-4-1-mini:
features:
credential:
type: core/secret-value
infra:
# Attached by reference, never as a value: the credential supportagent presents to gpt-4-1-mini on its model connection, read from the variable OPENAI_API_KEY, which a target substituting variable references, as Docker Compose does when the stack starts, reads from the environment, so no file carries the value.
origin: "${OPENAI_API_KEY}"
gpt-4-1-mini: {}

Môi trường, development, là giá trị mặc định mà quá trình nhập ghi vì không có agent khai báo nào nêu tên một môi trường; hãy thay đổi nó khi Release triển khai ở nơi khác. Image là câu trả lời mà quá trình nhập đã đọc từ import-answers.yaml. Agent được công bố trên địa chỉ loopback của máy bạn, trên cổng 8000, chuyển tiếp tới cổng mà chương trình của nó lắng nghe, infra.port, là 8000 trừ khi bạn đặt giá trị khác. Khóa là tham chiếu biến ${OPENAI_API_KEY}, được đặt tên theo biến mà agent khai báo đọc, không bao giờ là một giá trị. Địa chỉ của máy chủ MCP được viết đúng như agent khai báo nêu, để xem xét, và không được đặt ở bất kỳ nơi nào khác: Agent Framework trao nó cho nhà cung cấp trong yêu cầu gửi tới mô hình.

manifest.yaml — Recipe Compose của agent và của mô hình, và phần hiện thực hóa ghi tham chiếu biến của khóa vào tệp Compose đúng như đã viết:

apiVersion: aggrega.ai/v1beta1
kind: Manifest
metadata:
name: imported/supportagent
version: 0.1.0
spec:
mappings:
components:
type:
core/ai-agent/agent-framework: compose/agent-framework
core/ai-model/openai: compose/openai
features:
type:
core/secret-value: compose/dotenv-secret

release.lock ghi lại, theo digest, các thực thể danh mục mà Release đã được phân giải tới, và .aggrega-import.json là bản ghi về những gì quá trình nhập đã ghi, được một lệnh aggrega import --sync sau đó đọc.

Xác thực và dựng

Terminal window
aggrega validate --release release.yaml
aggrega build --release release.yaml

Bản nháp Release mở trong trình soạn thảo sau khi xác thực, với đầu ra Aggrega và một thông báo đều cho biết không tìm thấy vấn đề nào.

Bản build của bản nháp Release: một thư mục dist xuất hiện trong Explorer, đầu ra Aggrega liệt kê tệp Docker Compose đã ghi, và một thông báo cho biết đã ghi 1 tệp.

Bước xác thực in ra:

notice: LINT: Feature "core/secret-value" at core/secret-value:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)
release dependency validation passed: release.yaml (schema-pillar + dependency pillars)

và bản dựng, với <workspace> đại diện cho thư mục mà bạn đã chạy nó:

notice: LINT: Feature "core/secret-value" at core/secret-value:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)
[… omitted: a total build time, which differs per run]
Build completed: 1 file written to <workspace>/dist

Dòng notice chỉ mang tính tham khảo: Feature bí mật chấp nhận origin của nó từ values của Aggregate hoặc infra của Release, và thông báo cho biết có một lá được khai báo ở cả hai. Nó không thay đổi phán quyết nào.

Dịch vụ của agent trong dist/compose/docker-compose.yaml:

services:
supportagent:
image: ghcr.io/example/support-agent:1.0.0
environment:
OPENAI_BASE_URL: https://api.openai.com/v1
OPENAI_MODEL: gpt-4.1-mini
OPENAI_API_KEY: ${OPENAI_API_KEY}
ports:
- 127.0.0.1:8000:8000
[… omitted: the labels the build writes on every service, naming the Aggregate, the component, the environment and the compiler's version]
networks:
- compose

Ứng dụng nhận địa chỉ, tên và khóa của mô hình trong các biến mà các máy khách OpenAI của Agent Framework đọc, nên =Env.OPENAI_API_KEY của agent khai báo đọc khóa mà Release đã gắn ở nơi ứng dụng tải agent như Dự án mô tả. Không có biến nào mang địa chỉ của máy chủ MCP, máy chủ mà nhà cung cấp tiếp cận. Mô hình không có dịch vụ riêng: agent tiếp cận API OpenAI tại chính địa chỉ của API đó. Khóa là một tham chiếu biến, được điền từ shell của bạn khi stack khởi động. Dịch vụ chỉ công bố cổng của nó trên 127.0.0.1.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega có thể làm điều tương tự: dán prompt này vào nó.

Chỉ dùng các công cụ của Aggrega, và không tự tạo thư mục nào. Nếu thư mục Workspace chưa có thư mục `import-agent-framework`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-agent-framework` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-agent-framework` mới, có thư mục `source` chứa những gì trang này nhập. Sau đó gọi công cụ `import` với `workspace_root` đặt thành `import-agent-framework/source`, `source` đặt thành `support-agent.yaml` và `target` đặt thành `compose`: công cụ này đọc các câu trả lời nó cần từ `import-answers.yaml` bên cạnh `support-agent.yaml`, ghi các bản nháp vào `import-agent-framework/source` và kéo về những gì các bản nháp cần. Sau đó gọi công cụ `validate` với `workspace_root` đặt thành `import-agent-framework/source` và `release` đặt thành `release.yaml`, và công cụ `build` với `workspace_root` đặt thành `import-agent-framework/source`, `release` đặt thành `release.yaml` và `write` đặt thành true. Cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `import-agent-framework/source/dist/`.

Mở trong VS Code

Khi đã cài tiện ích mở rộng Aggrega cho Visual Studio Code, hãy mở thư mục import-agent-framework/source trong VS Code, nơi quá trình nhập đã ghi các bản nháp. Thư mục chứa một Release duy nhất, bản nháp release.yaml, nên trình soạn thảo tự chọn nó cho bạn, và kiểm tra các bản nháp đối chiếu với Release đó khi bạn chỉnh sửa, đánh dấu những gì nó tìm thấy trong tệp và trong bảng Problems. Aggrega: Show topology graph, trong Command Palette, vẽ các thành phần của Release và các kết nối giữa chúng. Aggrega: Build, Aggrega: Preview build và Aggrega: Pull tác động lên cùng Release đó, và mỗi lệnh cũng là một nút trên bảng Commands của chế độ xem Aggrega trong thanh hoạt động; Build ghi các tệp của nó vào dist/ của thư mục. Dùng Aggrega trong Visual Studio Code trình bày phần còn lại.

Chạy thử

Bạn tự xây dựng image từ dự án, bằng một Dockerfile của riêng bạn: mã của ứng dụng, với Agent Framework đã được cài đặt và agent khai báo bên trong. Docker Compose chạy lệnh riêng của image làm dịch vụ của agent, vì Recipe không đặt lệnh nào, nên lệnh đó phải tiếp tục chạy, và phải phục vụ các yêu cầu nếu bạn muốn tiếp cận agent. Chương trình của bạn quyết định địa chỉ, route và câu trả lời.

Lần chạy dưới đây đã dùng một image như vậy: Python với các gói agent-framework-core, agent-framework-openai và agent-framework-declarative của Agent Framework, một runtime .NET — image đặt DOTNET_ROOT thành thư mục của nó và DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 — support-agent.yaml, và, làm lệnh của image, một máy chủ HTTP nhỏ của riêng chương trình trên cổng 8000. Máy chủ tải agent khai báo bằng AgentFactory(safe_mode=False), nên =Env.OPENAI_API_KEY của nó đọc khóa mà bản dựng cung cấp, và chạy agent một lần cho mỗi POST /ask. Hãy xây dựng image của bạn tại thư mục gốc của dự án, viết tên của nó vào chỗ ghcr.io/example/support-agent:1.0.0 trong import-answers.yaml, và nhập lại với --sync, lệnh này ghi câu trả lời mới vào các bản nháp và pull lại; rồi dựng:

Terminal window
docker build -t docs-assistant:local .
aggrega import support-agent.yaml --sync
aggrega build --release release.yaml

Với docs-assistant:local làm câu trả lời, quá trình đồng bộ nêu tên giá trị duy nhất mà nó đã thay đổi, trong số các dòng nó in ra:

changed spec.components.supportagent.infra.image in release.yaml

Sau đó đặt khóa trong shell của bạn và khởi động stack:

Terminal window
export OPENAI_API_KEY='your OpenAI key'
docker compose -p docs-assistant -f dist/compose/docker-compose.yaml up -d --wait

-p đặt tên cho dự án, như bước chạy của Cách một lần nhập diễn ra giải thích.

Kiểm thử

Yêu cầu dưới đây đến chương trình mà image của hướng dẫn này chạy: agent khai báo đằng sau một máy chủ HTTP nhỏ trên cổng 8000, trả lời POST /ask. Chương trình của riêng bạn tự quyết định tuyến và phản hồi của nó. Hãy gửi nó tới http://127.0.0.1:8000, địa chỉ mà published_port công bố, khi chương trình đã lắng nghe, vài giây sau khi stack khởi động:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'
{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}

Lần chạy này đặt OPENAI_API_KEY thành một giá trị giữ chỗ, nên phản hồi là lời từ chối của OpenAI đối với giá trị đó, được chương trình chuyển tiếp. Khóa mà OpenAI từ chối chính là giá trị giữ chỗ đó, được hiển thị ở dạng che, nên =Env.OPENAI_API_KEY của agent khai báo đã đọc nó từ môi trường mà bản build cung cấp.

Dừng stack bằng:

Terminal window
docker compose -p docs-assistant -f dist/compose/docker-compose.yaml down

Trên Kubernetes, hãy nhập với --target helm và đẩy image lên một registry mà cụm của bạn kéo về, ghi tên của nó trong import-answers.yaml. Sau đó tạo Secret openai-api-key và áp dụng bản build, như bước chạy của Cách một lần nhập diễn ra mô tả. Deployment của agent không có Service, nên hãy chuyển tiếp một cổng cục bộ tới nó. Lệnh chạy cho đến khi bạn dừng nó:

Terminal window
kubectl port-forward deploy/supportagent 8000:8000
Forwarding from 127.0.0.1:8000 -> 8000
Forwarding from [::1]:8000 -> 8000

Từ một terminal khác, gửi cùng yêu cầu đó tới cổng đã chuyển tiếp:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \
-d '{"question": "In one short sentence: what is Azure Container Apps?"}'
{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}