Skip to content

Add feature-comparison table and toolset links to common.ai provider docs - #69649

Merged
Lee-W merged 7 commits into
apache:mainfrom
astronomer:ai-provider-docs-followup
Jul 10, 2026
Merged

Add feature-comparison table and toolset links to common.ai provider docs#69649
Lee-W merged 7 commits into
apache:mainfrom
astronomer:ai-provider-docs-followup

Conversation

@Lee-W

@Lee-WLee-W commented Jul 9, 2026

Copy link
Copy Markdown
Member

What

Addressing feedback on #69551 (merged)

  • openai / anthropic / common.ai: moved the short definition sentence above the "When to use this provider" heading, so readers meet the provider before the comparison.
  • openai: clarified that OpenAIHook is the shared underlying client (not batch-specific); added the Batch API cost/turnaround rationale (~half cost, up to ~24h turnaround).
  • anthropic: added the Message Batches cost/turnaround rationale (50% of standard cost, most within an hour, 24-hour SLA), reusing figures already in operators/anthropic.rst.
  • common.ai:
    • added a use-case → package comparison table linking to the vendor provider pages
    • noted LangChain tools work via LangChainToolset with the langchain extra
    • linked the toolsets doc from the agent bullet and noted durable step replay on retry; added cohere to the vendor-provider bullet list.

Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

Generated-by: [Claude] following the guidelines


  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

@goransh-walia

Copy link
Copy Markdown

Nice clean implementation. One minor thought: adding a docstring would help future contributors. But overall this looks solid.

Lee-W added 6 commits July 9, 2026 17:01
…docs
Reviewer feedback on apache#69551 (merged) asked for a scannable
package-choice table linking to the vendor provider pages, a note that
existing LangChain tools work via the langchain extra, and a link to the
toolsets doc from the agent bullet.
…fy batch tradeoff
Reviewer feedback on apache#69551 (merged) noted the comparison
section ran before readers knew what the provider was, that OpenAIHook
isn't batch-specific, and that the batch bullet didn't explain why one
would pick it over a synchronous call.
…d batch cost/turnaround rationale
Reviewer feedback on apache#69551 (merged) noted the comparison
section ran before readers knew what the provider was, and that the batch
bullet didn't explain why one would pick it over a synchronous call. The
new clause reuses the cost/turnaround figures already documented in
operators/anthropic.rst for consistency.
cohere is a third single-vendor AI provider shaped like openai/anthropic
(wraps Cohere's own Embed API via one operator). It had no "when to use
this provider" section, so common.ai's comparison table and vendor-provider
bullet list couldn't link to it yet.
The lead-in sentence naming what each provider is was folded into the
section body, so a reader still met the comparison heading before the
one-line definition. Moving it above the heading, for openai, anthropic,
and cohere.
…ider" heading
Matches the same restructuring already applied to openai, anthropic, and
cohere: a short definition sentence before the comparison heading, so a
reader knows what the provider is before meeting the table.
@Lee-W
Lee-Wforce-pushed the ai-provider-docs-followup branch from 55605b6 to 1d182dfCompareJuly 9, 2026 10:01
@Lee-W
Lee-W marked this pull request as ready for review July 9, 2026 10:03
@Lee-W
Lee-W merged commit 6ea3de0 into apache:mainJul 10, 2026
103 of 127 checks passed
@Lee-W
Lee-W deleted the ai-provider-docs-followup branch July 10, 2026 01:33
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Lee-W@goransh-walia@kaxil