Agentの日次運用マニュアル¶
本ドキュメントは、Agentサービスのインストールを完了したユーザーを対象としています。Agentの状態確認、サービスの管理、設定の変更、ログの表示、手動更新、およびAgentのアンインストール方法について説明しています。
以下のコマンドはLinux/systemdインストール方法に適用されます。サービス管理、設定変更、およびアンインストールコマンドの実行には、通常、ホストでsudo権限が必要です。
Agentファイルの場所を確認¶
デフォルトインストール後、Agentに関連するファイルは以下の場所に配置されます：
| 種類 | デフォルトの場所 |
|---|---|
| Agentプログラム | /usr/local/bin/obs-agent |
| アップデータープログラム | /usr/local/bin/obs-agent-updater |
| 設定ファイル | /etc/obs-agent/agent.env |
| 作業ディレクトリ | /var/lib/obs-agent/work |
| プロファイルキャッシュ | /var/lib/obs-agent/profile-cache |
| ログディレクトリ | /var/log/obs-agent |
| メインログファイル | /var/log/obs-agent/log |
| systemdサービス | obs-agent.service |
Agentの状態確認¶
Agentが実行中かどうかを確認：
サービスがアクティブかどうかのみを確認：
現在インストールされているAgentバージョンを確認：
Agentの実行ユーザーを確認：
デフォルトでは、Agentサービスはrootとして永続的に実行されるのではなく、obs-agentユーザーとして実行されます。rootは主にインストール、アップグレード、アンインストールなどのホスト管理アクションに使用されます。
Agentの開始、停止、再起動¶
Agentを開始：
Agentを停止：
Agentを再起動：
設定を変更した後、通常、新しい設定を有効にするためにサービスを再起動する必要があります：
Agentログの表示¶
最近のsystemdログを表示：
最新のログを継続的に表示：
Agentのメインログファイルを表示：
Agentの起動に失敗した場合は、最初に以下を確認することをお勧めします：
Agent設定の変更¶
Agentのランタイム設定は、デフォルトで以下に書き込まれます：
変更前にバックアップすることをお勧めします：
設定を編集：
一般的な設定には以下が含まれます：
| 設定項目 | 説明 |
|---|---|
BEAK_WS_URL |
Agentが接続するサービスアドレス |
AGENT_API_KEY |
Agentアクセス認証情報 |
AGENT_ID |
現在のAgent ID |
LLM_BASE_URL |
LLMサービスアドレス |
LLM_API_KEY |
LLM呼び出し認証情報 |
AGENT_WORKDIR |
Agentツール実行作業ディレクトリ |
AGENT_PROFILE_CACHE_DIR |
Agentプロファイル、スキル、およびスキーマキャッシュディレクトリ |
AGENT_UPDATE_BASE_URL |
Agentリリースダウンロードアドレス |
AGENT_UPDATE_CHECK_INTERVAL_SECONDS |
自動新バージョンチェックの間隔 |
AGENT_DEFAULT_APPROVAL_TTL_SECONDS |
デフォルト承認タイムアウト |
Agentが企業プロキシを通じてBeak、LLM、またはリリースサービスにアクセスする必要がある場合は、obs-agentフォワードプロキシの構成に説明されているとおりプロキシ変数とエンタープライズCAを構成してください。
LLM_MODELは必須設定ではなくなりました。新バージョンランタイムはデフォルトでdefaultモデル識別子を使用します。古い設定に有効なLLM_MODEL=...が残っている場合、実際にモデルを修正する必要がある場合のみそれを保持することをお勧めします。それ以外の場合は、その行を削除してサービスを再起動できます。
変更完了後、サービスを再起動：
設定エラーによってサービスが起動に失敗した場合は、バックアップから復元できます：
注意
agent.envファイルには、APIキー、トークン、アクセスアドレスなどの機密情報が含まれている可能性があります。設定ファイル全体を公開チャット、チケット、コードリポジトリ、またはスクリーンショットに送信しないでください。
Agentの手動更新またはロールバック¶
Agentはローカルアップデータを介してバージョンを切り替えることができます。
リリースソースの最新バージョンに更新：
特定のバージョンをインストール：
バージョンロールバックは同じコマンドを使用します。例えば、v0.1.9にロールバックするには：
自動更新タイマーのステータスを確認：
更新に失敗した場合は、以下の確認を優先してください：
/etc/obs-agent/agent.envのAGENT_UPDATE_BASE_URLが正しいかどうか；install.sh、対象バージョンのインストールパッケージ、および検証ファイルがリリースアドレスに存在するかどうか；journalctl -u obs-agent-update-check.service -n 100でダウンロード、検証、またはスケジューリングエラーがあるかどうか；journalctl -u obs-agent -n 100で起動またはエラーが再起動されるかどうか。
自動更新は/etc/obs-agent/agent.envからプロキシ変数を読み取ります。プロキシ固有のチェックについては、プロキシ上の自動更新を維持を参照してください。
Agentのアンインストール¶
アンインストールスクリプトはデフォルトではアンインストール計画のみを表示し、コンテンツを削除しません：
正しいことを確認した後、--yesで完全なアンインストールを実行：
アンインストールは以下の固定オブジェクトを削除します：
/usr/local/bin/obs-agent/usr/local/bin/obs-agent-updater/usr/local/bin/obs-agent-update-check/etc/obs-agent/var/lib/obs-agent/var/log/obs-agentobs-agent.serviceobs-agent-update-check.serviceobs-agent-update-check.timer/etc/sudoers.d/obs-agentobs-agentユーザーおよびユーザーグループ
アンインストールは、skill-dep.shによってインストールまたは確認されたスキルランタイム依存関係（システムコマンド、言語ランタイム、Python/Nodeパッケージ、フォント、またはその他のシステムパッケージなど）を削除しません。これらの依存関係は、もともとホストに存在していた共有コンポーネント、または他のサービスによって再利用される可能性があり、Agentのアンインストール処理では削除できません。
一般的なチェック¶
ページにAgentがオフラインと表示される¶
以下の順序でチェックすることをお勧めします：
- ホストサービスが実行中かどうか：
systemctl status obs-agent - ホストネットワークがサービスアドレスにアクセスできるか；
/etc/obs-agent/agent.envのBEAK_WS_URL、AGENT_API_KEY、AGENT_IDが正しいかどうか；- 最近のログに認証失敗、ネットワーク接続失敗、またはDNS解決失敗があるかどうか。
Agent設定の変更が有効にならない¶
サービスが再起動されたかどうかを確認：
次に、ログをチェックして、新しいプロセスが開始されたことを確認：
更新後、Agentバージョンが変更されない¶
最初に現在のバージョンを確認：
次に、更新ログを確認：
指定されたバージョンの更新の場合、コマンドのバージョン番号がリリースソースのバージョン番号と一致することを確認してください。