🔑

OpenHands ワークフローにおける LLM_API_KEY 未検出問題の解決（開発日記 No.120）

に公開
GitHub Actions
環境変数
開発日記
idea

関連リンク

はじめに

昨日はGitHub Actionsの自動記事変換ワークフローにおけるgit push失敗問題を調査・修正しました。本日は、OpenHandsワークフローで発生しているLLM_API_KEY未検出問題の調査と解決に取り組みます。

背景と目的

OpenHandsワークフローにおいて、LLM_API_KEYが検出されず、ワークフローが失敗するという問題が発生していました。この問題は、ワークフローが正常に動作するために必要な環境変数が適切に設定されていないことが原因であると考えられます。本日は、この問題を特定し、解決することを目的とします。

検討内容

まずは、GitHubのイシュー #12 を確認し、問題の詳細を把握しました。イシューの内容から、LLM_API_KEYが環境変数として適切に設定されていない可能性が高いことがわかりました。次に、OpenHandsワークフロー関連のファイル（.github/workflows/openhands_resolver.yml）を調査し、LLM_API_KEYの使用箇所と設定方法を確認しました。

実装内容

問題の根本原因は、.github/workflows/openhands_resolver.yml ファイル内で、LLM_API_KEY が secrets から渡されてはいるものの、env ブロックに明示的に設定されていなかったことでした。そのため、ジョブ内のステップから環境変数として利用できませんでした。

以下の手順で修正を行いました。

  1. .github/workflows/openhands_resolver.yml ファイルを編集し、call-openhands-resolver ジョブの env ブロックに LLM_API_KEY: ${{ secrets.LLM_API_KEY }} を追加しました。
jobs:
  call-openhands-resolver:
    runs-on: ubuntu-latest
    env:
      LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
    steps:
      # ...

この変更により、ワークフロー内で LLM_API_KEY を環境変数として利用できるようになりました。

技術的なポイント

今回の修正における技術的なポイントは、GitHub Actionsにおける環境変数の設定方法を理解することでした。secrets に登録された値は、ワークフロー全体で利用できるわけではなく、特定のジョブ内で環境変数として明示的に設定する必要があるという点に注意が必要です。

所感

今回の開発では、GitHub Actionsのワークフローにおける環境変数の設定方法について理解を深めることができました。また、イシューを丁寧に読み解き、原因を特定する重要性を再認識しました。環境変数の設定ミスは、一見するとわかりにくいエラーを引き起こす可能性があるため、注意が必要です。問題が解決したかどうかは、ワークフローの再実行後に確認する必要がありますが、これでOpenHandsワークフローが正常に動作することを期待しています。

今後の課題

今回の修正でLLM_API_KEY未検出問題が解決しない場合、パーソナルアクセストークン（PAT）の権限や openhands モジュールの依存関係の問題について調査を進める必要があります。また、今回の修正が他の環境やワークフローに影響を与えないか確認する必要があります。

まとめ

本日の開発では、OpenHandsワークフローにおけるLLM_API_KEY未検出問題を解決するために、.github/workflows/openhands_resolver.yml ファイルの env 設定に LLM_API_KEY を追加しました。この修正により、ワークフローが LLM_API_KEY を正しく参照できるようになり、今後の実行でエラーが解消されることが期待されます。今回の開発を通じて、GitHub Actionsにおける環境変数の設定方法について理解を深めることができました。

Discussion