SAP-samples / SAP-samples/codejam-code-based-agents

JavaScript track: exercises 06 and 07 appear to be in the wrong order

オープン 初心者向け
#35 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
Python
スター
54
フォーク
36
PR マージ指標
30日以内にマージされた PR はありません

説明

Summary

06-discover-connected-crimes.md references code that's only introduced in 07-solve-the-crime.md:

  • Around line 238, it calls this.orchestrationClient.chatCompletion(...), but orchestrationClient as a class field is only declared and constructed in exercise 07's Step 1 (07-solve-the-crime.md, "Add orchestrationClient as a class field and initialize it in the constructor").
  • Around line 213, it instructs learners to add the new node "before leadDetectiveNode" — but leadDetectiveNode is also only created in exercise 07.

Effect

Following the exercises in their numbered order (06 then 07), a learner's investigationWorkflow.ts wouldn't type-check at exercise 06's step — this.orchestrationClient doesn't exist as a class member yet, and leadDetectiveNode doesn't exist to insert before.

Suggested fix

Either:

  1. Swap the exercise order (make current 07's class-field/constructor setup + Lead Detective node come before current 06's Intelligence Researcher node), or
  2. Move the orchestrationClient class-field/constructor setup into exercise 06 itself, and have exercise 07 only add leadDetectiveNode.

Either way, the sequencing needs to match what the code in each step actually depends on.

Environment

Reproduced on a personal SAP AI Core tenant, JavaScript/TypeScript track, exercises 01–07 followed in numbered order.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

06-discover-connected-crimes.md と 07-solve-the-crime.md から始め、参照されている investigationWorkflow.ts のステップとその番号順を比較します。exercise 06 で使用する前に orchestrationClient と leadDetectiveNode が導入されていることを確認し、その後 exercise 01–07 を追って、各ステップで JavaScript/TypeScript のワークフローが型チェックを通過することを確認します。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
javascript, typescript
領域
documentation
issue の種類
ドキュメント
難易度
2/5
見積もり時間
1〜3時間
活発さ
活発
明瞭さ
明確に書かれている
初心者へのやさしさ
78/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。