コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

アシスタントが Aggrega でできること

アシスタントを Aggrega MCP サーバーに接続すると、ターミナルで実行するのと同じ aggrega バイナリを使って作業します。スキーマとドキュメントを読み、ファイルの下書きを作成して検査し、Release をビルドし、許可すれば公開も行います。このページでは、その範囲をグループごとに説明します。完全な一覧はサーバー自身の回答であり、信頼すべきはそちらです。describe-capabilities を引数なしで呼び出すか、アシスタントに呼び出しを依頼すると、サーバーが提供するすべてのツールが、1 行の用途説明、対象とするエンティティ種別、書き込みを行うかどうかとともに一覧表示されます。互換性では、リリースによってツールの何が変更されうるかを説明しています。

スキーマとドキュメントを読む

サーバーは、アシスタントが YAML を書く前に読むリファレンス資料を提供します。エンティティの JSON Schema(schema://<kind>)、言語リファレンスの任意のページ(langref://<path>)、オーサリングガイド(authoring://<topic>)、カタログエンティティのオーサリング済み YAML(catalog://<kind>/<name>)、任意のコマンドのヘルプ(cli://<command>)です。スキーマはバイナリに組み込まれており、ページはサーバーがマシンのキャッシュに保持するドキュメントのコピーから提供されます。すべてのファミリーは動作内容に一覧があります。

ロールを担う、またはワークフローに従う

オーサリングプロンプトは、アシスタントを開発者、アーキテクト、または運用担当の作成者として位置づけるか、1 つのエンティティ種別に集中させ、提案がそのロールの書く範囲に収まるようにします。ワークフロープロンプトは、複数の呼び出しを要する目標について呼び出しの順序を示します。新しい Aggregate とその Release の作成、既存の chart、インフラストラクチャモジュール、Compose ファイルの Aggrega への取り込み、ビルドが失敗する理由の調査などです。クライアントはこれらをサーバーのプロンプトとして一覧表示します。

ワークスペースの内容を調べる

list-entities と list-releases はワークスペースに何がどれだけあるかを示し、その後レコードを 1 ページずつ渡します。describe は 1 つのエンティティ、または Release が到達するすべてを表示します。config-show は有効な設定と、各設定の由来を報告します。サーバーはキャッシュ、設定済みのレジストリ、解決するプラグインも報告します。ワークスペースの内容を調べるを参照してください。

ファイルの下書きを作成して検査する

scaffold はエンティティ種別のスターター文書を、その種別に必須のフィールドを含めて下書きするか、ドキュメントの実行可能な例の 1 つを新しいディレクトリに書き出します。get-schema は種別の JSON Schema を返し、validate は下書きを検査して残っているすべてのプレースホルダーを指摘し、lint はカタログの公開に関する慣例を検査し、explain-error は診断を必要な修正内容に展開します。ほかのツールは、編集中に生じる疑問に答えます。どの Features をコンポーネントにアタッチでき、そのコンポーネントが何に接続できるか、新しいエントリをファイルのどこに置くべきか、そして文書に範囲を限定した 1 つの編集を適用し、触れないバイトはすべてそのまま保つことです。何をアタッチでき、何が何に接続できるかを問い合わせると文書に範囲を限定した 1 つの編集を適用するを参照してください。

Release を解決してビルドする

pull は Release の依存関係をキャッシュに解決してロックファイルを書き出し、build は Release を成果物にレンダリングします。既定ではメモリ内で行い、アシスタントが書き出しを求めた場合はワークスペースのルートにある dist/ に書き出します。拒否されたビルドは、何を修正すべきかを示す診断を返します。Release が依存するものを解決するとRelease がすでに固定しているコンテンツに対してビルドするを参照してください。

別のツールからプロジェクトを取り込む

import は別のツールが生成した記述を読み、レビュー用の Aggrega の下書きファイルをワークスペースに書き出します。読み取れる形式については、外部の記述を下書きエンティティに変換すると aggrega import を参照してください。

公開、署名、取り下げ

4 つのツールが、エンティティや成果物をレジストリに置き、そこで公開されたものに署名し、または署名付きのマーカーで取り下げます。これらによる変更は、そのレジストリから解決するすべての人に及び、すでに入手した人から取り戻すことはできません。したがって、これらは許可する前によく検討すべきツールです。公開、署名、取り下げを参照してください。

任意のコマンドを実行する

自分のマシン上で標準入出力を介してサーバーを起動したクライアントには、入力できる各コマンドについて、そのコマンドにちなんだ名前のツールもサーバーが提供します。cli-build は aggrega build を、cli-validate は aggrega validate を実行する、といった具合です。HTTPS 経由で接続するサーバーは、これらをいずれも提供しません。

確認なしで実行できること

標準入出力で接続したアシスタントは、クライアントで拒否するよう設定していない限り、サーバーが提供するすべてのツールを確認なしで呼び出せます。ツールを名前で許可・拒否するのはクライアント側です。アシスタントが事前の確認なしに実行できることではワークスペースの外に及ぶ操作を挙げており、サーバーが公開する内容を絞り込むでは、クライアントがすべてを受け付けない場合にツール一覧を短くできます。