pac copilot

Các công cụ và tiện ích để quản lý lái phụ.

Các initlệnh , clone, pull, và push, pack cho phép bạn giữ tác nhân Copilot Studio làm tập hợp các tệp trên ổ đĩa, chỉnh sửa tệp cục bộ và đồng bộ hóa tác vụ đó với môi trường Dataverse.

Một vòng lặp điển hình trông như thế này:

1. Bắt đầu một không gian làm việc. Giàn giáo một đại lý hoàn toàn mới với pac copilot init, hoặc tải về một cái hiện có với pac copilot clone. Dù bằng cách nào bạn nhận được một không gian làm việc cục bộ có siêu dữ liệu đồng bộ các lệnh khác phụ thuộc vào.
2. Kéo trước khi bạn chỉnh sửa. pac copilot pull mang các thay đổi từ xa xuống và phối chúng vào các tệp cục bộ của bạn, vì vậy bạn bắt đầu từ trạng thái máy chủ hiện tại.
3. Đẩy khi bạn hoàn tất. pac copilot push sẽ gửi các thay đổi cục bộ của bạn trở lại. Nếu cùng một mục đã thay đổi trên máy chủ trong thời gian chờ đợi, hãy nhấn dừng và yêu cầu bạn kéo trước.
4. Gói để triển khai. pac copilot pack biến một không gian làm việc thành một giải pháp bạn .zip có thể triển khai với pac solution import.

Để đi từ không có gì đến một đại lý trực tiếp trong một bước duy nhất, pac copilot init --environment giàn giáo, gói, nhập khẩu, và kết nối không gian làm việc cho bạn. Các lệnh riêng lẻ cho phép bạn tự điều khiển từng phần của vòng lặp.

Lệnh

pac copilot clone

Sao chép một Copilot Studio tác nhân vào thư mục không gian làm việc cục bộ.

pac copilot clonetải xuống tác nhân Copilot Studio hiện có vào thư mục không gian làm việc cục bộ, pac copilot pull cùng với siêu dữ liệu đồng bộ và pac copilot push dựa vào. Các tệp của đại diện được viết vào một thư mục con có tên theo tên hiển thị của nó.

Ví dụ:

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

Tham số Bắt buộc cho copilot clone

--bot -id

ID Copilot hoặc tên sơ đồ (tên duy nhất được tìm thấy trong Chi tiết Bot hoặc tên tệp trong trình khám phá giải pháp).

Tham số Tùy chọn cho copilot clone

--component-collection -cc

ID bộ sưu tập cấu phần để nhân bản. Lặp lại cho nhiều lần.

--display-name -dn

Tên hiển thị của tác nhân (được dùng để đặt tên thư mục).

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--output-dir -od

Thư mục gốc cho đầu ra bản sao. Mặc định cho thư mục hiện tại.

Nhận xét

• --botchấp nhận ID Copilot hoặc tên sơ đồ. Truyền ID Copilot (GUID) hoặc tên sơ đồ của đại diện. Lệnh này giải quyết tên sơ đồ đối với môi trường đích.
• Thư mục con đích phải trống. Clone viết vào một thư mục được đặt tên theo tên hiển thị (sanitized) của đại lý trong --output-dir. Nếu thư mục đó đã chứa các tệp, bản sao sẽ dừng lại thay vì ghi đè chúng. Dùng --display-name để chọn tên thư mục khác.
• Tạo bản sao bộ sưu tập cấu phần. Để đưa bộ sưu tập cấu phần xuống cùng với tác nhân, hãy chuyển một hoặc nhiều ID bộ sưu tập --component-collectionbằng , phân tách bằng dấu chấm phẩy.
• Clone yêu cầu một hồ sơ xác thực (pac auth create) --environmentvà giải quyết các môi trường từ , hoặc từ tổ chức của hồ sơ hoạt động khi bạn bỏ qua nó.

pac copilot create

