docs(agentic-orchestration): update get started

[afgambin]

Description

This PR updates the Get Started tutorial for Agentic Orchestration by introducing tabs for the two available working environments (SaaS vs. Self-Managed). This simplifies the tutorial and is part of this epic.

When should this change go live?

• This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
• This is already available but undocumented and should be released within a week. (add available & undocumented label)
• This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
• This is part of a scheduled alpha or minor. (add alpha or minor label)
• There is no urgency with this change (add low prio label)

PR Checklist

• The commit history of this PR is cleaned up, using {type}(scope): {description} commit message(s)

• My changes are for an upcoming minor release and are in the /docs directory (version 8.9).
• My changes are for an already released minor and are in a /versioned_docs directory.

• I added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:
  • Engineering team review
  • Technical writer review via @camunda/tech-writers unless working with an embedded writer.

[github-actions]

👋 🤖 ✅ Looks like the changes were ported across versions, nice job! 🎉

You can read more about the versioning within our docs in our documentation guidelines.

[afgambin]

@bojtospeter Based on our conversation, my understanding is that we want to:

1. Keep AWS Bedrock as the cloud-based LLM model linked to the SaaS experience.
2. Add content explaining how to use a local LLM model (e.g., Ollama, following the blog) for the Self-Managed experience.

That is, AWS for SaaS and Ollama for Self-Managed? Is this correct?

[bojtospeter]

@afgambin
AWS bedrock (or other cloud based LLM provider) can be used for SaaS and Self-managed as well.
local LLM can be used only for Self-managed

So self-managed users have a bit more flexibility in this sense.

[afgambin]

@bojtospeter I added the tabs for SaaS vs. Self-Managed, as discussed, and left one pending question before proceeding. Have a look whenever you can. Preview here.

Also, do we have a link to the new blog? Is it already published? I only have the link to the Gdoc.

[bojtospeter]

This cleanup really helps to reduce noise around SaaS / SM

[bojtospeter]

Also, do we have a link to the new blog? Is it already published?

@afgambin
The blog is not yet published, hopefully next week it will be.

.

[bojtospeter]

Please change the documentation for 8.8 as well, since it's applicable to 8.8 too.

[afgambin]

@bojtospeter Thanks for the review! Changes have been backported. For the subsequent PR: adding instructions on how to set up the local LLM, please share the link to the published blog when it’s available.

Before merging this, I’d love to hear from @mesellings, who mentioned during a meeting that there could be an issue with using tabs in this case.

[bojtospeter]

LGTM

[mesellings]

@afgambin the tabs look fine in this - the issue is around using tabs for larger blocks of documentation (including headings within) due to a Docusaurus bug (example issue) and also not the right UX experience (we shouldn't hide important docs), so this use case is fine - only one non-blocking comment, otherwise lgtm! 🚀

[afgambin]

@mesellings I’ve addressed your feedback. Can we merge it? I see you added the hold label - if so, could you please reapprove? Thanks!

[mesellings]

Approved! 🚀

[github-actions]

🧹 Preview environment for this PR has been torn down.