Add Tests and Documentation for FunctionTarget #2304

gabriel-eidelman · 2025-12-29T20:45:50Z

Why are these changes needed?

FunctionTarget was lacking a proper test file and documentation

Checks

I've included any doc changes needed for https://docs.ag2.ai/. See https://docs.ag2.ai/latest/docs/contributor-guide/documentation/ to build and test documentation locally.
I've added tests (if relevant) corresponding to the changes introduced in this PR.
I've made sure all auto checks have passed.

joggrbot · 2025-12-29T20:46:05Z

📝 Documentation Analysis

All docs are up to date! 🎉

✅ Latest commit analyzed: 777bb8e | Powered by Joggr

website/docs/user-guide/advanced-concepts/orchestration/group-chat/handoffs.mdx

* feat: add A2A Human in the loop support * chore: bump version * refactor: simplify client logic * refactor: support multiturn * lint: remove mypy ignores * tests: add Terminate human_input tests * docs: update A2A Hitl server

Update terminology across documentation to use consistent "Agent2Agent" branding instead of "Agent-to-Agent" or "agent-to-agent". Changes: - A2A documentation index page (title, heading, protocol link) - Group chat resuming documentation - Research talk abstract (Nov 2024) This provides consistent branding for the Agent2Agent (A2A) communication protocol throughout the documentation. Co-authored-by: Mark Sze <66362098+marklysze@users.noreply.github.com>

* Update sonnet model to 4.5 * fix: openai, gemini realtime * update: credentials * fix: realtime agent tool registry * fix: assistant agent test * [skip ci] docs: fix outdated docs * fix: credentials * fix: azure tests * [skip ci] docs: fix outdated docs * fix: pre-commit * fix: dev setup mdx Revert "Merge pull request #2194 from ag2ai/docs/jgr-autofix-ag_2-2188" This reverts commit 3aa474c, reversing changes made to 4d9de80. fix: user-guide --------- Co-authored-by: Mark Sze <mark@sze.family> Co-authored-by: joggrbot[bot] <107281636+joggrbot[bot]@users.noreply.github.com>

