oracle / oracle/agent-spec

Run OciGenAiConfig models in the AutoGen, Agent Framework and OpenAI Agents adapters (OpenAI-compatible API)

Open
#263 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
420
Forks
60
Avg merge
9h 30m
Merged PRs (30d)
4

Description

Description

OciGenAiConfig is only executable by the WayFlow and LangGraph adapters. The adapters built on the openai SDK (AutoGen, Microsoft Agent Framework, OpenAI Agents) reject it:

NotImplementedError: LlmConfig with api_provider='oci' is not supported in autogen yet. Consider using a specific LlmConfig subclass instead.

(same message in agent_framework and openaiagents), so an Agent Spec configuration that uses OCI Generative AI is not portable across the supported runtimes.

Proposal

OCI Generative AI exposes OpenAI-compatible chat/completions and responses endpoints under <service_endpoint>/openai/v1, authenticated with an OCI request signature and an opc-compartment-id header. The three adapters can execute OciGenAiConfig by giving their OpenAI clients a signing httpx client built from the OciClientConfig (the four authentication types map onto the httpx.Auth implementations of the oci-openai package), with the compartment header, and by mapping api_type to chat completions or the Responses API where the runtime supports it. The runtime-to-Agent-Spec converters should rebuild the OciGenAiConfig from such clients.

Known limits of that API to handle explicitly: Cohere models and the DEDICATED serving mode are not served; the Responses API needs OpenAI models or a conversation store; the endpoint negotiates zstd and compresses streamed chunks as independent frames that httpx cannot decode (gzip works).

Environment

  • pyagentspec main (26.4.0.dev0), autogen-core 0.7.4, agent-framework-core 1.13.0, openai-agents 0.19.4

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by comparing the existing OciGenAiConfig support in the WayFlow and LangGraph adapters with the OpenAI SDK adapters for AutoGen, Microsoft Agent Framework, and OpenAI Agents. Trace OciClientConfig, the signing httpx client, and the runtime-to-Agent-Spec converters; done means all three adapters execute OCI configurations and rebuild them correctly while handling the stated API limitations.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
ai, api, backend-api-design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.