アクセス方法 | 説明 | 推奨シナリオ |
Skill対応のAIツールを使用して、AIがログトピックの自動作成または再利用、環境の識別、そして接続と分析を完了します。 | Skill対応のAIツールを使用し、ワンクリックで接続し、手動設定を減らすことを希望します。 | |
手順に従ってインストールコマンドを実行し、リージョンアクセスポイント、ログトピック、キーなどのパラメータを手動で入力して接続を完了します。 | 接続パラメータを細かく制御する必要がある場合、または使用するツールがSkillに対応していない場合です。 |
Region（例：ap-guangzhou）を記入します。方式2ではドメインを記入し、パブリックネットワークドメインはap-guangzhou.cls.tencentyun.com、プライベートネットワークドメインはap-guangzhou.cls.tencentcs.comです。Tencent Cloud Agent可観測性アクセスSkillを使用してください：https://skillhub.cn/skills/tencentcloud-cls-agent-obs現在のAIアプリケーションをTencent Cloud Agent可観測性に接続してください。接続方法：CodeBuddy + WorkBuddyRegion：ap-guangzhou
curl -fsSL https://onesuite-pilot-1254077820.cos.ap-shanghai.myqcloud.com/onesuite-pilot/installer.sh | bash -s -- install \\--cls-endpoint "<your-cls-endpoint>" \\--cls-topic-id "<your-topic-id>" \\--cls-secret-id "<your-secret-id>" \\--cls-secret-key "<your-secret-key>" \\
パラメータ | 必須 | 説明 |
--cls-endpoint | はい | 広州リージョンを例にすると、外部ドメイン名：ap-guangzhou.cls.tencentyun.com、内部ドメイン名：ap-guangzhou.cls.tencentcs.comです。 |
--cls-topic-id | はい | アップロード先のログトピックID（TopicId）。 |
--cls-secret-id | はい | |
--cls-secret-key | はい | |
--user-id | いいえ | データ帰属ユーザー識別子です。アップロードデータの gen_ai.user.idフィールドに書き込まれます。指定しない場合はデフォルトでホスト名が使用されます。また、--userIdまたは--user.idと表記することもできます。 |
--user-name | いいえ | ユーザー表示名です。 gen_ai.user.nameにマッピングされ、userIdとは独立した2つのフィールドです。 |
--agents | いいえ | 接入するAgentのリストを指定します（カンマ区切り）。指定しない場合、検出されたすべてのAgentに自動的に接続します。 |
--data-dir | いいえ | カスタムデータディレクトリです。デフォルトは ~/.onesuite-pilotです。 |
--auto-update | いいえ | 自動アップグレードです。有効にすることをお勧めします。 |
✅ インストールが完了しました！が表示された場合、デプロイが成功したことを意味します。ONESUITE_PILOT_USER_ID → 設定ファイルuserId → 設定ファイルuser.id → ホスト名（フォールバック）。onesuite-pilot status # サービスの実行ステータスを確認します。onesuite-pilot info # バージョン、設定ファイルのパス、および完全な設定を確認します。
✅ onesuite-pilot v... is running (PID xxxxx)、およびautostart: enabledが含まれている必要があります。onesuite-pilot: command not foundと表示された場合は、ターミナルを再起動するか、source ~/.bashrcを実行して環境変数を有効にしてから再試行してください。この表示はOneSuite-Pilotサービスの実行には影響しません。コマンド | 説明 |
onesuite-pilot status | サービスの実行状態、PID、自動起動状態を確認します。 |
onesuite-pilot info | バージョン、設定ファイルのパス、データディレクトリ、および完全な設定を確認します。 |
onesuite-pilot restart | サービスを再起動します。設定変更後に実行する必要があります。再起動時にバッファ内のデータが強制的にフラッシュされます。 |
onesuite-pilot stop / start | サービスを停止/起動します。 |
~/.onesuite-pilot/config.jsonを直接編集し、変更後にサービスを再起動すると有効になります。設定ファイルは標準のJSONで、コア構造は以下の通りです：{"enabled": true,"dataDir": "/Users/you/.onesuite-pilot","userId": "122855467","userName": "helloworld","flushers": {"cls": {"endpoint": "ap-guangzhou.cls.tencentyun.com","topicId": "<your-topic-id>","secretId": "<your-secret-id>","secretKey": "<your-secret-key>"}}}
cp ~/.onesuite-pilot/config.json ~/.onesuite-pilot/config.json.bak
dataDirと同じ階層）にuserIdとuserNameの2つのフィールドを追加してから、サービスを再起動してください。config.jsonを編集し、以下のフィールドを追加します："userId": "122855467","userName": "helloworld",
onesuite-pilot restart
flushers.clsのendpoint（地域アクセスポイント）とtopicId（ターゲットトピック）を変更し、再起動後に有効になります。例えば、ap-guangzhou-openリージョンの新しいトピックに切り替える場合は以下の通りです："flushers": {"cls": {- "endpoint": "ap-guangzhou.cls.tencentyun.com",+ "endpoint": "ap-guangzhou-open.cls.tencentyun.com",- "topicId": "9263b751-9b29-4931-aeb9-4405cf69a2ea",+ "topicId": "3189f2f4-1f03-4f4a-b4c5-b139d037df61",...}}
--auto-updateを有効にしなかった場合は、手動で最新バージョンに更新する必要があります。--auto-updateを有効にしているユーザーの場合、プログラムは自動的にアップグレードされるため、通常はこのコマンドを手動で実行する必要はありません。アップグレードによって既存の~/.onesuite-pilot/config.json設定が上書きされることはありません。curl -fsSL https://onesuite-pilot-1254077820.cos.ap-shanghai.myqcloud.com/onesuite-pilot/installer.sh | bash -s -- upgrade
onesuite-pilot infoを実行してバージョンが更新されたことを確認できます。--purgeパラメータを付加します（またはサービス管理スクリプトの指示に従って操作します）。これにより、サービスを停止し、Hookと自動起動項目を削除できます。データディレクトリ~/.onesuite-pilotは必要に応じて手動で削除できます。curl -fsSL https://onesuite-pilot-1254077820.cos.ap-shanghai.myqcloud.com/onesuite-pilot/installer.sh | bash -s -- uninstall --purge
config.jsonを直接編集してonesuite-pilot restartを実行するだけで済みます。再インストールすると既存の設定が上書きされるため、新規デプロイが必要な場合にのみ使用してください。logs/配下のmetricsファイル）は、データが流入した場合にのみ更新されます。アイドル期間中に保持されるのは履歴の残存値です。config.jsonとonesuite-pilot infoの出力を基準としてください。この2つが現在実際に有効な設定です。onesuite-pilot infoを実行してサービスが読み込んだ設定を確認します。次回Agentアクティビティによってデータが生成された後、~/.onesuite-pilot/logs/<agent>/*.jsonl内の最新レコードのgen_ai.user.idフィールドを確認すれば確認できます。フィードバック