[OAS] Refresh Kibana serverless APIs

[lcawl]

Summary

Relates to #186671, #186840, #187146

This PR:

• Updates the introduction to include a technical preview admonition
• Updates the linting rules to check operation identifiers
• Re-generates the OpenAPI document to pick up changes to the Bedrock and Gemini connectors and the addition of APM operationIds.

I have omitted the updated kibana.serverless.yaml and deployed it manually for now.

[obltmachine]

🤖 GitHub comments

Expand to view the GitHub comments

Just comment with:

• /oblt-deploy : Deploy a Kibana instance using the Observability test environments.
• run docs-build : Re-trigger the docs validation. (use unformatted text in the comment!)

[paulRbr]

The API diff check failure relates to #186909

To clarify:

• the github comment not being sent doesn't make the job fail currently in the Bump.sh github-action.
• the current failure is due to a “breaking change” identified in the OAS changes because of the addition of operationIds on 3 operations. Bump.sh identifies this as 3 operations removal + 3 operations added:

---

bump diff --format markdown kibana.serverless.previous.yaml kibana.serverless.current.yam

Added (3)

• GET /api/apm/services/{serviceName}/annotation/search
• POST /api/apm/agent_keys
• POST /api/apm/services/{serviceName}/annotation

Removed (3)

• [Breaking] GET /api/apm/services/{serviceName}/annotation/search
  • Removing a resource is always breaking unless it was deprecated before [Breaking]
• [Breaking] POST /api/apm/agent_keys
  • Removing a resource is always breaking unless it was deprecated before [Breaking]
• [Breaking] POST /api/apm/services/{serviceName}/annotation
  • Removing a resource is always breaking unless it was deprecated before [Breaking]

[elasticmachine]

Pinging @elastic/kibana-docs (Team:Docs)

[karenzone]

LGTM

[elasticmachine]

💚 Build Succeeded

• Buildkite Build
• Commit: d810418

Metrics [docs]

✅ unchanged

[lcawl]

Backported in 188700