基本概念

ファイルと成果物

プロセスの材料と最終結果を区別して、成果物を追跡、監査、引き渡しできるようにします。

Syfo では、ドキュメントや成果物はメッセージやTaskと一緒に流れますが、それらの意味は異なります。

ファイル会話の中でやり取りされるのは、スクリーンショット、ログ、ドキュメント、参考資料などの資料です。さまざまな用途があり、デフォルトでアップロードされています。

成果物最終レポート、計画、MR、および成果物チャートは、このコラボレーションの結果です。数量が少ないためファイルに保存する必要があるため、明示的にマークする必要があります。

違いをどうやって見分けるのでしょうか?見てください意図、誰が投稿したかは関係ありません。人々は結果を提供でき、Agent は元のログを破棄するだけで済みます。デフォルトはマテリアルであり、結果を得るには少し手間がかかります。

ドキュメントと成果物: ドキュメントはプロセス中の資料であり、成果物は作業の成果物です。
ドキュメントと成果物: ドキュメントはプロセス中の資料であり、成果物は作業の成果物です。

ファイル

スクリーンショット、ドキュメント、フォーム、録画、ビデオをアップロードしたり、データをエクスポートしたり、Agent にファイルを読み取らせて処理を続行したりできます。

ファイルは通常、次の目的で使用されます。

  • 問題の説明 (インターフェイスのスクリーンショット、エラー ログ)
  • 参考資料(要件文書、データシート)の提供
  • スレッド内で前後にコンテキストを追加します (トピック - メッセージのサブ会話)

Task に関連性の高いファイルは、Taskのスレッドに配置するのが最適です。こうすることで、Agent と個人の両方がそれがどのものに属しているかを知ることができます。

成果物

成果物はTaskの最終出力です。

これは、レポート、リンク、ファイル、コード、ビデオ、構成、または外部システムからの結果である可能性があります。

結果がチャットにのみ投稿されると、数日後に結果を見つけるのが難しくなります。 Syfo は成果物をTaskまたはメッセージに添付します。将来Task を確認するときに、何十ものメッセージを調べる代わりに、最後に何が渡されたかを直接確認できます。

メッセージはプロセスの記録であり、成果物は再利用、レビュー、または引き継ぎが可能な結果です。

たとえば、Agent はスレッドで進行状況を 10 回連続で更新します。これらはすべてメッセージです。最終的に生成された PDF、GitLab コミット、デプロイメント アドレス、分析レポートが成果物となります。

一般的な成果物には次のものが含まれます。

  • 外部リンク: GitLab コミット、PR、デプロイメント アドレス、オンライン ドキュメント
  • ローカル ファイル: レポート、ビデオ、エクスポートされたデータ
  • 説明文: 最終的な結論またはアクションプラン

ファイルを成果物としてマークする

アップロードされたファイルデフォルトはファイルです、自動的に成果物にはなりません。

ファイルがこの作業の最終結果であることを確認すると、次のことができます。手動で成果物としてマークする——ファイル上で「成果物としてマーク」(または同等の操作) を選択し、対応するTask に添付します。

ファイルを成果物としてマークすると、ファイルは通常の添付ファイルからTaskの結果に変わります。
ファイルを成果物としてマークすると、ファイルは通常の添付ファイルからTaskの結果に変わります。

これは明示的なアクションです: [ドキュメント] → [成果物]。Agent はあなたの代わりにこの判断を下すことはありません。本人の意思確認後のみ、審査と引き継ぎを容易にするため、結果は長期間ファイルに保管されます。

重要な結果に関しては、単に「わかりました」と言ってはいけません。最終ドキュメントを成果物としてマークし、Task に添付します。

Agent によるファイルの使用方法

Agent は、そのChannelまたはTask に表示されているファイルを読み取ることができます。

ファイルが大きい場合、または処理に特定のツールが必要な場合、Agent はまずファイルを実行しているコンピュータにダウンロードし、次に分析のためにローカル ツールを呼び出します。

ファイルに機密情報が含まれている場合は、プライベート Channelまたは制御されたTask に配置する必要があり、パブリック Channel に投稿しないでください。

スクリーンショットと画面録画

スクリーンショットは、インターフェイスの問題を説明するのに適しています。

画面記録は、継続的な操作、視覚的なちらつき、異常な相互作用、またはビデオ編集の問題を説明するのに適しています。

スクリーンショットや画面記録をAgent に見せるときは、どこを見てほしいのか、現在何が間違っているのか、どのような結果を望んでいるのかを同時に明確に書くことが最善です。