Tạo một bộ lái mới sử dụng tệp mẫu hiện có làm tham chiếu.

Tham số Bắt buộc cho copilot create

--displayName

Tên hiển thị của bộ lái mới

--schemaName

Tên sơ đồ (tên duy nhất) của copilot mới.

--solution -s

Tên của giải pháp.

--templateFileName

Tệp yaml nguồn chứa mẫu copilot được trích xuất bằng cách sử dụng lệnh trích xuất mẫu.

Tham số Tùy chọn cho copilot create

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac copilot delete

Xóa thư mục Tùy Copilot.

Tham số Bắt buộc cho copilot delete

--bot -id

ID Copilot hoặc tên sơ đồ (tên duy nhất được tìm thấy trong Chi tiết Bot hoặc tên tệp trong trình khám phá giải pháp).

Tham số Tùy chọn cho copilot delete

--confirm -y

Yêu cầu xác nhận xóa máy bay.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac copilot extract-template

Trích xuất tệp mẫu từ một copilot hiện có trong môi trường.

Ví dụ:

Lệnh này trích xuất một tệp mẫu từ một copilot hiện có trong một môi trường.

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

Lệnh này trả về kết quả giống như sau đối với một bộ lái sao chép sử dụng ngôn ngữ Tiếng Anh và Tiếng Đức:

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

Tham số Bắt buộc cho copilot extract-template

--bot -id

ID Copilot hoặc tên sơ đồ (tên duy nhất được tìm thấy trong Chi tiết Bot hoặc tên tệp trong trình khám phá giải pháp).

--templateFileName

Vị trí của tệp yaml để ghi mẫu copilot vào.

Tham số Tùy chọn cho copilot extract-template

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--overwrite -o

Cho phép ghi đè tệp dữ liệu đầu ra nếu tệp đã tồn tại.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--templateName

Tên mẫu hoặc 'kickStartTemplate' nếu tên không được xác định.

--templateVersion

Phiên bản mẫu ở định dạng X.X.X hoặc 1.0.0 nếu phiên bản không được chỉ định.

pac copilot extract-translation

Trích xuất tệp chứa nội dung bản địa hóa cho một hoặc nhiều bot.

Ví dụ:

Lệnh này trích xuất một tệp chứa nội dung bản địa hóa cho một hoặc nhiều bản sao.

pac copilot extract-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --all `
   --outdir . `
   --format json

Lệnh này trả về kết quả như sau:

Connected as user@contoso.org

Loaded 32 components for bot 'New Test Copilot' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

Tham số Tùy chọn cho copilot extract-translation

--all -a

Ghi tệp bản địa hóa cho tất cả các ngôn ngữ được hỗ trợ. Theo mặc định, chỉ ngôn ngữ chính được viết.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--bot -id

ID Copilot hoặc tên sơ đồ (tên duy nhất được tìm thấy trong Chi tiết Bot hoặc tên tệp trong trình khám phá giải pháp).

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--format

Định dạng tệp để ghi các tệp đã bản địa hóa, 'resx' hoặc 'json'. Mặc định là 'resx'.

--outdir

Thư mục đầu ra để ghi vào.

--overwrite -o

Cho phép ghi đè tệp dữ liệu đầu ra nếu tệp đã tồn tại.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--sourcedir -src

Thư mục giải pháp nguồn. Khi được chỉ định, sẽ bỏ qua môi trường được kết nối khi tìm kiếm các bot và thay vào đó tìm kiếm nội dung trong thư mục giải pháp.

pac copilot init

Tạo không gian làm Copilot Studio tác nhân mới từ mẫu.

pac copilot initgiàn giáo một không gian làm Copilot Studio tác nhân mới từ một mẫu. Nó chạy ở một trong hai chế độ và sự hiện diện của quyết --environment định nên sử dụng chế độ nào:

