Skip to content

[bugfix][docs] Align skills agent quickstart doc model name with code (qwen3:8b → qwen3.5:9b)#796

Merged
wenjin272 merged 2 commits into
apache:mainfrom
rosemarYuan:fix/skills-doc-model-name
Jun 8, 2026
Merged

[bugfix][docs] Align skills agent quickstart doc model name with code (qwen3:8b → qwen3.5:9b)#796
wenjin272 merged 2 commits into
apache:mainfrom
rosemarYuan:fix/skills-doc-model-name

Conversation

@rosemarYuan

Copy link
Copy Markdown
Contributor

Linked issue: #795

Purpose of change

The Skills Agent quickstart doc (skills_agent.md) tells users to pull qwen3:8b, but MathAgent in both Java and Python hardcodes qwen3.5:9b. Users who follow the doc exactly hit a model-not-found error at runtime.

This PR updates the documentation to match the code:

Location in skills_agent.md Line Before After
Python code block 102 model="qwen3:8b" model="qwen3.5:9b"
Java code block 160 "model", "qwen3:8b" "model", "qwen3.5:9b"
"Prepare Ollama" description 327 qwen3:8b qwen3:8b and qwen3.5:9b
ollama pull command 330 ollama pull qwen3:8b adds ollama pull qwen3.5:9b

The Skills Agent example uses qwen3.5:9b (a tool-calling-capable model suited for the math-calculator skill), which differs from the qwen3:8b used by other quickstart examples. The "Prepare Ollama" section now instructs users to pull both models.

Tests

  • Verified all model references in skills_agent.md now match the corresponding source files
  • No code changes

API

No public API changes.

Documentation

  • doc-needed
  • doc-not-needed
  • doc-included

@github-actions github-actions Bot added doc-included Your PR already contains the necessary documentation updates. fixVersion/0.3.0 The feature or bug should be implemented/fixed in the 0.3.0 version. priority/major Default priority of the PR or issue. labels Jun 8, 2026
{{< /hint >}}

Then pull the qwen3:8b model, which is required by the quickstart examples.
Then pull the qwen3:8b and qwen3.5:9b models, which are required by the quickstart examples.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need qwen3:8b for skills agents?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right. The skills agent quickstart only uses MathAgent, which requires qwen3.5:9b. qwen3:8b is not needed on this page. I'll update to only reference qwen3.5:9b. Thanks for catching this!

@wenjin272 wenjin272 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@wenjin272 wenjin272 merged commit e9afbfc into apache:main Jun 8, 2026
91 of 100 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc-included Your PR already contains the necessary documentation updates. fixVersion/0.3.0 The feature or bug should be implemented/fixed in the 0.3.0 version. priority/major Default priority of the PR or issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants