chore(docs): reposition copy to the agents workspace

[mmabrouk]

What a reader sees

The marketing site relaunched today on the new positioning, but several repo files still call Agenta "the open-source LLMOps platform." Those files feed PyPI, docs.agenta.ai, and LLM scrapers, so the old identity keeps leaking to readers. This repoints the identity copy to match the site:

• PyPI package summary (agenta on PyPI, from sdks/python/pyproject.toml):
  • Before: "The SDK for agenta is an open-source LLMOps platform."
  • After: "Agenta — the open-source workspace for your agents. Build agents through chat, improve them with feedback, and share them with your team."
• Docs site title tag / tagline (docusaurus.config.ts + .dev.ts):
  • Before: "The LLMOps platform."
  • After: "The open-source workspace for your agents."
• Docs llms.txt header description (the LLM-facing site summary):
  • Before: "The LLMOps platform for building and deploying LLM applications."
  • After: "The open-source workspace for your agents — build them through chat, improve them with feedback, and share them with your team."
• Docs home / "What is Agenta?" intro (getting-started/01-introduction.mdx) now leads with the agents-workspace framing and keeps the AI-engineers + subject-matter-experts audience line. Prompt management, evaluation, and observability are reframed as the supporting capabilities that make those agents reliable — kept, not removed.
• Long-tail identity mentions: the open-source page meta + body, and the LangChain tracing cookbook intro line.

What this does not change

No factual capability claims are deleted — prompt management, evaluation, and observability remain documented in full. This is a copy/positioning pass only.

Notes

• docs/build/llms.txt and llms-full.txt are gitignored build artifacts; they regenerate from these sources on the next docs deploy (verified locally after pnpm build), so they are not hand-edited or committed here.
• The PyPI summary itself only refreshes when the next agenta SDK release is published.
• The web/_reference/agenta-sdk* TypeScript packages are unpublished (three are private: true, none exist on npm, no publish workflow), so their descriptions were left untouched.
• Out of scope for this PR: eight docs/docs/integrations/frameworks/*/observability.mdx files still carry a repeated "What is Agenta?" boilerplate callout with the old wording; worth a follow-up sweep.

Verification

docs && pnpm build succeeds; regenerated llms.txt carries the new copy.

https://claude.ai/code/session_013Qe1Vf2yvj33BVd5W1q7HB

[mmabrouk]

@coderabbitai review

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Ready	Preview, Comment	Jul 22, 2026 9:37pm

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0fc98b45-bf54-4217-b5d6-b4c19fa97ea0

📥 Commits

Reviewing files that changed from the base of the PR and between fc2aaf4 and 03627cb.

📒 Files selected for processing (6)

• docs/docs/getting-started/01-introduction.mdx
• docs/docs/misc/01-opensource.mdx
• docs/docs/tutorials/cookbooks/02-observability_langchain.mdx
• docs/docusaurus.config.dev.ts
• docs/docusaurus.config.ts
• sdks/python/pyproject.toml

🚧 Files skipped from review as they are similar to previous changes (4)

• docs/docs/tutorials/cookbooks/02-observability_langchain.mdx
• sdks/python/pyproject.toml
• docs/docs/getting-started/01-introduction.mdx
• docs/docusaurus.config.ts

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Updated product messaging across the documentation site to describe Agenta as an open-source workspace for agents.
  • Refreshed introductory, open-source, and observability content to emphasize prompt management, evaluation, observability, and agent collaboration.
  • Updated site taglines, metadata, and package description for consistent positioning.

Walkthrough

Agenta’s positioning is updated across documentation, Docusaurus metadata, and Python package metadata from an LLMOps platform to an open-source workspace for agents.

Changes

Agent workspace messaging

Layer / File(s)	Summary
Documentation copy updates docs/docs/getting-started/01-introduction.mdx, docs/docs/misc/01-opensource.mdx, docs/docs/tutorials/cookbooks/02-observability_langchain.mdx	Documentation descriptions and introductory text now frame Agenta as an open-source workspace for agents, with updated references to collaboration, prompt management, evaluation, and observability.
Site and package metadata updates docs/docusaurus.config*.ts, sdks/python/pyproject.toml	Docusaurus taglines and descriptions, along with Python package metadata, use the updated agent workspace wording.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly reflects the docs copy repositioning toward an agents-workspace framing.
Description check	✅ Passed	The description matches the changeset, describing the copy updates across docs, config, and SDK metadata.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/agents-positioning-copy

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0de37420-e90b-4e6f-917e-009ee433b500

📥 Commits

Reviewing files that changed from the base of the PR and between 7b38504 and fc2aaf4.

📒 Files selected for processing (6)

• docs/docs/getting-started/01-introduction.mdx
• docs/docs/misc/01-opensource.mdx
• docs/docs/tutorials/cookbooks/02-observability_langchain.mdx
• docs/docusaurus.config.dev.ts
• docs/docusaurus.config.ts
• sdks/python/pyproject.toml

[coderabbitai]

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use the official LangChain casing.

Please change “Langchain” to “LangChain” in this user-facing documentation sentence.

[github-actions]

Railway Preview Environment

Image tag	pr-5448-57aadbe
Status	Failed
Railway logs	Open logs
Logs	View workflow run
Updated at 2026-07-22T21:42:18.010Z