「AIエージェント」または「エージェント」という用語を過去数ヶ月で聞いたことがある可能性がありますが、いくつかの人々にとっては、AIエージェントを使用したことがある可能性があります。 わたし A AI と Large Language Models (LLMs) についてですが、私の同僚の一部のようにツールやワークフローをあまり深く掘り下げていません。 自称「慎重な懐疑主義者」 昨年末、トーマス・パタケックは書いた。 彼らがどのように働いているかを掘り下げることに私の関心を引いた。 エージェントを書くべき 「2025年初めに、私はトルステン・ボールの作品を読んだ。 そして、私が行ってトールステンの手順に従ってそれを実行しなかったにもかかわらず、それがどれほど単純に見えたかには少し驚きました。 エージェントを構築する方法は? エージェントが何であるか、そしてどのように機能するかについて「タイヤを叩く」機会として、私は作るのを見るために数時間の時間を置きました - そしてそれは私を吹き飛ばしました。 これをみんなとシェアし、何かを早く働かせる方法を繰り返すのは良い考えだと思いました。 何がリニューアル? 知らない人にとっては、 (Renovate CLI aka Renovate) は、パッケージマネージャーやパッケージエコシステム、9つの異なるプラットフォーム(GitHub、GitLab、Azure DevOps、その他)で依存性の更新を自動化するためのオープンソースプロジェクトであり、依存性の更新をどのように適合するかを調整するためのサポートを誇っています。 メンデルリニューアル MendのクラウドホストのRenovateは、1300万以上のリポジトリで使用され、Renovate CLIは数百万のリポジトリで自社ホストされています。 エージェントって何? 実際のエージェントが何なのかをめぐるバズボードのヒューピーにもかかわらず、私は見つけました。 美味しくて消化しやすい: サイモン・ウィリソンの定義 LLMエージェントは、目標を達成するためのループでツールを実行します。 これは私たちのLLMをとり、直接(私たちが自分自身を実装するように)またはを通じて提供されるツール(「ツール呼び出し」とも呼ばれる)を呼び出す能力を与えます。 . モデル・コンテキスト・プロトコル(MCP) 最先端のモデルが「ツール呼び出し」に訓練されているので、それはモデルにツールを提供することができ、それを呼ぶ方法を理解できることを意味します。 何を建てたいのか。 これを調べる良い方法は、LLMにリノベート構成をどのように作るかについてもう少し教えることだと思いました。 なぜなら、Renovate は多くの生態系をサポートし、 行動を正確にあなたが望むものに調節するには、あなたのリポジトリに追加できるさまざまな構成の可能性がたくさんあります。 いくつかの Configuration LLMsはすでに訓練データに基づいてRenovateの構成をよく理解しており、ウェブを検索する能力がある場合、当社の現在のドキュメントを持っているが、我々が使用しているRenovateのバージョンの正確なドキュメントを持っていない可能性があります。 我々は活気あるコミュニティを持っており、プロジェクトへの貢献の急速な性質のために、最新の変更を追跡することは困難です - 私もメンテナンス担当者の一人です! これを念頭に置いて、私は私のエージェントから望む以下の機能を決定しました。 エージェントを特定のRenovateバージョンに調節する能力 このバージョンで利用可能な機能の理解 構成変更を提案する能力 ・有効な構成とは何か(Renovate npm パッケージの一部として配信される renovate-config-validator を使用) コンフィギュレーションの変更が何を意味するかを確認する能力は、リニューアルを実行し、期待される変更が発生したことを確認し、私が取る同じワークフローを使用します。 エージェントを構築 基本入力ループの作成 まず、私はトルステンのポスト(そしてジョフリー・ハントリーのポスト)を非常に密接にフォローしました。 ) 私のエージェントの基本的なシェルをアップして走るために。 ブログ記事に基づくワークショップ 別個の Anthropic サブスクリプションを作成する必要がなくなるため、私たちは AWS Bedrock セットアップを使用するためにいくつかの修正を行い、実行中でした! Thorstenの投稿は優秀で、一歩一歩の性質は、嫉妬するような書き方と組み合わせて、基本的なことを本当にうまく説明します。 エージェントに「有効な」config がどう見えるかを教える 最低限の read_file ツールで基本的なループが実行されると、モデルがすでに Renovate 構成について知っていることのベースラインを得るために会話を始めました。 私は、提案されている構成のいくつかは、Renovateの「パワーユーザー」として知っている劣化された機能を使用することに気付きましたが、Renovateを実行するまで、誰もがそうするわけではありません。 早速、Renovateの継続的な開発のおかげで、私たちは時々既存のオプションを改名または改名します。 構成を変更するには、すなわち、構成フィールドの新しい名前を使用します. This is both applied when Renovate is running, to not force users to immediately make config file changes - but is also suggested to be committed to the repository. これは、Renovateが実行されるときにも適用されます。 「Config Migration」 リハーサルにはツールがありますが、 これらは、無効な構成を使用した場合にレポートできますが、構成移行が必要な不適切なものを使用した場合にも強調できます。 renovate-config-validator 私の最初のRenovate-y ツールは、エージェントに追加することにしました。 , LLM が有効で移行された構成のみを提供することを確認する方法を教える。 validate_config ツールを実装し、LLMに提供した後、LLMはツールを信頼できるように使用したが、config移行に関する警告に耳を傾けるようには見えなかった。 エージェントにこれをより明確に従うように促すために、私は私のシステムプロンプトに以下を含んでいたことを確認しました。 [...] あなたが提示するいかなる構成も、その後、コンピュータによって検証されることを確認する必要があります。 対応で提案された任意の構成移行が適応する - 移行を必要とする構成をユーザーに残さないでください! コンフィギュア_config コンフィギュア_config 驚くべきことに、エージェントはそれでかなり良くなり、移行された形でコンフィグを返し始めた。 この機能が適用されると、エージェントはすでに「幻覚」することができず、構成フィールドを「幻覚」し、それをユーザに返すことができ、それを実行するようになりました。 無効な config を返し、有効な config が存在するまで、再度お試しください。 validate_config Polishing the text rendering テキスト rendering この時点で、私からいくつかの合理的な質問に答え始めるエージェントがあり、有効な構成を提供し、私はそれを少し利用し始めることができました。 LLMsは主にMarkdownで質問に答え、それは読むための第二の性質であるにもかかわらず、特に私たちはそれをするために多くのライブラリを持っているので、Markdownをレンダリングすることを好む! この時点で、私はCharm Bracelet'sに組み込まれました。 Markdown をリリースするライブラリで、以下から変更が生じる: Glamour もっと美しいバージョンへ: ツールを梱包 私はRenovateのバージョン、そのツールとドキュメントについて少し明確になりたかったが、Renovateのいくつかのバージョンが私のマシンにインストールされたときにそう簡単にできなかった。 パッケージを簡素化するために、私のエージェントが以下のことを可能にする軽量なDockerイメージを作成しました。 renovat and renovate-config-validator の特定のバージョンがインストールされています。 Renovate のどのバージョンを実行しているかを知る(そしてエージェントに伝える) そのバージョンのドキュメントのコピーをダウンロード Now there is an explicit version of Renovate, I am modified my system prompt to tell the agent that: リノベーションの明確なバージョンがあるので、エージェントに次のように伝えるようにシステムのプロンプトを変更しました。 		System: []anthropic.TextBlockParam{
			// ...
			{
				Text: "Renovate is a fast-moving project, so you may know about outdated configuration at any time. You are currently running as Renovate " + a.meta.Version + ", which may not be the latest at this point in time. [config validation prompt as above]",
			}
 ♪ 読書docs 次の論理的なステップは、LLMが適切にRenovateバージョンのドキュメントを使用することができ、その答えを調節するために異なる構成の使用例をクエリすることができます。 実施したA すべてのドキュメント(マークダウンの66k行)を返すツールは、驚くべきことに、LLMは文脈の限られたセット(AKAの「文脈ウィンドウ」)を持っているため、機能しなかったし、その大量のデータを投げ捨てると、会話の残りの部分を処理するために利用可能な文脈を減らすことも多くなります。 read_docs たとえ見ても たぶん最も役に立つドキュメントのページであり、現在は Markdown の 13,000 行だったので、LLM がそれをより簡単に消化できるようにこのファイルを分割する方法を考える必要があった。 すべての repository config 設定のドキュメント これは私がまだ解決を終えていないものですが、LLMs、そしておそらく人間にとってもよりよく機能する小さなサイズに大きなファイルを分解する方法を考えるのは興味深いことです。 私はAを導入することから始めました。 ツールは、すべてのファイルをリストすることができます。 ディレクトリ(Renovate の GitHub リリースからダウンロード)で、その後使用できます。 それぞれのファイルを読み取ることができますが、いくつかのドキュメントファイルで文脈長の問題を引き起こすことができます。 list_docs docs read_file 実際にリニューアル中 私が実装したい最後の機能は、Renovate(乾燥運行モード)を実行し、エージェントが提案していた変更が実際に機能するかどうかを検証する能力を与えることでした。 これを人間として行うには、私はRenovate in its モード、その後、ログを確認して、関連する変更が行われたかどうかを確認します。 ドリップ ドリップ 幸いなことに、エージェントはツール呼び出しで、まったく同じことをするように言われることができた。 , which would execute the Renovate CLI against a local copy of a repository, based on the configuration that the agent is suggesting. エージェントが提案している構成に基づいて、リポジトリのローカルコピーに対応する。 run_renovate コマンドが完了すると、エージェントは特別なログラインを受け取ります( ) Renewate が解析したファイルや検出された更新プログラムの周辺の情報を提供し、デバッグするときに非常に役に立ちます。 packageFiles with updates 私たちが発見しているように、エージェントに提供される各増加ツールはそれをより強力にし、私はそれをより合理的に確認できるように見始めました。 Version from A 実際に現在のバージョンとバージョンアップデートを検出します。 golangci-lint Makefile 私はまだ、ログラインを調べるときに探していることを正確に教えるためにシステムプロンプトの調節を終えていないが、すでにどれだけできるか興味深い。 レッスン学習 このプロセスを通じて、私はエージェントやLLMについてもっと学び、時として思われるほど「魔法」はないということを教えられ、何か興味深いことを簡単にできる。 驚くほどシンプル 私は、最小限のエージェントループ(トルステンの投稿に基づいて)に到達するのがどれほど簡単か、そして最終結果に到達するためのGoのいくつかの数百の余分な行が、コードの合計700行であるかを見ることに驚きました。 キャップの下でLLMによって多くの仕事が行われていることに気づきますが、それはまだ印象的です! 増築工事が面白かった。 私は、新しいツールの追加やシステムプロンプトの修正などの増加的な変更が、エージェントの全体的な実行可能性を改善する方法を見るのが本当に楽しかった。 私が変更を行ったとき、私は違いを感じるために同じプロンプトを再実行しました(LLMを覚えるときは非決定主義です)。 UXを正しく取ることは、専門のエージェントで簡単です。 特定の機能に特化したエージェントがあれば、これがどう見えるかを簡単に制御できます。 私の場合、リポジトリ内のJSONファイルに修正を行い、Renovate CLIがこれらの変更の後に見る変更点を調べています。 私はまだそれを実装していないが、本当に欲しいのは、現在話している現在のRenovate構成を示すエージェントのインターフェイス上のサイドパネルであるため、LLMのフィードバックに基づいて変化するため、UIに変化します。 背景が難しい 上記のように、LLMが持つ文脈ウィンドウで私たちの文書のサイズをジョギングしようとすると少し困難でした。 これをRenovateのログラインのいくつかは特に長い(特に大きなリポジトリでは)可能性があるという事実に加え、特定の時点でトークンの使用を制限する方法を検討する追加の場所があります。 また、私のシステムプロンプトが、文法に基づく特定のアクション(すなわち、特定のツールの定義に使用されたJSONスケジュール)に向かってLLMを押し寄せているにもかかわらず、私は時にはより重く押し寄せなければなりません。 If I'm expecting it to run with . can you lookup what updates are available --dry-run=lookup これはMCPサーバーかもしれません。 あなた方がLLM、エージェント、およびモデルコンテキストプロトコルに精通している人々は、これらの多くが実際にはエージェント特有ではないことに気づき、ツール自体がMCPサーバーに抽出される可能性があります。 それは絶対に計画であるが、このブログ記事の目的のために、単一のエージェント内でそれをすべて実装することは、相互作用を必要とするMCPサーバを追加しようとするよりも簡単であることを示すことに意味があった。 I now have a lot more to do 残念ながら、これでやりたいことがたくさんあります! また、これが自分の生活を改善するためにどのように使われるかを調べ、Renovate Community Managerとして働き、ユーザーの質問に答えることができます。 そして、目を磨いてください、私はより良い場所にいるときにこのオープンソースを手に入れたいと思います。 結論 LLMやエージェントで多くのことをしていない人として、実際にそれがどれほど単純であるかを見るのは本当に目が開くことだと感じました。 私はあなたに、あなたがエージェントを構築しなければならないというもう一つの思い出を残します。 ジェイミー・タンナ Senior Developer & Open Source プロジェクトメンテナンス ジェイミーはMend Renovateのメンテナントで、コミュニティマネージャーの役割も担っていますので、おそらく周りに彼を見かけます! あなたが過去10年間耳にしたことがあるかもしれないオープンソースのプロジェクトを維持し、過去5年間にわたり、 依存管理スペースと、企業がより良いソフトウェアを配信するのを助ける。

このオーディオは、ストーリーの元の言語で制作されています。

What I’ve learned building an agent for Renovate config (as a cautious skeptic of AI) (リノベートコンフィグのためのエージェントを構築するために学んだこと)

About Author

コメント

ラベル

この記事は

Related Stories

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

フロキのヴァルハラがインドのスリランカツアーのアソシエイトスポンサーに加わる

Claude Sonnet 3.5 システムプロンプトの漏洩: 法医学的分析

クラウド移行を成功させるための完全ガイド: 戦略とベストプラクティス

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

フロキのヴァルハラがインドのスリランカツアーのアソシエイトスポンサーに加わる

Claude Sonnet 3.5 システムプロンプトの漏洩: 法医学的分析

クラウド移行を成功させるための完全ガイド: 戦略とベストプラクティス

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps