自然言語プログラミング「Zoltraak」の使い方｜環境構築方法から実行までの内容を詳しく解説

自然言語プログラミング「Zoltraak」の使い方｜環境構築方法から実行までの内容を詳しく解説

公開： 更新：
だーだい
フリーランスWebライター兼Web製作者。Webライターとしてガジェットメディアやプログラミングに関する記事を執筆する傍ら、LP制作とWordPressの改修案件もこなしつつ、活動しています。 profile

目次
  1. Zoltraak（ゾルトラーク）とは
  2. Zoltraakの使い方（Windows）
  3. Zoltraak専用フォルダの作成
  4. 仮想環境の構築
  5. 仮想環境の実行
  6. Zoltraakをインストールする
  7. Zoltraakを実行する
  8. Zoltraakで躓いたエラー内容と解決方法
  9. API接続がうまくいかない
  10. 短時間で複数回のAPI接続によるエラー
  11. References

Zoltraak（ゾルトラーク）とは

Zoltraakは日本語や英語などの自然言語を入力することで詳細な仕様書や要件定義を自動生成する自然言語プログラミングツールです。プログラミングの専門知識がなくても強力なAIを活用できることから、SNSでも好評を集めています。

Zoltraakの特徴はほかの生成AIと異なり、直接的な指示でも高精度のドキュメントを作成できるのが特徴。たとえば「カフェのホームページを作るための要件定義」と短く入力するだけで要件定義書やファイル構成、クラス図、シーケンス図など必要なすべてを自動で生成してくれます。

OSはMacとWindowsの双方で利用可能。双方の使い方はgitHubで公開されています。

ZoltraakのGitHub:
https://github.com/dai-motoki/zoltraak/blob/main/README.md

Zoltraakの使い方（Windows）

WindowsでZoltraakを使う方法について、実際の画像を用いてできるだけわかりやすく解説します。

ZoltraakはPythonを用いるので、事前にPython 3をインストールして下さい。

Pythonのバージョンは下記のコマンドで確認できます。

py -3 --version

Zoltraak専用フォルダの作成

はじめにユーザーフォルダ（\users\"ここがユーザーフォルダ"）へ移動し、Zoltraak用のフォルダを作成します。以下のコマンドを実行して下さい。

mkdir workspace

これで「workspace」というフォルダが作成できます。


Python基礎・実践(Django)

企業・法人向けのPython研修では、基礎から応用まで体系的に学べます。

Python研修の詳細

DX社員研修

企業・法人向けのDX研修では、実務に繋がるリスキリングでITレベルを向上させます。

DX研修の詳細

Javaエンジニア育成研修

企業・法人向けのJavaエンジニア育成研修では、Javaの基礎から応用まで確実に習得できます。

Java研修の詳細

新卒・新入社員向け研修

企業・法人に新入社員・新卒社員に向けたプログラミング研修を提供しています。

新入社員研修の詳細

コードキャンプのIT研修を全て見る

仮想環境の構築

フォルダ作成後は「cd workspace」というコマンドを入力してworkspaceフォルダへ移動します。次にworkspaceフォルダ内で下記のコマンドを実行して仮想環境を構築しましょう。

python -m venv .venv

上記コマンドの実行後は、上記画像のようにファイルの内容を表示する「ls」コマンドを実行します。

表示内容の「Length Name」欄に「.venv」と表示されていれば仮想環境が作成されています。

仮想環境の実行

workspaceフォルダ内で下記のコマンドを実行し、先ほど構築した仮想環境を有効化します。

.venv\scripts\activate

上記画面のように実行の有無が表示されるため、常に実行する「A」か一度だけ実行する「R」のいずれかを選んでください。今回は1度だけ実行するので「R」を入力してエンターキーを押します。

有効化したあとは下記のコマンドを実行して、文字コードをUTF-8にしてください。

$env:PYTHONUTF8=1

Zoltraakをインストールする

仮想環境を動かしたあと、下記のコマンドを実行してZoltraakをインストールしましょう。

pip install zoltraak

インストール後はターミナルではなく、windowsフォルダを開いてZoltraakのフォルダまでアクセスします。

上記画像のように、ターミナルでは「\」を区切りとしてフォルダの階層を表示しています。これはデスクトップ上のフォルダ配置と表示方法が違うだけで、指している内容は同じです。

デスクトップ上で下記の手順通りにフォルダをクリックすることでZoltraakファルダへたどり着きます。

Users→ユーザ名→workspace→.venv→Lib→site-packages→zoltraak

Zoltraakフォルダを開いたら右クリックして「新規作成」、「テキストドキュメント」をクリックします。