Reorganized LLM configuration methods, the 2 parts were written oppositely

) * fix client response protocol init commit * fix mypy errors * Unified Rich Response client architecture Init commit * made the role and status fields extensible in the unified response * OpenAIResponsesClient v2 init commit * OpenAIResponsesClient support for basic features * Fix groupchat which normalize content to str * [MISC] Fix mypy errors (#2167) * fix client response protocol init commit * fix mypy errors * fix: claude-code-review action for forked branches (#2171) * Update integration test * Fix new oai cient name to completions * Update notebook * Update integration test * fix client response protocol init commit * fix mypy errors * [MISC] Fix mypy errors (#2167) * fix client response protocol init commit * fix mypy errors * Add tests with real data for OpenAICompletionsClient * Add better support for GenericContent * Add support for UserRoleEnum * clean up * Update * Remove non str handling from chat completion api * refactor to use getattr * Remove message_retrieval from client v2 protocol * Add Content type enum * Add migration plan documentation * Add text property to content blocks * Add V1 client compatibility notebook * Notebook tweaks * pre-commit tidy --------- Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai> Co-authored-by: Mark Sze <mark@sze.family> Co-authored-by: Mark Sze <66362098+marklysze@users.noreply.github.com>

* chromadb and sentence-transformers package versions * Agent Builder test credentials * Test tweaks

* Handoff events for AfterWorks, OnContextCondition, and LLM-based OnCondition * Remove uuid from event init parameters * Add ReplyResult transition event, move event tests out of group tool executor tests * Consolidate transition events into single file --------- Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai>

…ith base64 str (#2207) * Replace Golden_Retriever image url with simple images with base64 encoding * Update tests

Co-authored-by: Qingyun Wu <qingyun0327@gmail.com> Co-authored-by: Mark Sze <66362098+marklysze@users.noreply.github.com>

* added logic to extract text from ThinkingBlock * Reorder imports in anthropic.py * added unit test for thinking block * Fix type checks to use isinstance for content * Fix trailing whitespace in test_anthropic.py --------- Co-authored-by: Yixuan Zhai <6344553+randombet@users.noreply.github.com> Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai>

* Anthropic Native structured output support iniit commit * Verified fallback json is working * add strict tool use cases and fix message format * Fix groupchat tests * Add error details to request exception logging * Enforce correct SDK use case * Fix bugs on from client side * Refactor * Fix most of agentchat integration tests * Add notebook example * Support ThinkingBlock * Update notebook --------- Co-authored-by: Mark Sze <66362098+marklysze@users.noreply.github.com>

* fix: keyerror in bedrock client on format tool * fix: missing await for async call * test: integration test

* Use github static image to replace wiki image for testing * Correct test assert --------- Co-authored-by: Mark Sze <mark@sze.family>

* feat: response format support on bedrock client * feat: add test and documentaion for bedrock response format * add front matter to safeguard notebook --------- Co-authored-by: Mark Sze <66362098+marklysze@users.noreply.github.com> Co-authored-by: Mark Sze <mark@sze.family>

…2234) * OpenAI Chat Completions client structured output with streaming fix * Avoid streaming logic with OpenAI and structured outputs * Tidy * Tidy and tests * Defensive use of usage attribute * Integration tests * Test Transition fix * Test file fix

…etrieval (#2214) * Fix tool call extract logic from message_retrieval * Update reasoning support for v2 client * Use github img file to replace wiki img file for testing * Fix integration tests * Fix test from local * Test updates to o4-mini from o1-mini (deprecated) --------- Co-authored-by: Mark Sze <mark@sze.family>

* feat: Route event printing through logging * add licence headers * fix: tests * fix: move code * docs: add logging events * fix: pre-commits

* Avoid pydantic deprecation warnings on import * fix: format code to pass ruff pre-commit checks Add required blank lines before method decorators in conditional blocks and format assert statement to single line per ruff formatting rules. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: handle ImportError in test_execute_one_wolfram_query When wolframalpha package is not installed, WolframAlphaAPIWrapper raises ImportError instead of ValueError. This test now catches both exceptions to properly handle the case when the optional dependency is missing. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai> Co-authored-by: Claude <noreply@anthropic.com>

* fix(a2a): guard missing task startup * Fix mypy redundant cast in A2A client * Remove assertion for started_task in client.py Removed assertions for started_task in connection logic. * test: add coverage for agent_card=None scenario in A2A client Add two new test cases to cover the branch where agent_card is None: - test_streaming_raises_when_no_task_and_no_agent_card - test_polling_raises_when_no_task_and_no_agent_card This improves patch coverage from 40% to ~100%. * fix: remove unused cast import to pass pre-commit check The cast import was no longer needed after refactoring the code to use explicit None checks instead of type casting. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Pastukhov Nikita <diementros@yandex.ru> Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai> Co-authored-by: Claude <noreply@anthropic.com>

* Documentation: fix navigation logging events * fix: misc to observability

* docs: unify DocAgent reference docs under single section * docs: unify DocAgent reference pages under a single section * docs: update Mintlify navigation and fix DocAgent links * Update mint-json-template.json.jinja * Update docagent-performance.mdx --------- Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai>

* docs: unify DocAgent reference docs under single section * docs: unify DocAgent reference pages under a single section * docs: update Mintlify navigation and fix DocAgent links * Update mint-json-template.json.jinja * Update docagent-performance.mdx * Update mint-json-template.json.jinja Corrected the docagent-performance path * docs: rename DocAgent page and fix navigation path * docs: revert DocAgent file rename to restore working navigation * Update docagent-performance.mdx --------- Co-authored-by: Priyanshu Yashwant Deshmukh <priyanshu@ag2.ai>

* fix: banner image * fix: space

* Step through run * Notebook tweak * Custom events notebook * Pre-commit tidy * Fix mermaid diagrams * Correctly detect async send * Constrain type * Conversion to dedicated iterator run functions * Update documentation * Add to init and correct docs * Correct notebook docs * Remove examples from docstrings

… into fn-target/tests-and-docs

notebook/agentchat_function_target_example.ipynb

test/agentchat/test_function_targets.py

priyansh4320

Thanks @gabriel-eidelman , nice contribution :)

codecov · 2026-01-09T16:54:42Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
see 21 files with indirect coverage changes

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

gabriel-eidelman added 2 commits December 29, 2025 10:43

implement fn target test file

86153aa

add documentation for FunctionTarget, udpate example notebook

ed37793

gabriel-eidelman requested a review from marklysze December 29, 2025 20:51

Merge branch 'main' into fn-target/tests-and-docs

f13fd32

priyansh4320 reviewed Dec 30, 2025

View reviewed changes

website/docs/user-guide/advanced-concepts/orchestration/group-chat/handoffs.mdx Outdated Show resolved Hide resolved

marklysze and others added 24 commits December 30, 2025 16:18

Update sonnet model to 4.5 (#2186)

0c99f8a

Feat/a2a hitl (#2187)

94f6ef5

* feat: add A2A Human in the loop support * chore: bump version * refactor: simplify client logic * refactor: support multiturn * lint: remove mypy ignores * tests: add Terminate human_input tests * docs: update A2A Hitl server

Update LLM configuration methods in documentation (#2195)

5bda7a9

Reorganized LLM configuration methods, the 2 parts were written oppositely

fix: chromadb and sentence-transformers package versions (#2202)

179db35

* chromadb and sentence-transformers package versions * Agent Builder test credentials * Test tweaks

feat: add gpt 5.1 , codex and search models configs (#2205)

1adb08e

DocAgent documentation fixes, documentation fix for tables (#2206)

288c09a

[Enhancement] Replace Golden_Retriever image url with simple images w…

79fb84e

…ith base64 str (#2207) * Replace Golden_Retriever image url with simple images with base64 encoding * Update tests

feat: add addr information to 404 error (#2210)

d6ae570

Add Pydantic Structured Output to OpenAICompletionsClient (#2208)

9526e48

Co-authored-by: Qingyun Wu <qingyun0327@gmail.com> Co-authored-by: Mark Sze <66362098+marklysze@users.noreply.github.com>

feat: A2A Client interceptors support (#2231)

06db078

fix: missing await on async calls and bedrock keyerror (#2221)

4c59dca

* fix: keyerror in bedrock client on format tool * fix: missing await for async call * test: integration test

Fix: Use github static image to replace wiki image for testing (#2236)

66ba706

* Use github static image to replace wiki image for testing * Correct test assert --------- Co-authored-by: Mark Sze <mark@sze.family>

Fix No Upper Bound on Dependency Version for google-sdk (#2237)

c062532

Bump version from 0.10.1 to 0.10.2 (#2239)

fe95198

feat: Route event printing through logging (#2217)

fccb58a

* feat: Route event printing through logging * add licence headers * fix: tests * fix: move code * docs: add logging events * fix: pre-commits

priyansh4320 and others added 14 commits December 30, 2025 16:18

Documentation: blogpost Logging events (#2286)

08f94cc

documentation: Blogpost MultiMCPSessionManager (#2287)

781820a

Documentation: Fix A2A Document Parsing Errors (#2281)

70ee45f

Documentation: fix navigation logging events (#2280)

9f25763

* Documentation: fix navigation logging events * fix: misc to observability

fix: banner image (#2295)

322e501

* fix: banner image * fix: space

fix: could not aprse acorn (#2279)

97989e6

fix typo

d54abea

Merge branch 'fn-target/tests-and-docs' of https://github.com/ag2ai/ag2…

255b2b6

… into fn-target/tests-and-docs

Merge branch 'main' into fn-target/tests-and-docs

b203a54

priyansh4320 requested changes Jan 6, 2026

View reviewed changes

priyansh4320 and others added 7 commits January 8, 2026 00:11

Merge branch 'main' into fn-target/tests-and-docs

478344a

Merge branch 'main' into fn-target/tests-and-docs

47242c5

fix: Documentation improve

c6d55a4

fix: filename convention

73708be

Notebook update for run and front matter

4fe0bdc

Test updates

3e33c5d

Merge branch 'main' into fn-target/tests-and-docs

777bb8e

priyansh4320 self-requested a review January 9, 2026 16:42

priyansh4320 reviewed Jan 9, 2026

View reviewed changes

priyansh4320 approved these changes Jan 9, 2026

View reviewed changes

priyansh4320 added this pull request to the merge queue Jan 9, 2026

Merged via the queue into main with commit 0659d5e Jan 9, 2026
25 checks passed

priyansh4320 deleted the fn-target/tests-and-docs branch January 9, 2026 16:54

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Tests and Documentation for FunctionTarget #2304

Add Tests and Documentation for FunctionTarget #2304

Uh oh!

gabriel-eidelman commented Dec 29, 2025 •

edited

Loading

Uh oh!

joggrbot bot commented Dec 29, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

priyansh4320 left a comment

Uh oh!

Uh oh!

codecov bot commented Jan 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

12 participants

Add Tests and Documentation for FunctionTarget #2304

Add Tests and Documentation for FunctionTarget #2304

Uh oh!

Conversation

gabriel-eidelman commented Dec 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why are these changes needed?

Checks

Uh oh!

joggrbot bot commented Dec 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📝 Documentation Analysis

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

priyansh4320 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

codecov bot commented Jan 9, 2026

Codecov Report

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

12 participants

gabriel-eidelman commented Dec 29, 2025 •

edited

Loading

joggrbot bot commented Dec 29, 2025 •

edited

Loading