Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Apa yang dapat dilakukan asisten Anda dengan Aggrega

Setelah asisten Anda terhubung ke server MCP Aggrega, asisten bekerja dengan binary aggrega yang sama yang akan Anda jalankan di terminal: membaca skema dan dokumentasi, menyusun draf dan memeriksa file Anda, membangun Release, dan, jika Anda mengizinkannya, menerbitkan. Halaman ini menjelaskan cakupannya, dalam kelompok-kelompok. Jawaban server itu sendiri adalah daftar lengkapnya, dan itulah yang patut dipercaya: panggil describe-capabilities tanpa argumen, atau minta asisten Anda melakukannya, dan server akan mencantumkan setiap alat yang ditawarkannya kepada Anda, masing-masing dengan tujuan satu baris, jenis entitas yang dilayaninya, dan apakah alat itu menulis. Kompatibilitas menyatakan apa saja yang dapat diubah oleh sebuah rilis pada alat-alat tersebut.

Membaca skema dan dokumentasi

Server menyajikan materi referensi yang dibaca asisten sebelum menulis YAML: JSON Schema suatu entitas (schema://<kind>), halaman referensi bahasa mana pun (langref://<path>), panduan penulisan (authoring://<topic>), YAML yang ditulis untuk suatu entitas katalog (catalog://<kind>/<name>), dan bantuan perintah apa pun (cli://<command>). Skema dibangun ke dalam binary, dan halaman berasal dari salinan dokumentasi yang disimpan server di cache mesin Anda. Apa yang dilakukannya mencantumkan setiap keluarga.

Mengambil peran, atau mengikuti alur kerja

Prompt penulisan membingkai asisten sebagai developer, arsitek, atau penulis operasi, atau memfokuskannya pada satu jenis entitas, sehingga sarannya tetap dalam lingkup yang ditulis peran tersebut. Prompt alur kerja menguraikan urutan panggilan untuk tujuan yang memerlukan beberapa panggilan: menyusun Aggregate baru beserta Release-nya, membawa chart, modul infrastruktur, atau file Compose yang sudah ada ke dalam Aggrega, atau mencari tahu mengapa build gagal. Klien Anda mencantumkannya sebagai prompt server.

Mengetahui isi ruang kerja

list-entities dan list-releases menyebutkan apa yang ada di ruang kerja Anda dan berapa banyak, lalu menyerahkan catatan satu halaman setiap kali; describe menampilkan satu entitas atau segala sesuatu yang dijangkau suatu Release; config-show melaporkan konfigurasi yang berlaku dan asal setiap pengaturan. Server juga melaporkan cache, registry yang dikonfigurasi, dan plugin yang di-resolve-nya. Lihat Mengetahui isi ruang kerja.

Menyusun draf dan memeriksa file Anda

scaffold menyusun draf dokumen awal untuk suatu jenis entitas, berisi field yang diwajibkan jenis tersebut, atau menulis salah satu contoh yang dapat dijalankan dari dokumentasi ke direktori baru. get-schema mengembalikan JSON Schema suatu jenis, validate memeriksa draf dan menyebutkan setiap placeholder yang masih ada di dalamnya, lint memeriksa konvensi penerbitan katalog, dan explain-error menguraikan diagnostik menjadi perbaikan yang dibutuhkannya. Alat-alat lain menjawab pertanyaan yang muncul saat mengedit: Features mana yang dapat dilampirkan ke suatu komponen dan apa yang dapat dihubungkannya, di mana entri baru seharusnya berada dalam file, dan satu suntingan terbatas yang diterapkan pada dokumen, dengan setiap byte yang tidak disentuhnya tetap seperti semula. Lihat Menanyakan apa yang dapat dilampirkan, dan apa yang dapat terhubung ke apa dan Menerapkan satu suntingan terbatas pada dokumen.

Me-resolve dan membangun Release

pull me-resolve dependensi suatu Release ke dalam cache dan menulis lockfile-nya, dan build merender Release menjadi artefaknya, di memori secara default atau ke dist/ di root ruang kerja ketika asisten memintanya untuk menuliskannya. Build yang ditolak mengembalikan diagnostik yang menyebutkan apa yang harus diperbaiki. Lihat Me-resolve dependensi suatu Release dan Membangun terhadap konten yang sudah di-pin oleh suatu Release.

Membawa masuk proyek dari alat lain

import membaca deskripsi yang dihasilkan alat lain dan menulis draf file Aggrega ke ruang kerja untuk Anda tinjau. Lihat Mengubah deskripsi asing menjadi draf entitas dan aggrega import untuk format yang dibacanya.

Menerbitkan, menandatangani, dan menarik

Empat alat menempatkan entitas atau artefak di registry, menandatangani apa yang diterbitkan di sana, atau menariknya dengan penanda bertanda tangan. Perubahan yang dibuatnya menjangkau semua orang yang me-resolve dari registry tersebut, dan tidak satu pun dapat ditarik kembali dari seseorang yang sudah memilikinya, jadi inilah alat yang perlu dipertimbangkan sebelum Anda mengizinkannya. Lihat Menerbitkan, menandatangani, dan menarik.

Menjalankan perintah apa pun

Untuk klien yang memulai server di mesin Anda sendiri, melalui input dan output standar, server juga menawarkan alat untuk setiap perintah yang dapat Anda ketik, yang dinamai sesuai perintah tersebut: cli-build menjalankan aggrega build, cli-validate menjalankan aggrega validate, dan seterusnya. Server yang dijangkau melalui HTTPS tidak menawarkan satu pun dari alat tersebut.

Apa yang dapat dilakukannya tanpa bertanya kepada Anda

Asisten yang terhubung melalui input dan output standar dapat memanggil setiap alat yang ditawarkan server tanpa bertanya kepada Anda, kecuali klien Anda diatur untuk menolaknya. Di klien Anda-lah Anda mengizinkan dan menolak alat berdasarkan nama. Apa yang dapat dilakukan asisten tanpa bertanya kepada Anda terlebih dahulu menyebutkan operasi yang menjangkau di luar ruang kerja Anda, dan Mempersempit apa yang diumumkan server memperpendek daftar alat jika klien Anda tidak dapat menerima semuanya.