Rename AgentHub to OCI Enterprise AI Agents

README.md

@@ -10,7 +10,7 @@ The **OCI GenAI Auth** Python library provides OCI request-signing helpers for t
 - [Installation](#installation)
 - [Using OCI IAM Auth](#using-oci-iam-auth)
 - [Using API Key Auth](#using-api-key-auth)
-- [Using AgentHub APIs](#using-agenthub-apis)
+- [Using OCI Enterprise AI Agents APIs](#using-oci-enterprise-ai-agents-apis)
 - [Examples](#examples)
 - [Contributing](#contributing)
 - [Security](#security)
@@ -58,17 +58,17 @@ client = OpenAI(
 )
 ```
 
-## Using AgentHub APIs
+## Using OCI Enterprise AI Agents APIs
 
-OCI AgentHub provides a unified API for interacting with models and agentic capabilities.
+OCI Enterprise AI Agents provides a unified API for interacting with models and agentic capabilities.
 
 - It is compatible with OpenAI's Responses API and the [Open Responses Spec](https://www.openresponses.org/specification), enabling developers to build agents with OpenAI SDK, OpenAI Agents SDK, LangChain, LangGraph, AI SDK, CrewAI, and more.
 - It offers a uniform interface, auth, billing to access multiple model providers including OpenAI, Gemini, xAI, and GPT-OSS models hosted in OCI and your Dedicated AI Cluster.
 - It provides built-in agentic primitives such as agent loop, reasoning, short-term memory, long-term memory, web search, file search, image generation, code execution, and more.
 
-In addition to the compatible endpoint to Responses API, AgentHub also offers compatible endpoints to Files API, Vector Stores API, and Containers API.
+In addition to the compatible endpoint to Responses API, OCI Enterprise AI Agents also offers compatible endpoints to Files API, Vector Stores API, and Containers API.
 
-Explore [examples](https://github.com/oracle-samples/oci-genai-auth-python/tree/main/examples/agenthub) to get started.
+Explore [examples](https://github.com/oracle-samples/oci-genai-auth-python/tree/main/examples/enterprise_ai_agents) to get started.
 
 Note: OpenAI commercial models and image generation are only available to Oracle internal teams at this moment.
 

examples/enterprise_ai_agents/README.md

@@ -0,0 +1,75 @@
+# OCI Enterprise AI Agents Examples
+
+This folder contains examples for OCI Enterprise AI Agents APIs using the OpenAI Python SDK.
+
+## Prerequisites
+
+1. Install dependencies:
+
+   ```bash
+   pip install -e '.[dev]'
+   ```
+
+2. Configure shared values in `examples/enterprise_ai_agents/common.py`:
+   - `PROFILE_NAME`
+   - `COMPARTMENT_ID`
+   - `PROJECT_OCID`
+   - `REGION`
+
+3. (Optional) You can override project at runtime:
+
+   ```bash
+   export OCI_GENAI_PROJECT_ID=<your_project_ocid>
+   ```
+
+4. If running API-key based examples, set:
+
+   ```bash
+   export OPENAI_API_KEY=<your_oci_genai_api_key>
+   ```
+
+## How to run
+
+From repository root, run any example module with `python -m`.
+
+Quickstarts:
+
+```bash
+python -m examples.enterprise_ai_agents.quickstart_responses_create_oci_iam
+python -m examples.enterprise_ai_agents.quickstart_responses_create_api_key
+```
+
+Responses API examples:
+
+```bash
+python -m examples.enterprise_ai_agents.responses.create_response
+python -m examples.enterprise_ai_agents.responses.streaming_text_delta
+python -m examples.enterprise_ai_agents.responses.structured_output
+python -m examples.enterprise_ai_agents.responses.use_gpt_model
+python -m examples.enterprise_ai_agents.responses.use_google_gemini_model
+```
+
+Tools examples:
+
+```bash
+python -m examples.enterprise_ai_agents.tools.function_calling
+python -m examples.enterprise_ai_agents.tools.web_search
+python -m examples.enterprise_ai_agents.tools.code_interpreter
+```
+
+Other categories follow the same pattern:
+
+```bash
+python -m examples.enterprise_ai_agents.agents.basic_agents_example
+python -m examples.enterprise_ai_agents.multiturn.responses_chaining
+python -m examples.enterprise_ai_agents.memory.long_term_memory
+python -m examples.enterprise_ai_agents.mcp.create_responses_mcp
+python -m examples.enterprise_ai_agents.vector_stores.vector_stores_crud
+python -m examples.enterprise_ai_agents.files.files_crud
+python -m examples.enterprise_ai_agents.function.create_responses_fc
+```
+
+## Notes
+
+- Most examples use IAM signing through `oci-genai-auth`.
+- OCI Enterprise AI Agents examples use OpenAI-compatible `/openai/v1` endpoints and require a project OCID.

examples/agenthub/agents/basic_agents_example.py → examples/enterprise_ai_agents/agents/basic_agents_example.py

@@ -2,13 +2,13 @@
 # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
 
 
-"""Demonstrates using OpenAI Agents SDK against the AgentHub endpoint."""
+"""Demonstrates using OpenAI Agents SDK against the OCI Enterprise AI Agents endpoint."""
 
 import asyncio
 from agents import Agent, Runner, set_default_openai_client, set_tracing_disabled
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
-set_default_openai_client(common.build_agenthub_async_client())
+set_default_openai_client(common.build_enterprise_ai_agents_async_client())
 set_tracing_disabled(True)
 
 async def main():

examples/agenthub/common.py → examples/enterprise_ai_agents/common.py

@@ -1,7 +1,7 @@
 # Copyright (c) 2026 Oracle and/or its affiliates.
 # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
 
-"""AgentHub example clients and configuration."""
+"""OCI Enterprise AI Agents example clients and configuration."""
 
 from __future__ import annotations
 
@@ -18,31 +18,31 @@
 PROJECT_OCID = "<<ENTER_PROJECT_ID>>"
 REGION = "us-chicago-1"
 
-AGENTHUB_URL = f"https://inference.generativeai.{REGION}.oci.oraclecloud.com/openai/v1"
-AGENTHUB_CP_URL = f"https://generativeai.{REGION}.oci.oraclecloud.com/20231130/openai/v1"
+ENTERPRISE_AI_AGENTS_URL = f"https://inference.generativeai.{REGION}.oci.oraclecloud.com/openai/v1"
+ENTERPRISE_AI_AGENTS_CP_URL = f"https://generativeai.{REGION}.oci.oraclecloud.com/20231130/openai/v1"
 
 
-def build_agenthub_client() -> OpenAI:
+def build_enterprise_ai_agents_client() -> OpenAI:
     return OpenAI(
-        base_url=AGENTHUB_URL,
+        base_url=ENTERPRISE_AI_AGENTS_URL,
         api_key="not-used",
         project=os.getenv("OCI_GENAI_PROJECT_ID", PROJECT_OCID),
         http_client=httpx.Client(auth=OciSessionAuth(profile_name=PROFILE_NAME)),
     )
 
 
-def build_agenthub_async_client() -> AsyncOpenAI:
+def build_enterprise_ai_agents_async_client() -> AsyncOpenAI:
     return AsyncOpenAI(
-        base_url=AGENTHUB_URL,
+        base_url=ENTERPRISE_AI_AGENTS_URL,
         api_key="not-used",
         project=os.getenv("OCI_GENAI_PROJECT_ID", PROJECT_OCID),
         http_client=httpx.AsyncClient(auth=OciSessionAuth(profile_name=PROFILE_NAME)),
     )
 
 
-def build_agenthub_cp_client() -> OpenAI:
+def build_enterprise_ai_agents_cp_client() -> OpenAI:
     return OpenAI(
-        base_url=AGENTHUB_CP_URL,
+        base_url=ENTERPRISE_AI_AGENTS_CP_URL,
         api_key="not-used",
         http_client=httpx.Client(auth=OciSessionAuth(profile_name=PROFILE_NAME)),
         project=os.getenv("OCI_GENAI_PROJECT_ID", PROJECT_OCID),

examples/agenthub/converstions/conversation_items_crud.py → examples/enterprise_ai_agents/converstions/conversation_items_crud.py

@@ -1,14 +1,14 @@
 # Copyright (c) 2026 Oracle and/or its affiliates.
 # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
 
-"""Demonstrates CRUD operations for conversation items in AgentHub."""
+"""Demonstrates CRUD operations for conversation items in OCI Enterprise AI Agents."""
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 
 def main():
     # Create an empty conversation
-    cp_client = common.build_agenthub_client()
+    cp_client = common.build_enterprise_ai_agents_client()
     conversation = cp_client.conversations.create()
     print("\nCreated conversation:", conversation)
 

examples/agenthub/converstions/conversations_crud.py → examples/enterprise_ai_agents/converstions/conversations_crud.py

@@ -1,13 +1,13 @@
 # Copyright (c) 2026 Oracle and/or its affiliates.
 # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
 
-"""Demonstrates CRUD operations for conversations in AgentHub."""
+"""Demonstrates CRUD operations for conversations in OCI Enterprise AI Agents."""
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 
 def main():
-    client = common.build_agenthub_client()
+    client = common.build_enterprise_ai_agents_client()
 
     # Create a conversation
     conversation = client.conversations.create(

examples/agenthub/files/files_crud.py → examples/enterprise_ai_agents/files/files_crud.py

@@ -5,11 +5,11 @@
 
 from pathlib import Path
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 
 def main():
-    client = common.build_agenthub_client()
+    client = common.build_enterprise_ai_agents_client()
     # List files in the project
     files_list = client.files.list(order="asc")
     for file in files_list.data:

examples/agenthub/function/create_response_fc_parallel_tool.py → examples/enterprise_ai_agents/function/create_response_fc_parallel_tool.py

@@ -5,14 +5,14 @@
 
 from rich import print
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 from examples.fc_tools import fc_tools
 
 MODEL = "xai.grok-4-1-fast-reasoning"
 
 
 def main():
-    openai_client = common.build_agenthub_client()
+    openai_client = common.build_enterprise_ai_agents_client()
     # parrel_call
     response = openai_client.responses.create(
         model=MODEL,

examples/agenthub/function/create_responses_fc.py → examples/enterprise_ai_agents/function/create_responses_fc.py

@@ -9,14 +9,14 @@
 from openai.types.responses.response_input_param import FunctionCallOutput
 from rich import print
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 from examples.fc_tools import execute_function_call, fc_tools
 
 MODEL = "xai.grok-4-1-fast-reasoning"
 
 
 def main():
-    openai_client = common.build_agenthub_client()
+    openai_client = common.build_enterprise_ai_agents_client()
 
     # Creates first request
     response = openai_client.responses.create(

examples/agenthub/mcp/create_response_approval_flow.py → examples/enterprise_ai_agents/mcp/create_response_approval_flow.py

@@ -5,13 +5,13 @@
 
 from rich import print
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 MODEL = "xai.grok-4-1-fast-reasoning"
 
 
 def main():
-    openai_client = common.build_agenthub_client()
+    openai_client = common.build_enterprise_ai_agents_client()
 
     tools = [
         {

examples/agenthub/mcp/create_response_two_mcp.py → examples/enterprise_ai_agents/mcp/create_response_two_mcp.py

@@ -5,13 +5,13 @@
 
 from rich import print
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 MODEL = "xai.grok-4-1-fast-reasoning"
 
 
 def main():
-    openai_client = common.build_agenthub_client()
+    openai_client = common.build_enterprise_ai_agents_client()
 
     tools = [
         {

examples/agenthub/mcp/create_responses_mcp.py → examples/enterprise_ai_agents/mcp/create_responses_mcp.py

@@ -5,13 +5,13 @@
 
 from rich import print
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 MODEL = "xai.grok-4-1-fast-reasoning"
 
 
 def main():
-    openai_client = common.build_agenthub_client()
+    openai_client = common.build_enterprise_ai_agents_client()
 
     tools = [
         {

examples/agenthub/mcp/create_responses_mcp_auth.py → examples/enterprise_ai_agents/mcp/create_responses_mcp_auth.py

@@ -5,13 +5,13 @@
 
 from rich import print
 
-from examples.agenthub import common
+from examples.enterprise_ai_agents import common
 
 MODEL = "xai.grok-4-1-fast-reasoning"
 
 
 def main():
-    openai_client = common.build_agenthub_client()
+    openai_client = common.build_enterprise_ai_agents_client()
 
     tools = [
         {