box: Add searchoptions for BoxRetriever, documentation for BoxRetriever as agent tool #30026

Job	Run time
build	14s
cd ${{ matrix.job-configs.working-directory }} / make extended_tests #${{ matrix.job-configs.python-version }}	0s
cd libs/partners/box / poetry run pytest -m compile tests/integration_tests #3.12	19s
cd . / make lint #3.9	27s
cd . / make lint #3.12	37s
cd libs/partners/box / poetry run pytest -m compile tests/integration_tests #3.9	18s
cd libs/partners/box / make lint #3.12	43s
cd libs/partners/box / make lint #3.9	58s
cd libs/partners/box / make test #3.12	23s
cd libs/partners/box / make test #3.9	22s
test-doc-imports (3.12) / check doc imports #3.12	42s
cd libs/partners/box / make test # pydantic: ~=2.7.0, python: 3.11,	27s
cd libs/partners/box / make test # pydantic: ~=2.6.0, python: 3.11,	23s
cd libs/partners/box / make test # pydantic: ~=2.5.0, python: 3.11,	22s
cd libs/partners/box / make test # pydantic: ~=2.8.0, python: 3.11,	18s
cd libs/partners/box / make test # pydantic: ~=2.9.0, python: 3.11,	19s
CI Success	1s
	6m 53s

Provide feedback