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 70.58824% with 5 lines in your changes missing coverage. Please review.

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

❗ There is a different number of reports uploaded between BASE (bb8b41a) and HEAD (cfa7c5e). Click for more details.

HEAD has 1201 uploads less than BASE

Flag	BASE (bb8b41a)	HEAD (cfa7c5e)
3.13	84	0
ubuntu-latest	138	1
commsagent-discord	7	0
optional-deps	137	0
browser-use	7	0
macos-latest	104	0
3.9	73	0
commsagent-slack	9	0
windows-latest	104	0
core-without-llm	9	1
3.11	62	1
3.10	92	0
commsagent-telegram	9	0
3.12	35	0
jupyter-executor	9	0
retrievechat-pgvector	10	0
graph-rag-falkor-db	6	0
retrievechat-qdrant	11	0
retrievechat-mongodb	10	0
twilio	9	0
gpt-assistant-agent	3	0
anthropic	16	0
gemini	14	0
teachable	4	0
retrievechat	10	0
lmm	4	0
websurfer	15	0
cerebras	14	0
interop	13	0
agent-eval	1	0
cohere	15	0
groq	14	0
llama-index-agent	3	0
retrievechat-couchbase	3	0
core-llm	3	0
deepseek	1	0
openai	1	0
integration	12	0
crawl4ai	13	0
falkordb	2	0
autobuild	1	0
docs	6	0
interop-crewai	9	0
interop-langchain	9	0
websockets	9	0
interop-pydantic-ai	9	0
neo4j	2	0
mistral	14	0
ollama	14	0
together	14	0
long-context	3	0
bedrock	14	0
reasoning	14	0

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

... and 62 files with indirect coverage changes

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ davorrunje
✅ marklysze
❌ mohamedabdelbary
_{You have signed the CLA already but the status is still pending? Let us recheck it.}