Skip to content

Commit 1c81a87

Browse files
OpheliaLjhOpheliaLjh
authored
Merge pull request #8 from oracle-samples/rename-agenthub-to-enterprise-ai-agents
Rename AgentHub to OCI Enterprise AI Agents
2 parents 375640b + 708805a commit 1c81a87

59 files changed

Lines changed: 194 additions & 194 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The **OCI GenAI Auth** Python library provides OCI request-signing helpers for t
1010
- [Installation](#installation)
1111
- [Using OCI IAM Auth](#using-oci-iam-auth)
1212
- [Using API Key Auth](#using-api-key-auth)
13-
- [Using AgentHub APIs](#using-agenthub-apis)
13+
- [Using OCI Enterprise AI Agents APIs](#using-oci-enterprise-ai-agents-apis)
1414
- [Examples](#examples)
1515
- [Contributing](#contributing)
1616
- [Security](#security)
@@ -58,17 +58,17 @@ client = OpenAI(
5858
)
5959
```
6060

61-
## Using AgentHub APIs
61+
## Using OCI Enterprise AI Agents APIs
6262

63-
OCI AgentHub provides a unified API for interacting with models and agentic capabilities.
63+
OCI Enterprise AI Agents provides a unified API for interacting with models and agentic capabilities.
6464

6565
- 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.
6666
- 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.
6767
- 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.
6868

69-
In addition to the compatible endpoint to Responses API, AgentHub also offers compatible endpoints to Files API, Vector Stores API, and Containers API.
69+
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.
7070

71-
Explore [examples](https://github.com/oracle-samples/oci-genai-auth-python/tree/main/examples/agenthub) to get started.
71+
Explore [examples](https://github.com/oracle-samples/oci-genai-auth-python/tree/main/examples/enterprise_ai_agents) to get started.
7272

7373
Note: OpenAI commercial models and image generation are only available to Oracle internal teams at this moment.
7474

‎examples/agenthub/README.md‎

Lines changed: 0 additions & 75 deletions
This file was deleted.

‎examples/enterprise_ai_agents/README.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# OCI Enterprise AI Agents Examples
2+
3+
This folder contains examples for OCI Enterprise AI Agents APIs using the OpenAI Python SDK.
4+
5+
## Prerequisites
6+
7+
1. Install dependencies:
8+
9+
```bash
10+
pip install -e '.[dev]'
11+
```
12+
13+
2. Configure shared values in `examples/enterprise_ai_agents/common.py`:
14+
- `PROFILE_NAME`
15+
- `COMPARTMENT_ID`
16+
- `PROJECT_OCID`
17+
- `REGION`
18+
19+
3. (Optional) You can override project at runtime:
20+
21+
```bash
22+
export OCI_GENAI_PROJECT_ID=<your_project_ocid>
23+
```
24+
25+
4. If running API-key based examples, set:
26+
27+
```bash
28+
export OPENAI_API_KEY=<your_oci_genai_api_key>
29+
```
30+
31+
## How to run
32+
33+
From repository root, run any example module with `python -m`.
34+
35+
Quickstarts:
36+
37+
```bash
38+
python -m examples.enterprise_ai_agents.quickstart_responses_create_oci_iam
39+
python -m examples.enterprise_ai_agents.quickstart_responses_create_api_key
40+
```
41+
42+
Responses API examples:
43+
44+
```bash
45+
python -m examples.enterprise_ai_agents.responses.create_response
46+
python -m examples.enterprise_ai_agents.responses.streaming_text_delta
47+
python -m examples.enterprise_ai_agents.responses.structured_output
48+
python -m examples.enterprise_ai_agents.responses.use_gpt_model
49+
python -m examples.enterprise_ai_agents.responses.use_google_gemini_model
50+
```
51+
52+
Tools examples:
53+
54+
```bash
55+
python -m examples.enterprise_ai_agents.tools.function_calling
56+
python -m examples.enterprise_ai_agents.tools.web_search
57+
python -m examples.enterprise_ai_agents.tools.code_interpreter
58+
```
59+
60+
Other categories follow the same pattern:
61+
62+
```bash
63+
python -m examples.enterprise_ai_agents.agents.basic_agents_example
64+
python -m examples.enterprise_ai_agents.multiturn.responses_chaining
65+
python -m examples.enterprise_ai_agents.memory.long_term_memory
66+
python -m examples.enterprise_ai_agents.mcp.create_responses_mcp
67+
python -m examples.enterprise_ai_agents.vector_stores.vector_stores_crud
68+
python -m examples.enterprise_ai_agents.files.files_crud
69+
python -m examples.enterprise_ai_agents.function.create_responses_fc
70+
```
71+
72+
## Notes
73+
74+
- Most examples use IAM signing through `oci-genai-auth`.
75+
- OCI Enterprise AI Agents examples use OpenAI-compatible `/openai/v1` endpoints and require a project OCID.

examples/agenthub/__init__.py renamed to examples/enterprise_ai_agents/__init__.py

File renamed without changes.

examples/agenthub/agents/basic_agents_example.py renamed to examples/enterprise_ai_agents/agents/basic_agents_example.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
33

44

5-
"""Demonstrates using OpenAI Agents SDK against the AgentHub endpoint."""
5+
"""Demonstrates using OpenAI Agents SDK against the OCI Enterprise AI Agents endpoint."""
66

77
import asyncio
88
from agents import Agent, Runner, set_default_openai_client, set_tracing_disabled
9-
from examples.agenthub import common
9+
from examples.enterprise_ai_agents import common
1010

11-
set_default_openai_client(common.build_agenthub_async_client())
11+
set_default_openai_client(common.build_enterprise_ai_agents_async_client())
1212
set_tracing_disabled(True)
1313

1414
async def main():

examples/agenthub/common.py renamed to examples/enterprise_ai_agents/common.py

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Copyright (c) 2026 Oracle and/or its affiliates.
22
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
33

4-
"""AgentHub example clients and configuration."""
4+
"""OCI Enterprise AI Agents example clients and configuration."""
55

66
from __future__ import annotations
77

@@ -18,31 +18,31 @@
1818
PROJECT_OCID = "<<ENTER_PROJECT_ID>>"
1919
REGION = "us-chicago-1"
2020

21-
AGENTHUB_URL = f"https://inference.generativeai.{REGION}.oci.oraclecloud.com/openai/v1"
22-
AGENTHUB_CP_URL = f"https://generativeai.{REGION}.oci.oraclecloud.com/20231130/openai/v1"
21+
ENTERPRISE_AI_AGENTS_URL = f"https://inference.generativeai.{REGION}.oci.oraclecloud.com/openai/v1"
22+
ENTERPRISE_AI_AGENTS_CP_URL = f"https://generativeai.{REGION}.oci.oraclecloud.com/20231130/openai/v1"
2323

2424

25-
def build_agenthub_client() -> OpenAI:
25+
def build_enterprise_ai_agents_client() -> OpenAI:
2626
return OpenAI(
27-
base_url=AGENTHUB_URL,
27+
base_url=ENTERPRISE_AI_AGENTS_URL,
2828
api_key="not-used",
2929
project=os.getenv("OCI_GENAI_PROJECT_ID", PROJECT_OCID),
3030
http_client=httpx.Client(auth=OciSessionAuth(profile_name=PROFILE_NAME)),
3131
)
3232

3333

34-
def build_agenthub_async_client() -> AsyncOpenAI:
34+
def build_enterprise_ai_agents_async_client() -> AsyncOpenAI:
3535
return AsyncOpenAI(
36-
base_url=AGENTHUB_URL,
36+
base_url=ENTERPRISE_AI_AGENTS_URL,
3737
api_key="not-used",
3838
project=os.getenv("OCI_GENAI_PROJECT_ID", PROJECT_OCID),
3939
http_client=httpx.AsyncClient(auth=OciSessionAuth(profile_name=PROFILE_NAME)),
4040
)
4141

4242

43-
def build_agenthub_cp_client() -> OpenAI:
43+
def build_enterprise_ai_agents_cp_client() -> OpenAI:
4444
return OpenAI(
45-
base_url=AGENTHUB_CP_URL,
45+
base_url=ENTERPRISE_AI_AGENTS_CP_URL,
4646
api_key="not-used",
4747
http_client=httpx.Client(auth=OciSessionAuth(profile_name=PROFILE_NAME)),
4848
project=os.getenv("OCI_GENAI_PROJECT_ID", PROJECT_OCID),

examples/agenthub/converstions/conversation_items_crud.py renamed to examples/enterprise_ai_agents/converstions/conversation_items_crud.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# Copyright (c) 2026 Oracle and/or its affiliates.
22
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
33

4-
"""Demonstrates CRUD operations for conversation items in AgentHub."""
4+
"""Demonstrates CRUD operations for conversation items in OCI Enterprise AI Agents."""
55

6-
from examples.agenthub import common
6+
from examples.enterprise_ai_agents import common
77

88

99
def main():
1010
# Create an empty conversation
11-
cp_client = common.build_agenthub_client()
11+
cp_client = common.build_enterprise_ai_agents_client()
1212
conversation = cp_client.conversations.create()
1313
print("\nCreated conversation:", conversation)
1414

examples/agenthub/converstions/conversations_crud.py renamed to examples/enterprise_ai_agents/converstions/conversations_crud.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
# Copyright (c) 2026 Oracle and/or its affiliates.
22
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
33

4-
"""Demonstrates CRUD operations for conversations in AgentHub."""
4+
"""Demonstrates CRUD operations for conversations in OCI Enterprise AI Agents."""
55

6-
from examples.agenthub import common
6+
from examples.enterprise_ai_agents import common
77

88

99
def main():
10-
client = common.build_agenthub_client()
10+
client = common.build_enterprise_ai_agents_client()
1111

1212
# Create a conversation
1313
conversation = client.conversations.create(

examples/agenthub/files/__init__.py renamed to examples/enterprise_ai_agents/files/__init__.py

File renamed without changes.

examples/agenthub/files/files_crud.py renamed to examples/enterprise_ai_agents/files/files_crud.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@
55

66
from pathlib import Path
77

8-
from examples.agenthub import common
8+
from examples.enterprise_ai_agents import common
99

1010

1111
def main():
12-
client = common.build_agenthub_client()
12+
client = common.build_enterprise_ai_agents_client()
1313
# List files in the project
1414
files_list = client.files.list(order="asc")
1515
for file in files_list.data:

0 commit comments

Comments
 (0)