Occam AI Agent

[marklysze]

Why are these changes needed?

Creation of an Occam AI Agent based on the Occam SDK.

@mohamedabdelbary and @amedhatm, thanks for your support on creating this Occam agent in AG2.

Some notes regarding this agent:

• Based on the Occam SDK: https://github.com/Occam-AI/occam-sdk
• See the example in the SDK as a reference
• The agent will be initialised and parameterised upfront (not during a workflow)
• Within the workflow the agent will be called, each time it is required to reply, asynchronously and we'll loop to monitor the status of it until completion (so the workflow will wait for the agent to be complete)
• As Occam agents can perform actions that take time (such as an email management process), waiting time can be a while and the user should be made aware of this.
• Ability to Pause and Resume to be considered

Related issue number

Closes #783

• I've included any doc changes needed for https://docs.ag2.ai/. See https://docs.ag2.ai/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.

[codecov]

Codecov Report

Attention: Patch coverage is 88.88889% with 1 line in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
autogen/agents/experimental/occam/occam.py	85.71%	1 Missing ⚠️

Flag	Coverage Δ
3.10	58.45% <88.88%> (+2.46%)	⬆️
3.11	29.23% <0.00%> (?)
3.12	27.49% <0.00%> (?)
3.13	41.63% <88.88%> (+7.93%)	⬆️
3.9	40.08% <88.88%> (+6.89%)	⬆️
anthropic	16.48% <0.00%> (?)
bedrock	16.86% <0.00%> (?)
cerebras	16.57% <0.00%> (?)
cohere	16.61% <0.00%> (?)
docs	28.89% <88.88%> (+0.04%)	⬆️
falkordb	15.92% <0.00%> (?)
gemini	16.56% <0.00%> (?)
graph-rag-falkor-db	28.33% <88.88%> (+0.04%)	⬆️
groq	16.59% <0.00%> (?)
interop	29.78% <88.88%> (+0.04%)	⬆️
jupyter-executor	31.04% <88.88%> (+0.04%)	⬆️
lmm	19.44% <0.00%> (?)
long-context	15.72% <0.00%> (?)
macos-latest	58.51% <88.88%> (+2.42%)	⬆️
mistral	16.29% <0.00%> (?)
neo4j	15.91% <0.00%> (?)
ollama	16.97% <0.00%> (?)
retrievechat	29.89% <88.88%> (+0.08%)	⬆️
retrievechat-mongodb	29.89% <88.88%> (+1.32%)	⬆️
retrievechat-pgvector	29.89% <88.88%> (+1.32%)	⬆️
retrievechat-qdrant	29.83% <88.88%> (+1.35%)	⬆️
teachable	15.89% <0.00%> (?)
together	16.62% <0.00%> (?)
twilio	28.54% <88.88%> (+0.04%)	⬆️
ubuntu-latest	58.54% <88.88%> (+2.47%)	⬆️
websurfer	18.86% <0.00%> (?)
windows-latest	56.15% <88.88%> (+2.48%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
autogen/agents/experimental/occam/__init__.py	100.00% <100.00%> (ø)
autogen/agents/experimental/occam/occam.py	85.71% <85.71%> (ø)

... and 10 files with indirect coverage changes