ChatGPTやChatGPT APIが出てきて、それらを試しているさまざまな事例が公開されています。それらの事例の中から、たとえば特定のデータを扱う話など、利活用の方向性を絞ったものをピックアップしてご紹介します。 本記事は、TechFeed Experts Night#16 〜 ChatGPT, GitHub Copilot…AIはエンジニアの仕事をどう変える？AI×開発最前線！のセッション書き起こし記事になります。 イベントページのタイムテーブルから、その他のセッションに関する記事もお読み頂けますので、一度アクセスしてみてください。 本セッションの登壇者 セッション動画 では、「ChatGPTを使って行われた試行錯誤の事例などに関する話」というテーマで話をさせていただきます。 最初に自己紹介をさせてください。豊田陽介といいます。@youtoyというIDでTwitterをやっています。
医者だったのか明智光秀？【明智光秀と織田信長/再3】NHKドキュメント番組：歴史秘話ヒストリア - アメリッシュガーデン改
（前回のあらすじ：1573年夏、戦国時代に転生したオババとアメリッシュ。アバターとなった戦国時代の母娘を生かすため兵隊になる決意をした。鉄砲足軽隊として古川久兵衛の配下になり、彼と共に明智の密偵として浅井長政がこもる小谷城へ向かった） 私の・・は、スターウォーズ あっ、その話ね。 前のブログを早くに読んでいらした方、ツッコミしないで！ もうね、『スターウォーズ/スカイウォーカーの夜明け』か『アメリッシュ戦国時代転生物語』かってくらい、前と書いてたことが違うなんて、 そんなツッコミ入れないで。 なんせ、書いた本人が、書いたこと忘れてっから、新年早々から、やらかしてるから。 今年も順調な滑り出しでございます。 なにやらかしたかって？ ひ・み・つ！ もう、訂正したし、たぶん、大丈夫だと思う・・・ そこの方、いいですか、うっかり前回の訂正前ブログ読んでても、そこは知らんぷり。大人の対応じゃ。 よい
AWS IAM で障害が起こったらどうなるの？ AWS IAM のレジリエンス（復元力）に関する記述がドキュメントに追記されていた | DevelopersIO
コンバンハ、千葉（幸）です。 AWS サービスで広範囲の障害が起こったときにどう備えるか？は AWS を利用する上では避けて通れない課題です。 例えば Amazon EC2 であれば、アベイラビリティゾーン（AZ）単位での障害に備えてマルチ AZ 構成にしておく、リージョン単位の障害に備えて別リージョンにバックアップを退避させておく、などの構成が思いつきます。 では AWS IAM で障害が起こったときに備えてどうすべきか？改めて問われると難しい問題です。わたしはぼんやりと「そもそも障害が起こることはないんじゃないか？そもそも AWS IAM における障害って何？」という思いを抱いていました。 そんな折、いつものように AWS IAM のドキュメントの更新履歴を眺めていると IAM のレジリエンスに関する更新が行われていることに気がつきました。 Document history for I
OpenAPI + Redoc, Docusaurus, Mermaidで始めるスキーマ・ドキュメント駆動開発
OpenAPI + Redoc, Docusaurus, Mermaidで始めるスキーマ・ドキュメント駆動開発 【この本について】 この本はOpenAPIを使ってドキュメントを作成する方法を学びます。 OpenAPIを使ってドキュメントを作成することで継続的な開発を行うことができ、 OpenAPI Generatorを使ってドキュメントと実装のズレをなくすことができます。 また、Docusaurusを使ってドキュメントを作成することで、 運用ドキュメントを簡単に公開することができます。 本書では以下の内容を取り扱っています。 - Docusarusでドキュメント環境を構築する - OpenAPI + Redocでドキュメントを作成する - OpenAPI Generatorで自動生成する - Prismでモックサーバーを導入する OpenAPIを使ってみたい人、社内の設計・運用ドキュメント
インフラをコード化してVCSで管理するIaC。インフラの全てがコードで完結できることのメリットは無数にありますが、IaCだからこそ管理するべきドキュメントがあります。その管理方法についての視座をみなさんにお伝えできれば。
最初の一歩はドキュメントの英語化。Rubyが世界で使われるまでの「運と縁」をRubyのパパまつもとゆきひろ氏が振り返る - Findy Engineer Lab
グローバルで通用するプロダクトやソフトウェアを作りたい。一度は考えたことのあるエンジニアにとって「Ruby」の生みの親、まつもとゆきひろ氏は偉大かつ心強いパパです。 今回は、まつもと氏をお招きし、Rubyが世界に広がるまでのプロセスや日本から世界的なシステムやソフトウェアが生まれづらい理由、グローバルなOSS活動から得られる機会などを語っていただきました。聞き手はファインディの山田が務めます。 「自分の使うツールを良いものにしたい」が最大のモチベーション ——初めに、Rubyを開発するまでのキャリアを教えてください。 筑波大学でコンピュータサイエンスを学び、新卒で受託開発を行う独立系のソフトウェア企業に就職しました。 当時はバブル末期で、就職活動も売り手市場。プログラミング経験のある人のうち、わざわざ知名度の低いソフトウェア会社を選ぶ人は少なかったんです。2000名の社員に対し、新入社員は
LaravelアプリケーションのAPIがSwagger/OpenAPIドキュメントに準拠していることを透過的にテストする｜Laravel｜PHP｜開発ブログ｜株式会社Nextat（ネクスタット）
top > 開発ブログ > PHP > Laravel > LaravelアプリケーションのAPIがSwagger/OpenAPIドキュメントに準拠していることを透過的にテストする こんにちは、でぃーほりです。 Laravelアプリケーション開発において、 「API実装がSwagger/OpenAPIドキュメントに準拠していることを透過的にテストする」 仕組みを構築する機会があったので、背景・モチベーションから順を追ってご紹介します。 対象読者 バックエンドAPI開発に携わっている API仕様の文書化にSwagger/OASを使用している API仕様と実装が乖離して困っている 背景 Swagger/OASとはAPI仕様の文書化標準です。 HTTPリクエスト/レスポンスの形式を、人間とコンピュータの両者が理解できる形で文書化できます。 OAS(OpenAPI Specification)はS
モバイルファーストインデックスの技術ドキュメントをGoogleが刷新、準備編からベストプラクティス編へ
[レベル: 中級] モバイル ファースト インデックス対応を説明する技術ドキュメントを Google は大幅に更新しました。 この記事ではその変更点の概要を紹介します。 なお、記事を公開している時点では更新されているのは英語版ページです。 日本語版ページはまだ更新されていません。 MFI 技術ドキュメントの変更点概要 まず、ドキュメントのタイトルが変わりました。 旧: Prepare for mobile-first indexing 新: Mobile-first indexing best practices 「モバイル ファースト インデックスに向けて準備する」が「モバイル ファースト インデックスのベストプラクティス」になりました。 MFI への移行が完了したサイトが増えたので “Prepare”（準備）という表現がそぐわなくなってきたからかもしれません。 準備編からベストプラクテ
細かすぎるけど伝わってほしい脆弱性診断手法ドキュメント #始めに #本書は、ISOG-J WG1の新技術に対する診断手法分科会によってまとめられたさまざまな技術に関する脆弱性診断手法ドキュメントです。 クロスサイトスクリプティングやSQL Injectionなどの著名な脆弱性は診断手法や対策なども浸透し、日本語で読める良質なドキュメントが複数あります。 本ドキュメントでは、これらの脆弱性ではなく、一般に診断が困難であったり特有の確認方法が必要となるような脆弱性についてターゲットを絞って記載しています。 脆弱性診断員はもとより開発者の方々も、本ドキュメントを参考に、自身のアプリケーションに脆弱性が紛れ込んでいないか確認していただければ幸いです。 執筆者一覧 (敬称略、順不同) #三井物産セキュアディレクション株式会社 廣田 一貴三井物産セキュアディレクション株式会社 山本 健太三井物産セキュ
はじめに 皆さんは、『公式ドキュメントを読んだほうがいいよ』とよく耳にしませんか？ そこで、『よし読むぞ！』と思っても、なかなかうまくいきませんよね💦 （そういう方々がこの記事を見に来てくれると思っている👀） 私も、公式ドキュメントを読むのが苦手で、まず最初に、Qiitaなどの技術系ブログに頼ってしまいますw そこで、なぜ自分が公式ドキュメントに苦手意識があり、どうしたらその抵抗をなくせるのかを考えたので、記録として記事にしたいと思います！🙆 ちなみに、公式ドキュメントとの思い出は、1年前ぐらいにDockerの公式ドキュメントで何が書いてあるか理解できず、15分くらいで読むことを諦めましたw ※自分がこの記事を通して公式ドキュメントが読めるようになるために努力した記事なので、公式ドキュメントを批判した記事ではないです！ 対象読者 公式ドキュメントを読むのが苦手な若手エンジニア 😅公
モバイル基盤部の吉田です。 先日 Android アプリのリニューアル時に社内向けに用意した画面実装ドキュメントの内容を補足を交えてご紹介します。 用意した経緯 Cookpad の Android アプリの現在のコードベースは 2014 年に初回リリースされました。しかし当時の実装が 2020 年でもベストプラクティスであることは稀です。 Android 開発は日進月歩で様変わりしています。様々な時代のコードが入り交じるレポジトリで大規模なリファクタリングと新たなメンバーによる開発が始まるということで、新規実装の指針となる View 周りの実装ドキュメントの必要性を感じたので用意しました。 今回のドキュメントが View にフォーカスした理由は、全体設計に関しては既に VIPER の詳細なドキュメントが用意されていましたので、残りは View 周りの具体的な実装方針があればチームで大きなブ
ChatGPTとGoogleスプレッドシートの組み合わせを可能にする「GPT for Sheets and Docs」というアドオンは、Googleドキュメントでも利用可能です。例えば、英文を翻訳するだけでなく、要約したり箇条書きに整えたりする用途で活用できます。 翻訳ツールの弱点を克服 本サイトでは、以前にChatGPTとGoogleスプレッドシートの組み合わせを可能にする「GPT for Sheets and Docs」というアドオンを紹介しました（本記事末尾の関連記事を参照）。「GPT関数」を利用してGoogleスプレッドシートからChatGPTへ問い合わせをしたり、数式を分析したりする処理が可能です。 「GPT for Sheets and Docs」は、その名前から連想できるように、GoogleスプレッドシートだけでなくGoogleドキュメントでも活用できます。スプレッドシートに
Launchable, Inc.のソフトウェアエンジニアであるこんぼい氏は、ドキュメントを大事にしている理由と、具体的にどのようなドキュメントを運用しているのか、また、ドキュメント文化醸造のための取り組みについて紹介しました。全2回。 こんぼい氏の自己紹介 こんぼい氏：よろしくお願いします。「非同期な開発体制を支えるドキュメント文化」ということで発表します。 まず自己紹介をします。矢吹遼介と申します。Launchableという会社でソフトウェアエンジニアをやっています。インターネット上ではゴリラのアイコンで「Konboi」というIDでやっています。よろしくお願いします。 Launchableについて はじめにLaunchableについて軽く紹介させてください。USに本社があって、Jenkinsの作者の川口さん（川口耕介氏）がSun（Sun Microsystems）の時の同僚のHarpre
@SpringBootConfiguration └ @Configuration └ @Component @EnableAutoConfiguration └ @AutoConfigurationPackage └ @Import @ComponentScan
どんなに優れた製品でも、その製品のドキュメントが難解だとユーザーの拡大は難しいもの。そんなドキュメントの「正しい作成方法」について、ウェブアプリのビルドサービスを提供するDivioが解説しています。 The documentation system — Documentation system documentation https://documentation.divio.com/ よい製品でもよいドキュメントがなければユーザーは増えないと多くの人が認識しているにもかかわらず、「正しいドキュメント作成方法」を知らないために、ドキュメント作成に失敗している事例が後を絶たないとDivioは指摘。Divioはドキュメントを「実践的か、理論的か」「学習時に役立つか、作業時に役立つか」の2軸に当てはめ、「チュートリアル」「HowToガイド」「リファレンス」「説明・議論」の4つに分類しています。
GitHub、公式ドキュメントを学習したAIが質問に答えてくれる「Copilot in GitHub Support」正式リリース
GitHubは、GitHubのサポート窓口においてGitHubの公式ドキュメントを学習したAIが回答してくれる「Copilot in GitHub Support」の正式リリースを発表しました。 「Copilot in GitHub Support」とはどのようなものなのか、正式リリースを発表した同社のブログ「Copilot in GitHub Support is now available!」で、次のように説明されています。 Copilot in GitHub Support reduces the need to manually search for the right context across different pages in the official GitHub documentation. The assistant efficiently distills rel
◆ 荒川区在住のBは、都内高校に通う高校1年生（事件当時は中学3年）。窪田正孝似のイケメン。中学時代は野球に励み全国大会出場の過去を持つ強肩だった。野球推薦で強豪校からのスカウトもきたが坊主が嫌で断わり今は草野球で活躍。将来の夢は社会人野球でまず活躍すること。好きなゲームはカーレース。好きなヤンキー漫画は「ドロップ」「クローズ」「HIGH & LOW」。 タイマンのきっかけは今年1月はじめ、BのSNSに書きこまれたAのコメントだった。 ©文藝春秋 「昼くらいに彼女のC子と2人で撮った動画をSNSに上げたらその日の夜頃、面識もないAから突然『なんでC子と付き合っているの？』とSNS上で言われました。そこからいろいろ送られてきて、好きだった彼女を侮辱されてかなり腹が立ちました。C子からは『Aはそういうすぐおちょくってくるやつだから』『やめて！』と止められたのですが、怒りは収まりませんでした。A
「読む人のことを考える」 これだけ。 僕は、ドキュメントを読むのが苦手。すぐに混乱する。 ひとつの段落が長いと混乱する。正確に書いてくれているんだろうけど、書き手目線で細かくばーって書いてあって、読み手がそこから自分の目的の情報を探し出さないといけない状態だと混乱する。 あと、ページの階層が深かったり、リンクでジャンプしまくったり、用語がぶれていたり、文章が複数の意味に捉えられる書き方になっていたりすると、混乱する。 そんな風に、たぶん僕は他の人よりもドキュメントを読むのが苦手なんだと思う。 だから、自分が読んでも混乱しないようなドキュメントを書くと、まわりの人にとっても分かりやすいドキュメントになっているみたい。それで「分かりやすいね」って、ほめてもらって嬉しい。ドキュメントを読むのが苦手で役に立った！ どんなことに気をつけてるかな？と考えてみる。 そのドキュメントの目的が分からないと混
データベースドキュメント生成コマンド tbls 更新情報 ( PostgreSQL publicスキーマ表示仕様変更/Amazon DynamoDB対応/goccy ware etc) - Copy/Cut/Paste/Hatena
ここ最近tblsのアップデートエントリを書いていなかったのですが、最近変更をいくつか行いました。 このまま放置するとちょっと紹介しきれなくなりそうなので、ここら辺で放出しておこうと思います。 紹介時点のtblsのバージョンはv1.29.0です。 PostgreSQLでの public. スキーマ表示仕様変更 tblsでは、もともとPostgreSQLの public. スキーマ（ schema_name.table_name.column_name の schema_name ）だけ特別に非表示にしていました。 こうなっていた理由は、私がPostgreSQLでのスキーマを意識した運用経験がなかったことに寄る部分が大きいです。「デフォルトだから非表示で良いだろう」と。 ところで、tblsにはlintの機能があります。「テーブルカラムにコメントが書かれているか？」とか「外部キーの参照元にIND
はじめに こんにちは、LLM Advent Calendar 2023 4日目の記事を担当する_mkazutakaです。よろしくお願いします。 LLM Advent CalendarといってもRAGの話になりますが、ご容赦ください。 企業独自のデータを使ってLLMからの出力を制御する際には、検索拡張生成(いわゆるRAG)が使われます。 RAGの実装方法としては、「PDFからドキュメント情報を読み取り検索エンジンに保存」「ユーザの入力する質問文から関連するドキュメントを検索エンジンから取得」「取得したものをコンテキストとしてプロンプトに含める」という流れが一般的だと思います。 この際、RAGの課題の一つでもあるのですが、検索結果から取得するドキュメントのサイズ(いわゆるチャンクサイズ)をどれぐらいのものにするかというものがあります。チャンクサイズが小さすぎるとLLMは関連するコンテキストから
最初に 皆さんはドキュメントとどのように付き合っていますか？ 前職はベンチャー企業ではあったのですが、割とウォーターフォールに近く、決められた仕様を満たしていればOKというふうな感じだったので、 仕様書を書いて、エンジニア数人で仕様書レビューをして、OKが出たら実装して、テスト前にテスト仕様書書いてテスト仕様書のレビューして。。。というふうに開発を行っていました。 今はスクラムマスターがいる環境でアジャイルで開発を行っています。 ドキュメントに関しては特に決まりはなく、開発者が書いたほうがいいなと思ったタイミングで書かれています。 ドキュメントは必要だという話は良く聞くし、ただ毎回しっかりドキュメント書くのも結構大変だよな。。。 というふうに思っていて自分の中でいい落とし所があればいいなと思っていたのですが、 最近一旦その落とし所を見つけた気がしたのでこの記事を書いています！ （アジャイル
アドレス欄に「doc.new」と入力するだけでドキュメントが新規作成できるGoogleのショートカットにSpotifyやGitHubも追加
by Paweł Czerwińsk Googleが、「.new」ドメインを活用してブラウザのアドレス欄に「doc.new」や「sheet.new」と入力するとGoogle ドキュメントやGoogle スプレッドシートでファイルを新規作成できるショートカットサービスに、SpotifyやGitHubなどの12種類のサービスを対応させたと発表しました。 10 shortcuts made possible by .new https://blog.google/outreach-initiatives/entrepreneurs/shortcuts-made-possible-new/ Googleは2018年10月に、ブラウザのアドレス欄に「doc.new」や「sheet.new」と入力するだけでG Suiteでファイルを新規作成できるサービスを公開しました。 Introducing a ✨
GitHubヘルプドキュメントが日本語化されました
GitHubのヘルプドキュメントサイト help.github.com が、日本語と中国語(簡体字)でも利用可能になりました。新たに翻訳されたヘルプサイトには、GitHub.com、GitHub Enterprise、GitHub Desktop、およびGitHub Pagesのドキュメントがあります。 日本語サイトおよび中国語(簡体字)サイトにアクセスするには、help.github.comにアクセスし、ドロップダウンメニューから使用する言語を選択します。また、日本語の場合はhelp.github.com/ja、中国語(簡体字)の場合はhelp.github.com/cnにアクセスすることで、翻訳されたドキュメントのディレクトリに直接アクセスすることもできます。 ヘルプと製品ドキュメントはCI（継続的インテグレーション）が採用されており、これにより、サイトの利用者には常に最新のコンテンツ
「ドキュメント 精神科病院×新型コロナ」 - ETV特集
「ドキュメント 精神科病院×新型コロナ」初回放送日：2021年7月31日 東京都中から精神疾患のあるコロナ陽性患者を受け入れている都立松沢病院のコロナ専門病棟。次々とクラスターが発生し、精神疾患があるが故に一般の病院で受け入れ困難とされた人たちが運び込まれる。１年間の密着取材で、病院にしか居場所のない患者、受け入れを拒む家族、ひっ迫する医療体制の中で葛藤する医療者たち、そして行き届かない行政の指導の実態が見えてきた。コロナ禍があぶり出した日本の精神医療、その実態の記録。
Googleが最近、新ドメイン「.new」を開放することを発表しました。 このドメインの使用条件として、何らかのアクティビティ・アクション・アプリへのショートカットを作成するために使用しなければならないことが設定されています。 Google自身の言葉で言えば、「.newドメインはすべて、アクション生成、またはオンライン作成フローに使用されなければなりません」とのこと。 米Lifehackerの編集者としても、.newドメインのコンセプトはありがたいところ。 Googleドライブでドキュメントを新規作成するといった面倒なアクティビティが非常に簡単になるからです。これまでは複数のステップが必要でしたが、これからはアドレスバーに［docs.new］を入力するだけで済みます。
ChatGPTにファイルやドキュメントを直接アップロードできるようになるFirefox向け拡張機能「ChatGPTFileuploadFirefoxExtension」
ChatGPTで意図通りに文章を生成するためには、的確に指示をまとめたプロンプトを入力する必要があります。また、プログラムをChatGPTにコーディングしてもらう時に、参考のコードを入力することもあります。しかし、プロンプトやコードをいちいち手元からコピー＆ペーストで貼り付けたりするのは面倒。「ChatGPTFileuploadFirefoxExtension」はFirefox向けの拡張機能で、ChatGPTにファイルやドキュメントを直接アップロードすることが可能になります。 GitHub - deonvz/ChatGPTFileuploadFirefoxExtension: This extension will place a file upload for you on the ChatGPT website. Allow you to process your own script
声は強力なツールだ。Googleの音声入力機能は、声による文字入力を支援するだけでなく、プレゼンにも活用できる。 Googleの音声入力機能を使えば、自分の声を使って、頭の中の考えを素早く簡単にデジタル化できる。 Googleは米国時間1月9日、音声入力でより正確かつ安定した文字起こしを実現するアップデートを段階的にリリースすると発表した。 主な変更点は次のとおりだ。 音声を文字起こしする際の変換ミスを削減 文字起こしの漏れを最小化 対象が大半の主要ブラウザーに拡大 「Googleスライド」のキャプションに句読点を自動挿入 強化された音声入力機能を実際に使えようになるのは大半のユーザーの場合、2月9日以降だ。その間に、Googleの音声入力機能を使って「Googleドキュメント」で入力・編集をしたり、Googleスライドのスピーカーノートに音声でテキストを入力したりする方法を紹介しよう。
"preferences": [ { "name": "token", "type": "password", "required": true, "title": "Personal Access Token", "description": "Create a token with repository access" } ], このように記載しておくと、初回起動時に下のような表示が出てユーザーに入力を強制させることができます。 公式ドキュメントはこちらです。 ファイル検索 下のようなコードで検索するようにしました。ここでは wantedly/dev という private な repository 内検索にしているので、これを preference に移行したり、空にしたりするともっと汎用性のあるものにできるでしょう。コード検索においては GraphQL の API が使えなかったの
ドキュメントを誰のために書いていますか
Solo Technical Writer のやざきです。いまは株式会社ソラコムで、SORACOM Users (通称、SORACOM ユーザーサイト) というサイトの管理をしています。「ユーザー」と書いていますがれっきとした公式サイトです。 先日、個人的な立場として (とても大切)、次世代 Web カンファレンス 2023 Technical Writing セッション (Togetter) で議論をさせていただきました。もしまだ聞かれていない方がいらっしゃったらぜひ聞いてみてください。 今回は、そこでは話し足りなかったことの一つ「ドキュメントを誰のために書いていますか」について補足しておこうという記事です。 誰のために書いていますか 「読者のため」に書きましょう。これが原理原則だと思います。 ですが、「読者」を正確に把握できますか？と考えると、現実には難しいことが多そうです。つまり「読
ある事柄について語ろうとする時、いわく言いがたい居心地の悪さを感じることがある。たとえば「民主主義」がそうだ。「民主主義は大切だと思うか」と問われれば、迷わず「大切」と答えるが、そう即答しながらも、どこか口先だけでものを言っているような違和感が拭えない。まるでサイズのあわない借り物の服を着ているような収まりの悪さを感じてしまうのだ。 よく言われるようにそれは、民主主義が血肉化されていないせいかもしれない。私たちの社会は自らの手で民主主義体制を生み出したわけではないからだ。 「コーポレートガバナンス（企業統治）」という言葉もこれと似ている。 東芝、みずほフィナンシャルグループ、日産自動車、関西電力、三菱電機と挙げれば、どれも世間で名の通った一流企業だと思うかもしれない。だがこれらはいずれも近年、経営の歪みが表沙汰になった企業だ。こうした企業の不祥事が問題になるたびにコーポレートガバナンスの重
リモートワーカーに欠かせないドキュメントスキルを磨こう
ドキュメントが欠かせない理由欧米の企業とお仕事するときにいつも感心するのがドキュメントのボリュームと質。私も結構書く方だと思っていますが、それを容易に上回る情報量のドキュメントが共有されることがあります。ただ単に文字数が多いわけではなく、必要十分な情報が図なども交えて明文化されています。 エンジニアに限らず、デザイナーやプロダクトマネージャーもしっかりドキュメントを書く習慣が根付いているように見えます。恐らく下記の理由からしっかりドキュメントを書かざるを得ないのかもしれません。 皆が同じ時間帯で仕事をしているわけではない場所も違うので「ちょっと話してすり合わせ」とはいかない英語が第一言語ではない人たちとコミュニケーションをしている文化も違うのでお互いがもつ『当たり前』が通じない日本企業で日本語で通じ合える環境では馴染みがない状況です。ドキュメントを書かなくても、ちょっと話せば分かり合える場
損害保険ジャパン株式会社 DX推進部の眞方です。この記事では、RAG（Retrieval Augmented Generative）の構築時に、ドキュメント検索精度の向上を目指して検索モデルの改善を行った際の手法、および結果について解説させていただきます。 概要を知りたい、という方は以前書いた前回の記事を読んでください。 はじめに 今回はRAGにおける検索モデルの改善を目的として、独自のデータを使用してfine-tuneを行いました。 RAGにおける検索（赤枠）の部分を改善する取り組みを行いました。 検索モデル 学習のためのライブラリとしては、sentence transformersを使用しました。また、モデルは日本語BERTを使用しています。 データ 今回RAGの対象となるドキュメントは、大きく次の2つが存在しています。 規定集 保険商品の説明等が書かれているドキュメントです（詳細は前
「エンジニアのためのドキュメントライティング」 岩瀬 義昌 | Forkwell Press | フォークウェルプレス
アーカイブでは視聴者からのQ&Aを見ることができます ドキュメント文化を浸透させる方法 おすすめのドキュメント管理ツール ドキュメントがない状態での引き継ぎ 運用しやすいドキュメント構造とは 増えすぎたドキュメントの管理方法 ドキュメントを残さないシニアエンジニアへの対策 ドキュメントへの苦手意識を克服する方法 誰もドキュメントを読んでくれません 複数人でドキュメント管理するコツ 本記事のTopics 書籍の概要・構成 おすすめの書籍 読み手の理解 ドラフトの執筆 フィードバックの収集と組み込み ドキュメントの品質測定 日本語を学べる書籍 ドキュメントは開発側の生産性とユーザーの利便性を高めるもの。ドキュメントがなければ、ユーザーに使われる機会が確実に減ります。開発者がいかにすばらしいプロダクトを作ろうが、ドキュメントの欠如がその価値を奪うのです。 本書は、経験に長けた執筆者たちがドキュメ
エンジニアリングユニットの酒井といいます。 昨年の9月に入社し、Anewsの開発に従事しつつ時々SREっぽいこともしています。 今回は、自分が入社当初から改善したいなぁと考えていたAnewsのドキュメントについて、これまでやってきた取り組みについてお話しできればと思います。 取り組みを始めたきっかけそもそも自分は組織開発において、ドキュメントが重要だという認識がありました。それはこれまでの経験則によるところもありますし、『Googleのソフトウェアエンジニアリング』中で以下のような言及があり、重要性を再認識したというのもあります。 10.2 何故ドキュメンテーションが必要なのか p220: ドキュメンテーションは長期的に見ると決定的に重要であり、決定的に重要なコードにとっては特に、組織がスケールするのに伴い途方もない恩恵をもたらす。 テストを書くことは普通になりつつありますが、ドキュメント
ドキュメント指向の開発プロセス｜平野智也（トム）
ぼくが勤めるナレッジワークでは、創業時からリモートからの働き方に対応してきた。今では週一の出社日が設けられているが、現在でもリモートワークは継続しており、メンバー同士が異なる場所から働きやすい環境を実践できている。 コミュニケーション設計については前記事で触れたので、今回は、プロダクト開発チームが、どのようなコミュニケーションを取りながら業務を進めているのかについて紹介したい。 そこで着目するのが、ドキュメントだ。ナレッジワークでは、過去から現在に至る意思決定のプロセスや結論がドキュメントとして残されていて、もちろん開発プロセスにおいても例外ではない。社内において、情報のアクセスのしやすさ、つまりオープンであることが徹底されていて、自社の組織やプロダクトについてのドメイン知識については、ほとんどすべてアクセス可能になっている。 この情報の透明性を支えているのが、あらゆる意思決定の場において
富野由悠季の世界：富野由悠季監督×ジブリ鈴木P ドキュメントムービーで対談 - MANTANWEB（まんたんウェブ）
「富野由悠季の世界」のドキュメントムービー「富野由悠季の世界～Film works entrusted to the future～」で対談した鈴木敏夫プロデューサー（左）と富野由悠季監督 人気アニメ「ガンダム」シリーズの“生みの親”である富野由悠季監督のこれまでの仕事を回顧、検証した初の展覧会「富野由悠季の世界」のドキュメントムービー「富野由悠季の世界～Film works entrusted to the future～」に、スタジオジブリ鈴木敏夫プロデューサーが登場することが分かった。ドキュメントムービーのブルーレイディスク（BD）＆DVDと「アニメージュとジブリ展」のコラボ企画として富野監督と鈴木プロデューサーの対談を実施。対談の一部がBD＆DVDに収録される。
OS設定を一発で確認するためのSSMドキュメントを作ってみた（Amazon Linux2） | DevelopersIO
こんにちは、大前です。 EC2 の構築に合わせて最低限の OS 設定をする事が多いのですが、設定内容をチェックする際に毎回コマンドを調べたりするのが面倒だったので、RunCommand 一発で一通り確認するための SSM ドキュメントを作ってみました。 SSM が使用できる事が前提ではありますが、SSM ドキュメントを改修すればいくらでも応用が効くと思いますので、よければご活用ください。 また、対象 OS は Amazon Linux2 となります。 今回作ったもの 今回は以下をチェックするドキュメントを作成しました。 ホスト名 タイムゾーン 言語設定 yum アップデートの有無 時刻同期状況 作成ドキュメント 作成したドキュメントは以下になります。 特に難しいことはしていないので、基本的な知識がある方であればいい感じにアレンジできるかと思います。 --- schemaVersion: '
規程文書を Google ドキュメント から GitHub に移行する - KAYAC engineers' blog
人事部の小池です。 この記事は KAYAC Advent Calendar 2022 の16日目の記事です。 カヤックの規程文書管理の仕組みを Google ドキュメント から GitHub に移行した取り組みについて紹介します。 これまでの文書管理 カヤックでは長年規程文書を Google ドキュメント で管理していました。Google ドキュメント は多くの従業員にとって親しみやすいものの、文書を管理する上でいくつかつらい点がありました。 改訂内容の差分が追いにくい・改訂の背景がわからない Google ドキュメント なので変更履歴から過去の版を閲覧することは可能ですが手軽とはいえません。改訂の際は内容以外にも改訂に至った経緯、議論といった背景も重要ですが、これらの背景は成果物である Google ドキュメント の版の履歴からは伺うことはできません。「ある時までは確かこういった規程内容
よく知られているように、ドキュメントには「構造」があります。 WebページではHTMLとCSSにより構造とスタイルを分離するべきとか、Wordでは書式設定をスタイルとして定義して使うことで構造とスタイルを分離するべきとか、ドキュメントの「べき」論で必ず言及される「構造とスタイルの分離」における「構造」です。 昨日までの話ではPDFにもドキュメント構造というのが出てきました。あれは、この「構造とスタイルの分離」というときの「構造」とは別物なので注意してください。 たぶん、PDFのドキュメント構造には、「ドキュメントを表すデータ構造」くらいの意味合いくらいしかありません。 一方、ドキュメントの話において「構造とスタイルの分離」というときの「構造」は、もうちょっとこうなんていうか、セマンティックな話です。 データをどう構成するかではなく、ドキュメントで表したい意味をどう構成するか、という話。 し
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
機能要件定義、ドキュメント添削、API活用 - 開発者によるChatGPTの試行錯誤あれこれ
IaCにおける理想のドキュメント管理を目指す
細かすぎるけど伝わってほしい脆弱性診断手法ドキュメント
なぜ僕は公式ドキュメントを読むのが苦手なのか - Qiita
基本の Android View 実装ドキュメントの紹介 - クックパッド開発者ブログ
ChatGPTをGoogleドキュメントで使う方法。英文の要約から翻訳まで一気に解決！
“非同期な開発組織”におけるドキュメントの「強み」 時間の節約、深く理解できる、フィードバックを深く・平等にできる…
Spring リファレンスドキュメント - Java フレームワーク
よい製品でもガイドやチュートリアルが難解だと使ってもらえない、ではドキュメントの正しい作成方法とは？
【荒川決闘ドキュメント side“B”】元野球少年が告白「彼女をめぐってゴチャマンは避けたかった」 | 文春オンライン
チーム用のドキュメントを書くときに考えてるたったひとつのこと｜cba
GPT-4 Turboにドキュメントのチャンク分けを任せてみる - EXPLAZA Tech Blog
ドキュメントとの丁度いい付き合い方についての自分の考え - Qiita
ドキュメントも予定も。「.new」と入力するだけで一発作成できるサービス一覧 | ライフハッカー・ジャパン
「Googleドキュメント」の音声入力機能がアップデート--使い方を解説
Raycast で社内ドキュメント検索ツールを作ってみた
『決戦！株主総会 ドキュメントLIXIL 死闘の8カ月』コーポレートガバナンスとは何か - HONZ
RAGにおけるドキュメント検索精度向上について(実践編)
1年かけてAnewsのドキュメントを改善した話
ドキュメント技術とプログラミング言語の相似について - golden-luckyの日記
拡張機能が動かなくなるかも？ 「Google ドキュメント」がHTML5 Canvasベースのレンダリングへ移行／HTMLベースよりも高パフォーマンス。プラットフォーム間での表示一貫性も向上
