rweisssieker-xp/TopDeskSkill-Codex

TopDeskSkill-Codex は何をしますか？

Codexスキル：TopDeskユーザー向け

このスキルは、Codex AIエージェントがTopDesk ITSMシステムと連携するためのインターフェースを提供します。ユーザーアカウントの管理（検索、作成、更新、削除）を、自然言語の指示を通じて実行できます。

機能

• ユーザー検索: 名前、メールアドレス、ユーザー名などの条件でユーザーを検索します。
• ユーザー作成: 新しいTopDeskユーザーアカウントを作成します。
• ユーザー更新: 既存のユーザー情報を更新します。
• ユーザー削除: ユーザーアカウントを削除します（権限が必要）。

セットアップ

1. TopDeskインスタンスのAPIエンドポイント、ユーザー名、パスワードまたはAPIトークンを取得します。
2. Codexの環境変数として以下の設定を行います：
   • TOPDESK_API_URL
   • TOPDESK_USERNAME
   • TOPDESK_PASSWORD または TOPDESK_API_TOKEN
3. スキルをCodexプロジェクトに追加します。

使用例

• 「TopDeskでユーザー '山田太郎' を検索して」
• 「新しいユーザー '田中花子' をメールアドレス '[email protected]' で作成して」
• 「ユーザーID '12345' のメールアドレスを '[email protected]' に更新して」
• 「ユーザーID '12345' を削除して（確認あり）」

注意事項

• すべての操作は、TopDesk上のAPI権限に依存します。
• 削除操作は不可逆的なため、実行前に確認を促すことを推奨します。
• APIレート制限に注意してください。