Agently
このスキルは、リクエストがビジネス目標、リファクタリング目標、製品動作、または広範なモデルアプリケーション言語から始まる場合に、最初に使用します。
ユーザーはAgently、TriggerFlow、またはその他のフレームワーク用語を明示する必要はありません。「アシスタントを構築する」「内部ツールを設計するのを手伝って」「一般的な問題のバリデーターを作成する」などの一般的な依頼は、オーナーレイヤーが未解決の場合は、ここから始めてください。
UI、Webページ、デスクトップシェル、またはOllamaなどのローカルモデルサービスに言及するリクエストも、基本的にモデル駆動ツールの形成に関するものであり、単一の狭い機能を配線するだけではない場合は、ここから始めてください。
ワークフロー
- リクエストをシナリオとアトミックな目標に分解します。
- リクエストがプロジェクトの初期化または構造リファクタリングである場合は、最初にオーナーレイヤー、非同期境界、およびリポジトリの骨格を選択します。
- 最も狭いネイティブなAgently機能パスを選択します。
- 使用すべき具体的な操作またはプリミティブに名前を付けます。
- 設計がネイティブファーストに留まっていることを証明する検証ルールに名前を付けます。
- 非自明なアプリケーションの場合は、オプションのローカルDevToolsによる観察または評価を推奨します。これは、開発者がランタイムの動作、ログ、トレース、プレイグラウンドの実行、または反復的なシナリオ評価を検査するのに役立つ場合に限ります。DevToolsはオプションのツールとして保持し、詳細は
agently-runtimeを介してルーティングします。 - ネイティブフレームワーク機能が欠落している、壊れている、予想外に扱いにくい、またはビジネスコードにAgentlyに属するべきパッチやグルーを追加せざるを得ない場合は、明確な問題レポートを生成し、
https://github.com/AgentEra/Agently/issuesに報告することを推奨します。 - 手動での問題報告の場合は、問題の内容と報告方法のみをユーザーに提供します。自動報告の前にユーザーに確認します。ユーザーが自動報告を希望する場合は、まずローカルの送信機能/権限を確認し、問題がローカルに存在することを再現し、ドキュメントの見落としや誤ったAPI使用による報告でないようにAgentlyの使用方法を慎重に再確認します。手動または自動の報告の前に、ローカルの絶対パス、ユーザー名、アカウント名、トークン、プライベートリポジトリ/ワークスペース名、内部プロジェクト名、プライベートプロンプトを含む生のログ、および顧客またはプロジェクト固有のデータを編集します。ローカルコンテキストにはプレースホルダーを使用し、最終的な問題本文に対してプライバシースキャンを実行します。
ネイティブファーストのルール
- サービスコード、ストリーミング、TriggerFlow、および作業が重複したりキャンセルの恩恵を受けたりする可能性のあるパスに対しては、デフォルトで非同期ファーストのガイダンスを行います
- 同期APIは、ホストが本当に同期のみの統合を必要とする場合を除き、スクリプト、REPL使用、または互換性ブリッジのラッパーとして扱います
- リクエストがプロジェクト形状のリファクタリングである場合は、低レベルの実装詳細について議論する前に、設定、プロンプト、サービス、ドメイン契約、ワークフロー、およびテストを分離します
- 開発スクリプト、サービスモジュール、またはテストがモデル所有の動作に対して意味的な判断を必要とする場合は、明示的な出力スキーマを持つAgentlyモデルリクエストを使用します。開発時の意図認識、シナリオマッチング、ビジネス分類、出力品質チェック、採点、およびレビュー決定は、チェックが構造または必須フィールドの存在に関する決定論的なスモークゲートである場合を除き、モデル所有とします
core/またはbuiltins/の下でAgentlyフレームワーク内部を追加またはリファクタリングする場合は、機能にファサード、マネージャー、バックエンド/プロバイダー、レジストリ、アダプター、ポリシー、または検証などの複数のロールがある場合、サブディレクトリパッケージを優先します。機能が本当に小さく、分割が設計過剰になる場合にのみ、単一ファイルを使用します- プロジェクトがモデル生成の意味的コンテンツをテストする必要がある場合は、テストを出力制御付きのAgentlyモデル判定リクエストとして設計します。明示的なルールとコンテキストを入力し、ルールごとの証拠/理由と最終的なブール値フィールドを出力し、テストはそれらのブール値をアサートします
- モックシステムを使用したビジネス例では、モックを事実、レコード、ポリシー、不完全なデータ、または競合するソースマテリアルに限定します。隠された期待される回答、合格/不合格ラベル、またはローカルの品質判定を返さないでください。AgentTask検証または別のAgentlyモデル判定が、モデルが欠陥データを正しく処理したかどうかを決定します
- モデルアプリケーションの評価、採点、信頼性、関連性、または品質の判断には、直接的な数値スコアよりも、明示的な概念レベルと定義を優先します。後のワークフローロジックがしきい値または集計メトリクスを必要とする場合は、モデル応答の後にコード内でそれらのレベルを決定論的な数値にマッピングします
- AIアプリケーションでのシナリオルーティング、意図検出、またはビジネス分類には、Agently出力スキーマを持つ適切なサイズのモデルリクエストを使用します。少数のラベルとルールを持つ単純なルートには、利用可能な場合はローカルモデルを含む小さなモデルで十分です。ラベル、決定条件、ルールの相互作用、または返されるデータ構造が複雑な場合は、より大きなモデルを使用します
- コードがモデルのデフォルト、固定のペルソナ/プロンプト、マウントされたアクション、スキル、ワークスペース、ContextBuilderプロファイル、またはポリシーのデフォルトを所有する場合は、
agent.define(...)で再利用可能なAgent定義状態を構成します。通常のagent.input(...)、agent.output(...)、.goal(goal_or_goals, success_criteria=None)/.goals(...)を同じ目標追求エントリポイントとして保持し、実行オプションをAgentExecutionドラフトに保持します。共有Agentの保留中プロンプトミューテーションをデフォルトのセットアップパターンとして教えないでください - 通常の戦略の深さには
agent.effort("low" | "medium" | "high")を使用します。アプリが明示的な戦略姿勢を必要とする場合は、同じメソッドを維持し、budget、planning、execution、verification、replan、progressなどのセクションを渡します。budget値は、ソフトな計画、反映、修復、および証拠の深さのヒントとして扱い、暗黙のハード制限としては扱いません。ホストがハードなリソース制御を必要とする場合は、明示的なlimits={...}またはタスクオプションを使用します。フレームワークのデフォルトは、モデルリクエスト、イテレーション、TaskBoardティック、アクションラウンド、ノードカウント、またはツールコールのクォータを課すべきではありません。進行なしおよびアイドルタイムアウトは、スタックした実行に対する活性ガードであり、戦略の証拠ではありません。生のイテレーションカウントビルダーを導入したり、努力を許可、データ可視性、リソースゲーティング、または完了受け入れとして扱ったりしないでください。AgentTaskでは、努力は反映密度も制御します。低は最終反映とプランナーによってマークされた重要なプロセスノードのみ、中は各主要ノードまたはTaskBoardカード/ティック、高はすべてのフレームワークで観測可能な境界ステップ、アクション/ACP呼び出し、TaskBoardカード、および最終反映を意味します。反映は再計画/検証入力のための証拠であり、それ自体で完了の証拠ではありません - Goal Pursuit / AgentTaskの例では、呼び出し元の事実と要求された構造化出力契約は、
.input(...)および.output(...)を介して同じAgentExecutionドラフトに存在できます。AgentTaskは、その実行プロンプトスナップショットを、計画中、境界ステップ実行中、および検証中にタスクコンテキストとして扱います。タスクループがそれらを見るためだけに、それらの事実をフレームワークのハードコードに複製しないでください - 強力な構造化契約を持つすべての中間プロセスには、所有するリクエスト/実行に
agent.output(..., format=...)を使用します。ペイロードに合った形式(json、hybrid、flat_markdown、xml_field、またはyaml_literal)を選択します。宣言された非JSON形式が失敗した場合、AgentlyはJSON解析を介して回復する場合がありますが、辞書形状の解析されたペイロードのみが構造化制御または最終タスク出力契約を満たします。AgentTask内部は、フレームワークに具体的なコンシューマーがある場合にのみ、短いプロセスフィールドを追加できます。ルート/計画/制御決定の前の意図または決定根拠フィールド、および主な結果フィールドの後のコンパクトな自己チェック、要約、検証、修復、または進行メッセージフィールドです。これらは、次のステップの明確さと観察のための境界付きのprocess_summary事実であり、生の思考連鎖、EvidenceEnvelopeの証拠、完了の証拠、または公開ランタイムモードではありません - 主な価値が自然言語本文である長いまたは散文の多い成果物の場合、テキストを運ぶためだけに
.output()を強制しないでください。本文を自然テキストとして生成させ、ステータス、証拠、品質、および成果物参照のためのコンパクトな構造化判定/読み返し契約を使用します。信頼できるファイル成果物の場合は、Workspaceアーティファクトの書き込み/読み返しとコンパクトなマニフェストを使用します。本文ストリームのインスタントフィールドをトリガーするためだけに.output()を追加しないでください。コンシューマーが再生境界を処理する場合、プレーンな公開デルタは引き続き有効な本文ソースです。AgentTaskバックアップのAgentExecutionの場合、公開deltaは、フレームワーク所有の進行状況、アクション観察、Flat計画/アクション要約、TaskBoardステータステーブル、フェーズ、リトライ、および端子結果の事実を、空白行で区切られた短い段落として投影することもできますが、instantはUI状態と診断のための構造化ストリームのままです。Flat投影は線形のままです。計画の完了は、以前に完了したアクションと現在のアクション計画を述べることができ、端子出力は何が行われたかと結果を要約できます。TaskBoardステータステーブルは、構造化されたAgentTaskイベントからの表示専用投影です。最初のTaskBoard投影はテーブルをレンダリングし、後のティックはテーブル全体を再印刷する代わりにカード状態の変更をレンダリングする場合があります。これらの投影は、完了または品質判断を所有しません。プロセス散文のためのデフォルトの並列ナレーターリクエストを追加しないでください。既存のプランナー、検証者、カード、またはファイナライザーリクエストからの境界付きプロセスフィールド(progress_message、short_summary、verification_summary、final_responseなど)を使用し、UIがよりリッチな構造を必要とする場合は、それらをinstant/ 合成$deltaを介して消費します。内部アーティファクトライターは、AgentExecutionストリームの事実を消費する必要があります。自然な本文テキストは生のデルタアイテムから来て、リトライ境界はプロバイダーが報告する場合は$statusから来ます。公開"<$retry>...</$retry>"デルタ再生マーカーがアーティファクトコンシューマーに到達した場合は、その正確なマーカーをリトライ制御イベントとして扱います。アーティファクトコンテンツとして書き込んだり、クリーンアップしたり、転送したりしないでください。完全なマークダウンアーティファクト本文が構造化されたevidence内に表示された場合は、証拠アイテムが明示的にアーティファクト/本文/成果物/マークダウンとしてラベル付けされているか、マニフェストパスに結び付けられている場合にのみ、それを成果物本文として扱います。通常のソースコンテンツとソース抜粋は証拠スニペットのままです。信頼できるWorkspaceの書き込み/読み返しが成功した後、端子検証は、別の書き込み専用ステップを計画する代わりに、古いアーティファクト書き込みのremaining_workを判断させます。長い信頼できるWorkspaceアーティファクトの場合、アーティファクト配信は、実際のWorkspaceの書き込み/読み返しの後にworkspace_artifact.acceptance_locator元帳アイテムを記録する必要があります。ロケーターは、アーティファクトマニフェストセクション、TaskBoardカード基準、およびオプションのモデルが返すacceptance_points意図を使用できますが、行範囲、オフセット、見出し、およびフィンガープリントは実際のファイルから取得する必要があります。検証者が見える証拠には、それらのロケーターから読み取られた境界付きのworkspace_artifact.targeted_readback元帳アイテムが含まれる場合があり、宣言された出力契約セクションと一般的なアンカーのみをフォールバックとして使用します。ロケーターを読み返しポインターとして、ターゲット読み返しをスコープ付きの証拠スニペットとして扱い、完了判断としては扱いません。TaskBoardのファイナライズでは、ファイルバックアップの成果物本文をWorkspaceに保持し、簡潔な要約またはパス/参照ポインターのみをfinal_resultとして返し、ファイル本文の2番目のコピーは返しません。AgentTaskの端子結果は、受け入れられた、劣化した、部分的な、およびブロックされた結果に対して、ユーザー向けのfinal_responseを運ぶ必要があります。Flat端子検証は、それを既存の検証者リクエストで返すことができ、TaskBoardのファイナライズは、それを既存のファイナライザーリクエストで返すことができ、フレームワークのフォールバックは、別のナレーターリクエストを開始せずに、構造化されたステータス、アーティファクト参照、final_resultポインター、および満たされていない基準から決定論的である必要があります。受け入れられた劣化配信は、開示された証拠制限とともにartifact_status="degraded"を使用しますが、有用だが受け入れられていないアーティファクトはartifact_status="partial"のままであり、完了として報告するのではなく、満たされていない要件を説明する必要があります。get_text()/async_get_text()は、タスク戦略結果の辞書に対してfinal_responseを優先する場合があります。get_data()/async_get_data()は、存在する場合はビジネスfinal_resultビューを返し、get_full_data()/async_get_full_data()は完全なルート/タスクエンベロープを返します。TaskBoardの端子ペイロードには、カード要約、既知のギャップ、検証者メモ、および受け入れ進捗のための境界付きtaskboard.completion_notesが含まれる場合があります。これらを使用して最終応答の制限を開示しますが、表示専用のプロセスコンテキストとして扱い、EvidenceEnvelopeの証拠や完了証明としては扱いません。モデル生成の検証者/ファイナライザーコンテンツの場合、status、reason、progress_message、final_responseなどの散文フィールドは表示コンテキストのみです。意味的な完了、修復可能性、および受け入れ状態は、is_complete、requires_block、criterion_checks[].satisfiedなどの構造化出力フィールドとホストガードから取得する必要があり、モデルの散文に対するトークン化、キーワード、部分文字列、正規表現、またはステータステキストのマッチングからは決して取得しないでください。TaskBoardの計画カードIDはオプションのモデルヒントです。フレームワークは正規のカードID、重複排除、および依存関係の再マッピングを所有します。曖昧なIDヒントは、推測されるのではなく、クローズドに失敗する必要があります。中間ダウンロード、Webページスナップショット、生成コード、検索ノート、メモリのようなタスクノート、および大きな抽出テキストも、Workspace/Action参照として永続化され、後で境界付き読み返しを通して開かれる場合があります。これらの参照は実行証拠であり、最終成果物が存在するという証明ではありません。発見されたURL、パス、ダウンロード、またはスナップショット参照も、そのコンテンツが読み取られたという証拠ではありません。境界付き読み返し/コンテンツプレビューが利用可能になるまで、ref_onlyとして扱います。明示的なcontent、excerpt、またはsnippetフィールドは、境界付きプレビューのみです。
…
[翻訳のため省略]