Support o1 developer message format

[dirkbrnd]

Description

OpenAI's o1 model requires system messages to be developer messages going forward. This change is backwards compatible with older models.

Fixes #1621

Note We don't yet have access to o1, so we cannot confirm whether o1 itself works yet. This only paves the way for it.

Type of change

Please check the options that are relevant:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Model update
• Infrastructure change

Checklist

• My code follows Phidata's style guidelines and best practices
• I have performed a self-review of my code
• I have added docstrings and comments for complex logic
• My changes generate no new warnings or errors
• I have added cookbook examples for my new addition (if needed)
• I have updated requirements.txt/pyproject.toml (if needed)
• I have verified my changes in a clean environment

[manthanguptaa]

This lools good but my only concern is that we can't test it with o1 yet because of not having access to it

[dirkbrnd]

This lools good but my only concern is that we can't test it with o1 yet because of not having access to it

This is true, but this allows users that already have o1 to atleast continue, which is the case for the user that raised the issue. We can confirm with them that it works. According to OpenAI and other articles, this should be the only required change. And we can confirm it works on older models, so we know we have the interface correct.

[manthanguptaa]

tested against sambanova, together, and openai cookbooks and this working perfectly

[gauravdhiman]

@dirkbrnd / @manthanguptaa This change broke the Deepseek and I think will break other OpenAILike models.
with v2.7.7 getting below error when using Deepseek, saying "unknown variant developer`"
with 2.7.6, it works fine with Deepseek.

error:

  File "/Users/gauravdhiman/projects/python/ai/playgrounds/kokoro-onnx-tts/.venv-kokoro-onnx-tts/lib/python3.12/site-packages/openai/_base_client.py", line 1064, in _request
    raise self._make_status_error_from_response(err.response) from None
openai.UnprocessableEntityError: Failed to deserialize the JSON body into the target type: messages[0].role: unknown variant `developer`, expected one of `system`, `user`, `assistant`, `tool` at line 1 column 34

Did not try other providers, but with deepseek I can see above issue.

[dirkbrnd]

Thanks for raising, we have merged a fix. Releasing with 2.7.8.