• Giàn giáo cục bộ — không --environment. Ghi tệp mẫu vào thư mục dự án và dừng lại. Lệnh này không tạo bất kỳ thứ gì trong Dataverse và không yêu cầu đăng nhập. Sử dụng chế độ này khi bạn muốn biên soạn cục bộ và kết nối với môi trường sau này.
• Bootstrap — được cung --environment cấp. Giàn giáo các tập tin, gói chúng vào một giải pháp, nhập giải pháp đó vào môi trường, và kết nối không gian làm việc với các đại lý mới được tạo ra. Chế độ này là đường dẫn một bước từ không có gì đến tác nhân trực tiếp, sẵn sàng đồng bộ và yêu cầu hồ sơ đã xác thực.

Ví dụ

Giàn giáo một không gian làm việc cục bộ:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

Giàn giáo và khởi động một đại lý trực tiếp trong một môi trường trong một bước duy nhất:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

Giàn giáo một tác nhân CLI -authored (CliCopilot) vào một thư mục cụ thể:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

Tham số Bắt buộc cho copilot init

--name -n

Tên hiển thị của trợ lý.

--publisher-prefix -pp

Publisher tiền tố tùy chỉnh cho giải pháp.

Tham số Tùy chọn cho copilot init

--authoring-mode -am

Tác nhân tạo hình dạng giàn giáo (mặc định: 'cổ điển'). Sử dụng 'cli-copilot' để giàn giáo một tác nhân CliCopilot cliCopilot-tác giả.

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--instructions -ins

Hướng dẫn hệ thống trợ lý.

--project-dir -pd

Thư mục đích cho không gian làm việc của đại diện. Mặc định cho thư mục hiện tại.

--schema-name -sn

Tên sơ đồ tác nhân đầy đủ. Ghi đè phần phát sinh mặc định ({publisher-prefix}_{sanitized-name}). Được sử as-is không sửa đổi.

--template -t

Tên hồ sơ mẫu (mặc định, tối thiểu). Mặc định là 'mặc định'.

Nhận xét

• Thư mục dự án phải trống. init không giàn giáo trên các tệp hiện có, vì vậy hãy trỏ tới --project-dir một thư mục mới hoặc trống.
• Phát sinh tên sơ đồ. Khi bạn bỏ qua --schema-name, tên sơ đồ tác nhân được xây dựng là {publisher-prefix}_{sanitized-name}. Chuyển --schema-name để đặt nó một cách rõ ràng; giá trị được sử dụng as-is.
• Bootstrap hoạt động cho cả hai chế độ biên soạn. init --environment bootstraps một đại lý trực tiếp trong một bước cho chế độ mặc định cổ điển và cho --authoring-mode cli-copilot. Như một thay thế cho một đại lý CliCopilot, bạn có thể giàn giáo cục bộ (không --environment), pac copilot pack sau đó chạy theo sau để pac solution import triển khai nó cho mình.
• Bootstrap tạo ra các đối tượng phía máy chủ. Trong chế độ bootstrap, init nhập giải pháp và tạo tác nhân trong môi trường đích. Nếu một tác nhân có cùng tên sơ đồ đã tồn tại, initpac copilot clone hãy dừng và chỉ cho bạn kết nối với tác nhân hiện có thay vào đó.
• Một môi trường hoàn toàn mới có thể chậm để chấp nhận nhập khẩu đầu tiên. Môi trường mới tạo có thể mất một hoặc hai phút để làm nóng. Có thể không khởi động được chuỗi khởi động sớm với "Thao tác Không đồng bộ hiện đã bị vô hiệu hóa đối với tổ chức này". Chờ một chút và chạy lại lần nữa.
• --template (default hoặc minimal) chỉ áp dụng cho chế độ biên soạn cổ điển.

pac copilot list

Danh sách các bộ lái phụ trong môi trường Dataverse hiện tại hoặc đích.

Ví dụ:

