﻿(Japanese/English)

# AIヘルパーの使い方

クロスワード ギバーの「AIヘルパー」は、たわいない会話やカギの再生成ができる、あなたの相棒です。

## セットアップ手順

(バージョン.5.3.5以降はPython不要になりました)

1. お使いの生成AIのAPIキーを取得する
   - 各プロバイダーの管理画面からAPIキーを発行してください。

2. システムの環境変数を設定する
   - スタートメニューで「環境変数」と検索し、「システム環境変数の編集」を開きます。
   - 「環境変数」ボタン→「ユーザー環境変数」の「新規」をクリックします。
   - 変数名に以下のいずれかを、変数値に取得したAPIキーを入力します。
     `GOOGLE_API_KEY` / `OPENAI_API_KEY` / `XAI_API_KEY` / `DEEPSEEK_API_KEY` / `SAKANA_API_KEY` / `DASHSCOPE_API_KEY` / `MOONSHOT_API_KEY` / `MISTRAL_API_KEY` / `LLAMA_API_KEY`

3. クロスワード ギバーを再起動する

4. 「ファイル」メニュー→「設定」→「AIヘルパー」タブを開く

5. 「AIプロバイダー」と「AIモデル」を選択する

6. 「適用」ボタンをクリックする

## 注意事項

- 生成AIは間違いをすることがあります。
- AIヘルパーはインターネットを通じて外部と通信します。ネット接続のない環境では動作しません。
- APIキーの取り扱いにご注意ください。
  - 環境変数はご自身のPC上でのみ有効です。他人とファイルを共有する際、APIキーが書かれた設定ファイルやスクリーンショットを一緒に送らないようご注意ください。
  - APIキーが漏洩した疑いがある場合は、発行元の管理画面からすぐに無効化・再発行してください。

## よくある質問

- APIキーって何？ → AIを使うための秘密の文字列です。パスワードと同じように、他人に見せないようにしてください。
- AIプロバイダーって何？ → AIサービスを提供する事業者です。
- AIモデルって何？ → AIの種類です。
- 英語でなんか出てきた → エラーメッセージなどは翻訳が難しいのでそのままになっています。Web検索や翻訳サービスなどをご利用ください。
- 動作が遅いんだけど？
  → 原因はいくつか考えられます。
  1. 無料プランのAIは利用制限（レート制限）が厳しく、応答が遅くなることがあります → 有料プランへの切り替えで改善する場合があります。
  2. モデル自体の推論速度がプロバイダーやモデルの種類によって異なります → より軽量・高速なモデルを選ぶと改善する場合があります。
  3. ご利用中のインターネット回線の速度も影響します。
- 環境変数を設定したのに反映されない → 開いているクロスワード ギバーを一度すべて閉じてから起動し直してください。

---

# How to Use AI Helper

XWordGiver's "AI Helper" is your partner, capable of casual conversation and regenerating clues.

## Setup Steps

(Python is no longer required for version 5.3.5 or later)

1. Obtain the API key for the generative AI you plan to use
   - Get an API key from your chosen provider's dashboard.

2. Set a system environment variable
   - Search "environment variables" in the Start menu and open "Edit the system environment variables."
   - Click "Environment Variables," then "New" under "User variables."
   - Enter one of the following as the variable name, and your API key as the value:
     `GOOGLE_API_KEY`, `OPENAI_API_KEY`, `XAI_API_KEY`, `DEEPSEEK_API_KEY`, `SAKANA_API_KEY`, `DASHSCOPE_API_KEY`, `MOONSHOT_API_KEY`, `MISTRAL_API_KEY`, `LLAMA_API_KEY`

3. Restart XWordGiver

4. Go to the "File" menu → "Settings" → "AI Helper" tab

5. Set the "AI Provider" and "AI Model"

6. Click "Apply"

## Notes

- Generative AI may make mistakes.
- AI Helper communicates with external systems via the Internet. It does not function in environments without an Internet connection.
- Handle your API key carefully.
  - Environment variables are only set on your own PC. When sharing files with others, make sure not to include configuration files or screenshots that expose your API key.
  - If you suspect your API key has been leaked, revoke and reissue it immediately from your provider's dashboard.

## FAQ

- What is an API key? → A secret string of characters used to access AI services. Treat it like a password — never share it with others.
- What is an AI provider? → A company that offers AI services.
- What is an AI model? → A specific type of AI.
- Why is it running slowly?
  → A few possible causes:
  1. Free-tier plans often have strict rate limits, which can slow down responses — upgrading to a paid plan may help.
  2. Inference speed varies by provider and model — a lighter/faster model may respond quicker.
  3. Your internet connection speed also affects response time.
- My environment variable isn't being picked up → Close and reopen XWordGiver completely; the changes only apply to newly opened windows.
