Skip to main content

The technical writer and AI agents: What I learned while building Artie

· 10 min read
Pedro Vega
Technical Writer | UX Writer | Content Designer | Voracious Vinyl Collecter | Alliteration Afficiionado | New Yorker

Most technical writers don't build AI agents. We document them. We sit in on the sprint review and we read the architecture decision records. Then, we figure out how to explain a retrieval pipeline to someone who just needs to get their integration working by Friday.

But I built one anyway.

His name is Artie, an AI documentation assistant I built using Algolia and embedded in this portfolio site. The process of building him taught me more about the intersection of writing and artificial intelligence than any conference talk or white paper ever could.

This isn't a walkthrough of Artie's design—that's what the case study is for. This is about the broader lessons:

  • What AI agents actually are
  • How retrieval-augmented generation works under the hood
  • Why prompt engineering is closer to technical writing than most people realize
  • What this all means for people in this little thing of ours

The New York Knicks win the world—one summer later

· 6 min read
Pedro Vega
Technical Writer | UX Writer | Content Designer | Voracious Vinyl Collecter | Alliteration Afficiionado | New Yorker

"What is New York if not 99.6 percent of the world stacked against you? And who are New Yorkers if not people who hear those odds and smile? [...] It is in that 0.4 percent that we go to work."

— Mayor Zohran Kwame Mamdani

Well, it's been a whole summer since that faithful night in June when the Knicks fulfilled the dream generations of New Yorkers shared for 53 years. The city is still standing. The whole world thought New York City would explode, or implode, or something from the sheer chaos that would ensue, but we're still here.

Instead, the city exploded in love, one harmonious celebration echoing through every corner of the towns.

The New York Knicks are in the NBA Finals!

· 9 min read
Pedro Vega
Technical Writer | UX Writer | Content Designer | Voracious Vinyl Collecter | Alliteration Afficiionado | New Yorker
warning

This is a stream of consciousness post about the Knicks finally making it to the playoffs. I wanted to get these thoughts out there, and my loved ones are just about sick of me talking about nothing but the Knicks for the last month. So here we are.

Finally, the phrase "living through unprecedented times" means a good thing.

I love you, Jalen Brunson. ¡Big KAT, de lo mío personal ! Josh Hart—the human swiss army knife—you're the new Excellence of Execution. Landry Shamet, we dub thee "Champagne Shamet." Big Mitch, you've seen this team go from zeroes to heroes.

Mikail Bridges, who might be a Viltrumite? You've shown us what it truly means to be—

Pop philosophy—examining deontology and utilitarianism using Marvel's Civil War

· 17 min read
Pedro Vega
Technical Writer | UX Writer | Content Designer | Voracious Vinyl Collecter | Alliteration Afficiionado | New Yorker
note

This is an essay I wrote for a Philosophy class in college. I've updated the citations to be complete and accurate, but the body of the essay remains the same as it was when I wrote it back then. I just converted it into Markdown in order to play around with the blog feature. Enjoy.