テキスト内に「ANTHROPIC_API_KEY="APIキーを入力"」を指定し、ClaudeのAPI取得用のファイルを作成します。ANTHROPICのAPI取得ページへアクセスし、ファイルの「"APIキーを入力"」へ指定して保存ましょう。

Zoltraakを実行する

ひとつ前のフォルダへ移動するコマンド「cd ..」を連打してworkspaceフォルダまで戻ります。

workspaceフォルダまで戻ったらいよいよZoltraakを実行します。Zoltraakの入力方法は下記の通り。

zoltraak "プロンプト内容" -c コンパイラ名

Zoltraakにはすでに複数のコンパイラが用意されており、これらを使うことで簡単に要件定義書やドキュメントを作成できます。ZoltraakのRead.me[1]に記載されている具体的な入力例は下記になります。

zoltraak "Manimを用いて、MoE（専門家の混合）モデルを視覚化するプログラムを開発する" -c dev_func
zoltraak "今月中にオブジェクト指向設計を用いて、多機能在庫管理システムを開発する" -c dev_obj
zoltraak "今月中に中小企業向けのビジネスコンサルティングドキュメントを作成する。具体的には、マーケティング戦略、財務管理、人材育成に関するアドバイスを含む" -c biz_consult
zoltraak "今月中に教育用の拡張現実（AR）アプリケーションを開発する" -c general_def
zoltraak "今月中に政府向けの少子化対策として、具体的な施策と予算案を含む提言書を執筆する" -c general_reqdef

今回は上記の中から「zoltraak "今月中に中小企業向けのビジネスコンサルティングドキュメントを作成する。具体的には、マーケティング戦略、財務管理、人材育成に関するアドバイスを含む" -c biz_consult」を実行してみます。

「起動術式を用いて魔法術式を構築する」と表示されました。子ども心をくすぐる作りなのもZoltraakの魅力ですね。

エラーが発生せず処理が完了すると、ターゲットファイルのパス（構築された要件定義書がある場所）が表示されます。VSCodeをインストールしている場合、自然に構築された要件定義書がVSCodeにて表示されるので便利ですよ。

上記はZoltraakによって構築された要件定義書です。具体的なゴールからフォルダ構成、クラス図まで必要なものが数十秒で出来上がるから驚きですね。

このように、シンプルなプロンプトとコンパイラを用いて高品質なドキュメントを生成できるのがZoltraakの魅力です。

おすすめのPython研修一覧

Python研修を提供しているおすすめの企業・法人を一覧で掲載しております。

Python研修の一覧を見る

おすすめのDX研修一覧

DX研修を提供しているおすすめの企業・法人を一覧で掲載しております。

DX研修の一覧を見る

おすすめのJava研修一覧

Java研修を提供しているおすすめの企業・法人を一覧で掲載しております。

Java研修の一覧を見る

おすすめのJavaScript研修一覧

JavaScript研修を提供しているおすすめの企業・法人を一覧で掲載しております。

JavaScript研修の一覧を見る

Zoltraakで躓いたエラー内容と解決方法

Zoltraakを実行するまでに躓いたエラー内容と解決方法について紹介します。

API接続がうまくいかない

エラー内容

TypeError: "Could not resolve authentication method. Expected either api_key or auth_token to be set. Or for one of the `X-Api-Key` or `Authorization` headers to be explicitly omitted"

上記のようにAPIへ接続できないときは、自分のPCにある「システム環境変数 」へAPI名とAIPキーを入力することで接続できました。具体的な手順は下記の通りです。

STEP
1

「環境変数」の検索

デスクトップの「検索」で「環境変数」と入力し、表示された「システム環境変数の編集」をクリック。
STEP
2

環境変数の編集

プロパティが表示されるので、画面右下にある「環境変数(N)」をクリック。
STEP
3

新しいシステム環境変数の追加

システム環境変数(S)欄の下部にある「新規」をクリック。
STEP
4

APIキーの設定

変数名(N)へAPI名を入力し、変数値(V)へAPIキーを入力する。

短時間で複数回のAPI接続によるエラー

エラー内容

エラーメッセージ: Error code: 429 - {'type': 'error', 'error': {'type': 'rate_limit_error', 'message': 'Number of requests has exceeded your per-minute rate limit (https://docs.anthropic.com/claude/reference/rate-limits); see the response headers for current usage. Please try again later or contact sales at https://www.anthropic.com/contact-sales to discuss your options for a rate limit increase.'}}

上記のエラー文はAPIへのリクエストに関するリミットに達したという内容です。短時間にZoltraakを複数回実行すると表示されます。このようにAPIのエラーがひょうじされたときは、数時間間を押して再度利用することで解決できる可能性が高いです。

References

  1. ^ GitHub. 「dai-motoki/zoltraak」. https://github.com/dai-motoki/zoltraak/blob/main/README.md, (参照 2024-05-15).

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。

ITやプログラミングに関するコラム


ITやプログラミングに関するニュース

ブログに戻る

コメントを残す

コメントは公開前に承認される必要があることにご注意ください。

コードキャンプDX人材育成研修 - IT・プログラミングを知って学べるコネクトメディア フューチャーアーキテクト株式会社が実現した新入社員向けIT研修プログラムでタスクフォース制度が主体的な学びと成長を生み出す - IT・プログラミングを知って学べるコネクトメディア コードキャンプDX人材育成研修 - IT・プログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/【IT新入社員研修】オンラインとオフラインの最適バランスを実現したFutureOneの導入事例 - IT・プログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/【新入社員研修】柔軟なハイブリッド型Java研修で実現した新卒20名の成長と成果｜サークレイス株式会社 - ITやプログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/現場により近いところにデジタルを根付かせるDX基礎講座研修｜株式会社ブリヂストン - ITやプログラミングを知って学べるコネクトメディア コードキャンプIT・プログラミング研修事例/業務の効率化・DX推進に向けたIT人材育成への第一歩｜株式会社カナエ - ITやプログラミングを知って学べるコネクトメディア 企業・法人向けのIT・プログラミング研修 - ITやプログラミングを知って学べるコネクトメディア

新着記事

ALL
IT NEWS
ITコラム
IT用語集
2024年 11月 20日
【近日公開】停滞する日本経済とIT後進国の現実。IT技術の理解から始まるAI活用の可能性
2024年 11月 18日
話題のAI拡張機能「Cline（クライン）」の使い方。VSCode・Cursorユーザー必見の神機能を紹介
2024年 10月 25日
【製造業のDX人材育成事例】デジタル人材の即戦力化を実現する、日本ガイシ株式会社の異動者向オンボーディング研修
2024年 11月 19日
プロンプトでPCを操作できるClaude「computer use」を使ってみた
2024年 11月 15日
AIと共創力で未来を切り開く！日本ガイシとワイ・ディ・シーの新入社員合同研修レポート
2024年11月14日

【11月15日から】X（旧Twitter）のツイートがAI学習されるらしい。AI学習をオフにする対策法を紹介
2024年11月11日

トップクラスの性能を誇るオープンソースAI「OpenCoder」が公開
2024年11月05日

AmazonがAI要約機能「X-Ray Recaps」のβ版をPrime Videoに導入。ネタバレを避けた要約を実現
2024年10月31日

コードキャンプが法人向けIT人材育成パッケージ研修を発表、1名から受講可能な柔軟な研修カリキュラムの提供開始へ
2024年10月30日

Amazon「Kindle Vella」を2025年2月に終了へ。独自の読書体験プラットフォームが幕を閉じる

 IT NEWS
2024年10月18日

【Python】辞書(dict)をforループで処理する方法
2024年10月18日

【Python】classとコンストラクタ(constructor)の基本を解説
2024年10月18日

【Python】辞書(dict)からリスト(list)に変換する方法
2024年10月17日

【Python】桁数をprintで出力する方法を解説
2024年10月17日

【Python】int型の最大値を確認する方法を解説

 ITマガジン
2024年11月12日

Pythonのtuple()とは？意味をわかりやすく簡単に解説
2024年11月12日

Pythonのsuper()とは？意味をわかりやすく簡単に解説
2024年11月12日

Pythonのsum()とは？意味をわかりやすく簡単に解説
2024年11月12日

Pythonのstr()とは？意味をわかりやすく簡単に解説
2024年11月12日

Pythonのstaticmethod()とは？意味をわかりやすく簡単に解説

 IT用語集

対象者別で探す

全ての研修を確認する
CodeCampKIDSフランチャイズ募集
全てのコースを確認する

子供（小学生・中学生・高校生）向け
プログラミング教室検索する

子供（小学生・中学生・高校生）がロボットやプログラミング言語を学ぶことができるオフラインからオンラインスクールを検索、比較することが可能です。

子供（小学生・中学生・高校生）
プログラミング教室検索する

ITやプログラムなどの
最新情報を検索する

日々、新しいITやプログラミング言語の情報が流れていきますが、特定の情報を時系列でニュースやコラムを確認することができます。

ITやプログラムなどの
最新情報を検索する