ここは、このセクションの内容とは直接関係なさそう。まとめとかに入れた方がいいのでは

メソッドでは

(´・∀・`)へぇ〜

これって一つ前の起動コストが時間には含まれていないんですか?

起動コストは4ワーカーのみだから一つ前とおなじくらいってことなのかな?ちょっとぱっと見どこをどう計測しているんだろう?って思った

起動コストはほぼ

ではプロセス生成がない分

とか書いてもいいかも

MacBook Air

でもいいかなと

これが具体的にどういうパターンなのかを教えてくれるとうれしい。

私の理解は基本はThread→CPUバウンドならInterpreterでいいかなーと思っているので

なんでここ7なんだろう。とくに意味のある数値ではないと思うけど

使用する

とかでよいのでは

独自のGIL、と、独立したGILという似ているけど異なる表現であることに意味はあるのか。同じものなら表現を合わせたい

独自のGILとGIL Bという表現の違いはあとでわかる?

意味的にはどちらも独自のGILと言えるかなとおもったので

表現を合わせて「起動コスト小」とかの方がわかりやすいかなーと

トル

最初の段階で「◯◯をするための機能」みたいな簡単な説明があった方が読みやすいかなと思いました

見にくいので改行を入れてほしい派

（みやすくするために改行を入れてます、的な

ここにもArticleInfo ArticleListを書いておくと、ほしいデータとコード上のPydanticモデルの関連が把握しやすくなるかなと

ここの「安全」も気になる

Pythonを安全に活用しているわけではないのでは

Pythonを拡張して型安全なLLMアプリを作成する

みたいなイメージ?

横スクロールしないと一番みたい結果がみれないので、改行して表示して欲しい

という機能

とか?「というのが」は口語的なので

コードでの出現順にあわせて、この項目が最初に来て欲しい

docstringを書いて欲しい

他に併せるなら、このコードは article_common_strict.py みたいなファイルにした方がよいのでは。

で、example_4.pyではそれをimportして使用する

これも安全という表現が適切か気になる。

LLMからのデータをバリデーションして、ルールに則ったデータのみを取得できます。

とか

Pydanticモデルの

スキーマとしてPydanticのモデルを

とか

article_common?

で◯◯を実装する

みたいに言いたい

安全っていうとどちらかというと、情報が漏れるとかそういう話を想像する。

ここで言いたいことは指定した構造のとおりのデータを受け取れるということを言いたいんだと思います。

LLMから適切に構造活かしたデータを受け取る?とか??

ここでOpenAIのAPIに対して「このスキーマに従って構造化したデータを返してね」としているので、その説明がコメントでほしい

もうちょい説明が欲しい

PydanticのモデルからJSONスキーマを生成し、そのスキーマで必須の項目(?)対してOpen AIでの◯◯のためにadditionalProperties: falseを追加する?

「additionalProperties: false」がないといけないというドキュメントへのリンクもあるといいなぁ

Pathオブジェクトからは以下で読み込む派

SAMPLE_THML = html_path.read_text(encoding="utf-8")

APIでの構造化出力を試す

の方がわかりやすいかなと

◯◯プロバイダーと呼びたいけど、なんだろう。 生成AIのAPIプロバイダー?

https://pypi.org/project/pydantic-ai/ 3.14に対応してそう?

節タイトルそのままだ冗長かなと思いました。

パッケージマネージャーuv、とか、HTTPクライアントHTTPXとかでいいかなと

トル

「」が区切りになるので「、」はなくてもいい派

節、トルでもいいのでは

トルでも意味は通じそう

機能

かなぁ

ドキュメント

今見たら3.14の翻訳率は50%くらいだったので「多くの」くらいがよいと思います

生成AIが台頭している今のタイミングで本書を手に取る意味、みたいなことは書かなくてもいいかなぁ。 普遍的な知識をつけるとか?

ここにコメントが欲しい

これは具体的になにをやっているのかちょっとわからなかったです。

最後のブログ記事の内容を確認して、もともとのタスクの依頼内容を満たしているかをチェックしている? 満たしてなかったらどうなる?

ここもうちょい具体的に書いてくれた方が、コードをもとにCrewAIがなにをやってるか明確になると思いました。

タスク全体をTaskの内容から把握し、実行計画を立てる。実行計画では◯◯調査、◯◯調査を実施し、その結果をもとにトレンド分析し~~

書くAgentの役割や能力を踏まえ、各タスクを以下のように額Agentに割り当てる

◯◯調査、◯◯調査: データ収集専門家

みたいな

閉じ括弧がない。このカッコ不要そう?

この説明だとLLMのバージョンが同じだったら同じ結果が返ってくると読める。

実際には実行するたびに微妙に違う結果が返ってくるのでは?

kickoff()メソッド

kickoff()は等幅フォントにしたい

デフォルトでは~~の説明が欲しい

一般の読者向け

とか

トレンド情報

かな

そういえばコードに全体的にキャプションを入れたい

これ、後の方に出てくるストーリーと同じですか?違ったら合わせて欲しい

実行したあとに幾つかログが抜粋で表示されていると、処理内容がイメージができていいかなと思いました。

次の行に「ログには主に以下の情報が」と書いてあるので、ログの例がほしいと思います

最初の例をYAMLも使った構成で書き直すとこうなります。 みたいなのが見れるとうれしいなー

シーケンシャルな場合との違いがあまりピントこなかったです

MUST: これだとコマンドラインで環境変数を設定しているように見える。コードブロックを分けた方が良い

ツールの説明がここまであんまなかったので唐突に感じる。

箇条書きは「だ、である」派

これも、先にどういう構成なのかを説明して欲しい。 図で示せるとわかりやすいかも。

tableが壊れとる...

list[BaseTool] 派。BaseToolってなに?

str | LLM | Any 派

Anyありなんかい!!

話が急に飛んでいる。

一度見出し「◯◯の主な引数」みたいなのを挟み

Agent、Task...には◯◯をするためにさまざまな引数があります。 以下に~~

見たいな文章がほしい。

SHOULD: コードの前に、どういうことをさせようとしているかの説明分がほしいです。 以下のコードのコメントを読めばわかるとは思うんですが、先に説明してからコードを読む方が、スムーズに理解できるかなと思いました

たとえばこういう感じかなと

最新のAI技術に対してわかりやすい記事を書くという目的で、調査員とライターの2人のメンバーがいて、調査員の調査した内容を元に~~~

dotenvが必須かなと思ったけどそうじゃなくて環境変数を.envファイルに書きたいから使っているだけですよね。

ここでは環境変数を.envファイルに書いて~~~のためにdotenvを使用します。

みたいな説明がほしいかなと思いました

ここも箇条書きにするなら文体を揃えたい

nits 箇条書きだと「体言止め」で文体が違うので、ここは普通の文章にした方がよいかと

ここも書き換えてください

1つの文で「以下」が連続しているので、こっちはトルでも意味が通じるかな。

上の文章と似た内容だけど微妙に情報が増えて箇条書きになっている。この箇条書きでなにを伝えたいかを直前に文章で書いて欲しい。

以下は〜〜です。 以下に〜〜を示します。

みたいな

例なのでしょうがないけど、自分でファイル名を指定しつつ、拡張子も指定するというコマンドは、オプションの用途としてピンとこないなと思いました。

何か数え方のルールとかを変えられるといいんだけど。文字数でカウントするかバイト数でカウントするか、とか

これも = をトルでいいと思う

キーハード引数を示すときに = って付けるのあんまり見たことないので、トルでいいと思います

nits: 表の文章は最後の。はトルでいいかなぁ

キャプションがない。

以降も同様

ここに中身を入れて、実際に動作させた例がほしい

オプションに値が

とか?

トル

これはコマンドで呼び出すときの話ですよね?ちょっとこの文章だけだと意味が取りにくい

「短縮形」と「長い形」という表現がいまいちだなと

短いオプション名と長いオプション名とか?

表でまとめた方が見やすそう

これはなんか--nameは名前を指定するためだけにしか使われないように読めるので、ちょっと違うかなと。

例えば、名前を指定するための--nameオプション、などです。

とか?

ちょっと意味が分からなかったです。

なんか変。以降もcaptionになってない

が

これもバッククォートで囲む

などのデコレーターを

外部ライブラリ

にしたんじゃないっけか

を作成

argparseについては「<project:#argparse>」を参照してください。

とか入れて欲しい

標準ライブラリの、と書いてあるのでモジュールはトルでよいかと

バッククォートで囲んで欲しい

バッククォートで囲んでほしい

毎回太字にしなくてよいかと。初出の時だけでよいのでは

Python 3.13からサポートされていますが、ここでは3.14のことしか書かない?

https://docs.python.org/ja/3.14/howto/free-threading-python.html

これはどこ情報なのか、が気になりました

完全に分離、とはどういう意味かがわかりにくい。

なにから完全に分離しているのか

表記揺れ: インタープリター

CPU数(長い文章)+4、と書いてあるのでそれがまとまりだとわかりにくいと思います。

(os.process_cpu_count()が返す)実行環境のCPU数+4と32のどちらか

だと読みやすいかな

この表現ちょっとわかりにくいかなと思いました。

buffersizeが指定されると、その数のプロセスやスレッドなどがスケジュールされ、それ以外は待ちとなる、ということですよね。

「未取得結果の最大件数」という表現がわかりにくいなと思いました

インデントがずれている

引数が増えているので確認してください

捕捉

コードを書き換えたのでこのコメントは正しくない

https://docs.python.org/ja/3/library/asyncio-runner.html#asyncio.run

3.12からloop_factory引数が増えてる

インデントが3文字になっている

なにを複数組み込むのか?

ruff checkとruff formatを実施

とか。なにを実施するか書いて欲しい

pre-commitはCIじゃないかなー

各種ツールでruffを使用する方法、とか?

日本語がなんか変です。

で行(おこな)っておくと?

引数無しで

引数無しで

これデフォルト設定だからなー。 クォートをシングルにできるけど、設定なしの運用でいいんじゃない?みたいな記述がいいかなーって思ってます。

カンマを付けたい派

これはストーリーとしては、この前に ruff check --fix を実行していないといけないので、そのように手前で実行している必要がある

使われていないモジュールだとF401が出ちゃうのでisortの意味がない(fixできない)

無理やり使うモジュールを入れましょう

datetimeとかなにかをいれてメッセージに追加する感じで

文章（文章）。

が正しい書き方(のはず)

トル

この手前でfixされたあとのexample.pyを表示して、import osが削除されていることを確認したい

す。

系なくてもいい派です

下の設定例だとpyproject.tomlなので

前述の設定ファイルを用いて、にしてコードのキャプションに「説明 - pyproject.toml」とか書くのはどうでしょうか

checkコマンド

とか

長いので、トルでも通じるかなと

表のタイトルを入れてください。

https://myst-parser.readthedocs.io/en/latest/syntax/tables.html#table-with-captions

と、

ここで、を打たないと「一部のルール」がFにもかかっているように読める。

もしくはE系の一部とF系のルールが

とか

Flake8 (以下同様

Flake8と最初は大文字かなと

https://flake8.pycqa.org/en/latest/

同様にデフォルト設定っぽいものは除外して必要最低限にしてほしい

デフォルト設定を設定例に書いているのが気になります。

デフォルト設定はここにあることを示して、設定ファイルとしては必要最低限の記述例でいいかなと思います https://docs.astral.sh/ruff/configuration/

整形

他の箇所と表現を合わせる

を記述します。

前の文は主体が自分だったので

他のライブラリとかでuvを使ったインストールには触れていないので、ここはなくてもいいかなぁ

ここも両方指定した場合と同じとか、まるっと省略してもいいかも

このへんも2回目以降は省略しちゃってもいいんじゃないかな

いいと思います

や

箇条書きで体言止めと、だであるが混ざっているので、どちらかに統一したい派

ここまでの手順を再実行すると多分この結果は得られないはず。手前で環境作り直すとかした方がいいかも?

依存ライブラリも一緒に削除されているのがポイントかなと

uv lockコマンド

こっちはまだ依存関係という言葉が残っている。タイトルと表現を合わせたい

ここはuv の節なので、「uvで」はなくてもいいかなと思った。他も同様

インストール可能な一覧とインストールされていたらその場所を出力している

インストール可能なPythonの一覧を出力する。が正しいです

List the available Python installations

uv pythonがない

README.mdも説明した方が良いのでは

ディレクトリもあるので「名前」としたい

2回目は冗長なので「ファイル群」とかでよいかと

本書で紹介するuvのコマンド

でいいかな。主なというよりはこの書籍で紹介するものを列挙していると思うので

最新版の0.9.17

addは追加するだけどremoveはアンインストールするなので表現が揃っていない。 追加/削除 or インストール/アンインストールに揃えて欲しい

が

の方がいいかなー

uvx とバッククォートで囲みたい。以下同様

外部パッケージによって提供されるツール

とか?

.pyはつけない派?

PEP 723で提案されたけどPyPA関連はのちのち変わっていくので、仕様としてはこちらを参照するのが適切です。

(PEPドキュメントの先頭にもそう書いてある)

https://packaging.python.org/en/latest/specifications/inline-script-metadata/#inline-script-metadata

外部

この手順よりは、新規にディレクトリ作成、uv init実行した後に、pyproject.toml, uv.lockだけコピーしてuv sync実行するみたいな手順がいいのではと思った。

実際のユースケースに合わせる

uv pip installした場合はuv addと違ってpyproject.tomlとかuv.lockが更新されないということを書いた方がいいかなぁ

名を

pyproject.tomlの設定を見て、今のuv.lockファイルに存在するパッケージのままか新しいバージョンが存在するかを調べる。

みたいな意味合いだと思います。

あと、これってどっちかというと hoge>4.0.0 とかかいていて、hogeの最新バージョンがでているか(pip list -O)みたいな使い方がメインかなと思ったんですが、そうではない?

pyproject.tomlを書き換えたのはここで例として示しているために必要なだけど、本来はpyproject.toml書き換えたらuv syncの方を使うかなと思ったので(uv 素人なのではずしてたらすいません)

uv.lockファイル

トルでもいいかな(あってもいいけど)

uv lock

uv.lockファイル

uv.lockファイル

ハッシュの例はハッシュ値を省略しつつ1行くらいは載せて欲しいかな

てインストールします。 pyproject.tomlにはdevというセクション(?)が追加され~~

みたいな文章がほしい。

このときもpyproject.tomlの中は書き換えられるよ(ですよね?)とか説明があっていいと思う

依存関係というよりも、「さきほど追加したパッケージが」とかいう説明でよいのではないか

pipコマンドと同様に、とかあってもいいかも

PyPIからダウンロードしてインストールされていることとか触れて欲しい。

依存関係を管理するってちょっとイメージしにくいかなと思いました。

プロジェクトで使用するライブラリを管理する、とか?

コマンド実行後

一文が長いので「利用できます。」で一度切ってもいいかも

なにももう一つの方法なのか

仮想環境下のPythonを実行するもう一つの~

とか?

に

の方がいいかな

さっきとは異なるディレクトリに作ったと言うことですかね。手順で mkdir uv-example がないのでちょっと混乱するかも

では

◯◯な場合に仮想環境を再作成します。

みたいな用途にも触れてくれるとうれしいなと思った。

長いし、トルでも意味は通じるかなと

確認するメッセージが表示されます。

コマンドを

で

でよさそう

仮想環境を有効化した場合は、プロンプトにプロジェクト(ディレクトリ名)が表示されることにも言及して欲しい。

venvは作成したvenv名がプロンプトで表示されていたので

ここで段落を変えてもいいかな

typo: いません

手順にlsを入れるといいかなと。 venvの方にはあった

uvで作成する仮想環境は、基本的にvenvで作るやつと同じだよ、みたいな説明がほしいかな

.py は付けない?

Pythonプロジェクト

とか最初は書いておいた方がいいかなと

この手前に全体を俯瞰したいので、uvで提供しているコマンド一覧がほしい。

全部紹介しないなら、そのうち本書ではこれを紹介するよ、とか言ってほしい

これを紹介しているので、あえてバージョン指定してのインストールは教えなくてもいいかなと

これ必要な場合ってありますか?説明しなくてもいいかなと思った

nits: コメントでどういうチェックを有効にしたかかいてあるといいかも

起こり

したりすると

トル

日本語訳も併記して欲しい