docs: enhance Swarm user guide with notes on tool calling #3665

Job	Run time
format	52s
docs (./packages/autogen-core)	1m 48s
docs-example-check (./packages/autogen-core)	2m 56s
lint	52s
mypy (./packages/autogen-core)	3m 25s
mypy (./packages/autogen-magentic-one)	1m 19s
mypy (./packages/agbench)	1m 7s
mypy (./packages/autogen-ext)	2m 51s
samples-code-check	1m 12s
mypy (./packages/autogen-agentchat)	1m 29s
pyright (./packages/autogen-core)	1m 10s
mypy (./packages/magentic-one-cli)	1m 31s
pyright (./packages/autogen-magentic-one)	56s
test (./packages/autogen-core)	1m 9s
pyright (./packages/agbench)	1m 4s
test (./packages/autogen-magentic-one)	2m 0s
pyright (./packages/autogen-ext)	1m 11s
test (./packages/autogen-ext)	4m 10s
pyright (./packages/autogen-agentchat)	58s
check-proto-changes-python	1m 19s
test (./packages/autogen-agentchat)	1m 16s
pyright (./packages/magentic-one-cli)	1m 7s
markdown-code-lint	2m 12s
codecov (./packages/autogen-core)	9s
codecov (./packages/autogen-magentic-one)	12s
codecov (./packages/autogen-ext)	7s
codecov (./packages/autogen-agentchat)	8s
	38m 30s

Provide feedback