Lệnh này liệt kê tất cả các bản sao trong môi trường Dataverse hiện tại hoặc đích.

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

Lệnh này trả về kết quả như sau:

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

Tham số Tùy chọn cho copilot list

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac copilot mcp

Thông tin về máy chủ MCP cục bộ (Giao thức Ngữ cảnh Mô hình).

Ví dụ:

pac copilot mcp --run

Tham số Tùy chọn cho copilot mcp

--run -r

Chạy máy chủ MCP cục bộ (Giao thức Ngữ cảnh Mô hình).

Tham số này không yêu cầu giá trị. Đó là công tắc.

Nhận xét

Tìm hiểu cách sử dụng Power Platform CLI với máy chủ MCP tích hợp sẵn

pac copilot merge-translation

Phối các tệp chứa nội dung đã bản địa hóa cho một hoặc nhiều bot.

Ví dụ:

Lệnh này phối các tệp có chứa nội dung bản địa hóa cho một hoặc nhiều bộ lái.

pac copilot merge-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --file ms_store_newTestCopilot.de-DE.json `
   --solution SolutionName

Lệnh này trả về kết quả như sau khi cập nhật ngôn ngữ tiếng Đức:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 0 key(s) were missing, 0 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

Tìm hiểu cách quản lý lỗi từ lệnh dịch phối

Tham số Tùy chọn cho copilot merge-translation

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--file -f

Danh sách các tệp có chứa bản dịch. Các mẫu glob được hỗ trợ.

--solution -s

Tên của giải pháp.

--sourcedir -src

Thư mục giải pháp nguồn. Khi được chỉ định, sẽ bỏ qua môi trường được kết nối khi tìm kiếm các bot và thay vào đó tìm kiếm nội dung trong thư mục giải pháp.

--verbose

Xuất thêm thông tin chẩn đoán trong quá trình nhập/xuất dữ liệu

Tham số này không yêu cầu giá trị. Đó là công tắc.

--whatif

Không thực hiện lệnh, nhưng xuất ra các chi tiết về những gì sẽ xảy ra.

Tham số này không yêu cầu giá trị. Đó là công tắc.

lỗi dịch phối

Dựa trên ví dụ ở trên, nếu một lỗi tồn tại trong tệp được sử dụng để cập nhật copilot, đầu ra sẽ trông giống như:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

Cờ --verbose thêm chi tiết về lỗi:

Connected as user@contoso.org

Missing translation key: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmond)'.DisplayName.

Unused translation: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmont)'.DisplayName, value: Redmond

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

pac copilot model list

Mô hình Ai Builder trong môi trường hiện tại.

Ví dụ:

Lệnh này liệt kê tất cả các mô hình Bộ dựng AI.

pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

Lệnh này trả về kết quả như sau:

Id                                   State    Name
32a9e265-1149-4155-af54-d2856d2b83f5 Active   Document Processing 2023/09/20, 12:21:40
2bcd7b94-50bc-4767-af4a-367c63fb5487 Inactive AI Classify
4e72b59a-17d6-451e-8657-89fbdec56d7a Inactive AI Extract
572f57a7-7a8f-49fc-adb4-331e02c509a6 Inactive AI Reply
b9b636cf-9748-47a7-b617-6df5f00f5151 Inactive AI Sentiment
c076eac8-f218-4feb-8ad1-7ee4fb039419 Inactive AI Summarize
a0440df3-2656-e911-8194-000d3a6cd5a5 Inactive BusinessCard model
62d1e848-5ca7-490a-94bf-79baabe85ef4 Inactive CategoryClassification model
4da7ec17-5c26-4fd2-9ddb-be4f7eda21a9 Inactive DataGenieEmailAddressValidation
51f4da11-5702-401d-b53a-9638744e8ac9 Inactive Document Layout Analysis Model
d1bb8d57-24ab-3b36-9592-bd792e153b79 Inactive DVCopilotQueryModel
3fbd4e5c-32bc-40fc-acce-59c2821cf113 Inactive Empty Dynamic Prompt
8c281981-c5d6-484f-bac7-4924ddd0b8ae Inactive EntityExtraction model
a1afa5d4-7a44-4c31-9cd2-e852a78431fa Inactive GptPromptEngineering model
2c444168-f8b1-4c6a-9313-2d9c03be6fea Inactive Id Scanning Model
77365cfa-7021-4cb7-a9b2-dc9823cde772 Inactive ImageDescription model
aef1bdd2-2a74-4f74-b4eb-9dfa22e35ded Inactive Invoice Model
5ed4d0fd-e9d4-4026-b09b-71f83ea90c60 Inactive Invoice Processing Model
c8425db7-c5a7-4226-b38e-c93a044c0fe1 Inactive KeyPhraseExtraction model
17a6f893-5b0b-4867-8fac-fb2eda9080b2 Inactive LanguageDetection model
046ab801-2756-e911-8194-000d3a6cd5a5 Inactive ObjectDetectionProposal model
892d3698-ba03-3d15-8e9e-843ca4ac5e7d Inactive PowerAppsAppCopilotModel
baa44529-bebe-49e6-837a-80bee63b0d2c Inactive Receipt Scanning Model
f1c549c2-a97e-47a5-b612-c5c2bab0f163 Inactive SentimentAnalysis model
7f8a7856-003a-3662-9871-0000d7674433 Inactive SimsModel
86419a67-205a-454f-b6fc-601394f2786d Inactive TextRecognition model
6225038a-8b5a-4913-bfd2-d8236f4102ba Inactive TextTranslation model
02e1fca3-232a-4f58-8c93-bdd8c9cd6de9 Inactive TextTranslationInternal model

Tham số Tùy chọn cho copilot model list

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac copilot model predict

Gửi văn bản hoặc lời nhắc đến Mô hình AI

Tham số Tùy chọn cho copilot model predict

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--model-id -id

Id mô hình Bộ dựng AI

--model-name -n

Tên Mô hình AI đầy đủ hoặc một phần

--prompt -p

Nhắc gửi đến Mô hình AI

--text -t

Văn bản để gửi đến Mô hình AI

pac copilot model prepare-fetch

Lấy tệp FetchXML từ Mô hình Ngôn ngữ Lớn AI (LLM) và chuẩn bị tệp để thực thi đối với môi trường hiện tại.

Tham số Bắt buộc cho copilot model prepare-fetch

--inputFile -i

Tệp FetchXML đầu vào thường đến từ AI LLM.

--outputFile -o

Tệp FetchXML Đầu ra đã sẵn sàng để thực thi đối với môi trường hiện tại.

Tham số Tùy chọn cho copilot model prepare-fetch

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac copilot pack

Đóng gói một Copilot Studio việc tác nhân vào một tệp zip giải pháp.

pac copilot pack gói một không gian làm việc đại lý vào một giải pháp Dataverse .zip mà bạn có thể triển khai với pac solution import. Đó là pac copilot init --environment dạng độc lập của bước đóng gói chạy cho bạn, vì vậy bạn có thể tạo giải pháp có thể triển khai dưới dạng một bước riêng biệt — ví dụ: trong quy trình xây dựng. Nó hoạt động cho cả không gian làm việc cổ điển và tác giả CLI (CliCopilot).

Ví dụ:

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

Tham số Bắt buộc cho copilot pack

--publisher-prefix -pp

Publisher tiền tố tùy chỉnh cho giải pháp.

Tham số Tùy chọn cho copilot pack

--output-path -op

Đường dẫn đầu ra cho tệp zip giải pháp. Mặc định cho thư mục hiện tại.

--project-dir -pd

Thư mục không gian làm việc tác nhân để đóng gói. Mặc định cho thư mục hiện tại.

--solution-name -sn

Tên duy nhất của giải pháp. Nếu bị bỏ qua, bắt nguồn từ tên sơ đồ tác nhân.

Nhận xét

• Đó là một hoạt động cục bộ. Gói đọc không gian làm việc và viết một giải pháp .zip. Nó không cần xác thực và không cần môi trường, vì vậy nó an toàn để chạy trong một quy trình xây dựng.
• Tiền tố nhà phát hành phải hợp lệ. --publisher-prefix phải là một tiền tố tùy chỉnh được hình thành tốt, hoặc gói dừng lại trước khi viết bất cứ điều gì.
• Tên và đầu ra giải pháp. Nếu bạn bỏ qua --solution-name, tên duy nhất của giải pháp được bắt nguồn từ tên sơ đồ tác nhân. Được .zip viết vào thư mục hiện tại, trừ khi bạn đặt --output-path.
• Gói không triển khai. Nó tạo ra giải pháp nhưng không nhập nó. Thực hiện theo để triển pac solution import khai tác nhân, sau đó pac copilot clone nếu bạn muốn có không gian làm việc được kết nối đồng bộ cho tác nhân đó.

pac copilot publish

Phát hành Một Bản sao chép Tùy chỉnh

Tham số Bắt buộc cho copilot publish

--bot -id

ID Copilot hoặc tên sơ đồ (tên duy nhất được tìm thấy trong Chi tiết Bot hoặc tên tệp trong trình khám phá giải pháp).

Tham số Tùy chọn cho copilot publish

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

pac copilot pull

Kéo các thay đổi từ xa Copilot Studio kết hợp với không gian làm việc cục bộ.

Lệnh pac copilot pull sẽ lấy trạng thái máy chủ hiện tại của tác nhân và sáp nhập nó vào không gian làm việc cục bộ của bạn bằng cách sử dụng phối ba chiều. Quá trình này đảm bảo rằng các chỉnh sửa phía máy chủ và các tệp cục bộ không bị ảnh hưởng của cả hai đều giữ nguyên. Chạy nó trước khi bạn bắt đầu chỉnh sửa và chạy lại nó trước khi bạn đẩy các thay đổi của bạn.

Ví dụ:

Chạy lệnh từ bên trong thư mục không gian làm việc:

pac copilot pull

Hoặc trỏ vào không gian làm việc ở nơi khác trên đĩa:

pac copilot pull --project-dir contoso-support

Tham số Tùy chọn cho copilot pull

--project-dir -pd

Đường dẫn đến thư mục dự án. Mặc định cho thư mục làm việc hiện tại.

Nhận xét

• Chạy ứng dụng này bên trong không gian làm việc đồng bộ. Lệnh pull này chỉ hoạt động trong thư mục được tạo bởi pac copilot clone hoặc pac copilot init. Nó đọc môi trường đích và tác nhân từ siêu dữ liệu đồng bộ của không gian làm việc, đó là lý do tại sao không có đối --environment số. Nếu bạn chạy nó bất cứ nơi nào khác, nó không thành công với một lỗi "không gian làm việc không tìm thấy".
• Nó ghi vào các tập tin cục bộ của bạn. Kéo kết hợp các thay đổi từ xa vào không gian làm việc và tải xuống các tệp kiến thức. Cam kết hoặc sao lưu công việc địa phương mà bạn quan tâm trước khi kéo.
• Đăng nhập lần đầu tiên bằng pac auth create.

pac copilot push

Đẩy các thay đổi không gian làm việc cục bộ Copilot Studio.

pac copilot push gửi những thay đổi trong không gian làm việc cục bộ của bạn trở lại tác nhân trong Dataverse. Nó so sánh các tệp của bạn với trạng thái máy chủ được biết đến gần đây nhất, chỉ tải lên những thay đổi - bao gồm tệp kiến thức, dòng đám mây và tham chiếu kết nối - và báo cáo những gì nó đã đẩy.

Ví dụ:

Chạy ứng dụng từ bên trong thư mục không gian làm việc:

pac copilot push

Hoặc trỏ vào không gian làm việc ở nơi khác trên đĩa:

pac copilot push --project-dir contoso-support

Tham số Tùy chọn cho copilot push

--project-dir -pd

Đường dẫn đến thư mục dự án. Mặc định cho thư mục làm việc hiện tại.

Nhận xét

• Chạy ứng dụng này bên trong không gian làm việc đồng bộ. Giống như pull, push chỉ hoạt động trong thư mục được tạo bởi pac copilot clone hoặc pac copilot init. Nó đọc môi trường đích từ siêu dữ liệu đồng bộ của không gian làm việc. Không có lý do gì --environment cả.
• Trước hết, nếu có xung đột xảy ra. Nếu cùng một mục thay đổi cả cục bộ và trên máy chủ, hãy nhấn dừng và yêu cầu bạn chạy trước khi pac copilot pull thử lại. Quá trình này giúp đẩy không cho âm thầm ghi đè lên thay đổi phía máy chủ mà bạn không nhìn thấy.
• Không có thay đổi cục bộ nào là no-op. Nếu push không tìm thấy gì để gửi, nó báo cáo rằng và thoát ra mà không cần chạm vào môi trường.
• Một đẩy thành công đột biến các đại lý sống trong môi trường mục tiêu.
• Đăng nhập lần đầu tiên bằng pac auth create.

pac copilot quarantine

Tình trạng cách ly của đại lý cơ phó

Tham số Bắt buộc cho copilot quarantine

--bot-id -id

ID của phi công phụ để cách ly/không cách ly.

Tham số Tùy chọn cho copilot quarantine

--environment -env

Môi trường (ID, ID tổ chức, url, tên duy nhất hoặc một phần tên).

--status -s

Giá trị trạng thái cách ly. true = cách ly, false = không cách ly. Mặc định là true.

Tham số này không yêu cầu giá trị. Đó là công tắc.

pac copilot status

Bỏ phiếu trạng thái triển khai của một bộ lái được chỉ định trong môi trường Dataverse hiện tại hoặc đích.

Ví dụ:

Lệnh này kiểm tra trạng thái triển khai của một bộ lái được chỉ định trong môi trường Dataverse hiện tại hoặc đích.

pac copilot status `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e

Lệnh này trả về kết quả như sau:

Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.

Tham số Bắt buộc cho copilot status

--bot-id -id

ID của một phi công lái (Chatbot).

Tham số Tùy chọn cho copilot status

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

Xác thực và môi trường cho các lệnh đồng bộ

, clone, pullvà pushcác lệnh tất cả init --environment nói chuyện với một môi trường Dataverse, vì vậy họ cần một hồ sơ xác thực. Đăng nhập lần đầu tiên bằng pac auth create.

• clone, pullvà yêu cầu push hồ sơ hiện hoạt. pac copilot init chỉ cần một khi bạn vượt qua --environment; không có nó, init giàn giáo tập tin cục bộ và không cần đăng nhập.
• pull và push đọc môi trường đích từ siêu dữ liệu đồng bộ của không gian làm việc để chúng không tham --environment đối. clone và init làm.
• pac copilot pack hoàn toàn là địa phương. Nó chỉ đọc và ghi tệp, do đó, nó không cần xác thực và không có môi trường.

pull và chỉ push làm việc bên trong một không gian làm việc được tạo bởi clone hoặc init. Siêu dữ liệu đồng bộ được viết khi không gian làm việc được tạo là thông tin cho họ biết cần nói chuyện với tác nhân và môi trường nào, vì vậy việc chạy chúng ở bất kỳ nơi nào khác không thể nhanh chóng với lỗi "không gian làm việc không tìm thấy".

Xem thêm

Microsoft Power Platform lệnh CLI
Microsoft Power Platform tổng quan về CLI