Custom GPTs

Build a personal ChatGPT Custom GPT that can search and use your Obris knowledge via OpenAPI actions.

Prerequisites

Before you start, make sure you have:

• An Obris account
• An API key (generate one from the API Keys page)
• ChatGPT Plus, Teams, or Enterprise (Custom GPTs require a paid plan)

Create the GPT

1. Open ChatGPT and click Explore GPTs in the sidebar.
2. Click + Create in the top right (on mobile, tap ⋯ → Create).
3. Switch to the Configure tab.

Fill in the following fields:

Name — Give your GPT a name, for example "Obris Assistant".

Description — A short summary of what the GPT does, for example "Searches my Obris knowledge to help answer questions."

Instructions — This is where you tell the GPT what it does, how it should behave, and how to use Obris. Start with the Obris-specific instructions, then add your own below.

IMPORTANT: You have access to the user's Obris knowledge via actions. You MUST use these actions to find relevant context before answering questions.

When answering a question:
1. Call "listTopics" to see available topics.
2. Call "getTopicKnowledge" on relevant topics to retrieve curated knowledge.
3. Use the returned knowledge to ground your answer.
4. Always cite which topic and item you're pulling information from.

Relevant Obris topics for this GPT:
- [Topic name 1]: [optional description]
- [Topic name 2]: [optional description]

---

[Add your own instructions here: what the GPT does, how it should behave, things to avoid, etc.]

Replace the topic list with your actual Obris topic names and descriptions. This helps the GPT know which topics to query without listing them all every time.

IMPORTANT: You have access to the user's Obris knowledge via actions. You MUST use these actions to find relevant context before answering questions.

When answering a question:
1. Call "listTopics" to discover available topics (if not already known).
2. Identify which topics are likely relevant based on their name and description.
3. Call "getTopicKnowledge" on each relevant topic to retrieve curated knowledge.
4. Use the returned knowledge to ground your answer.
5. Always cite which topic and item you're pulling information from.

---

[Add your own instructions here: what the GPT does, how it should behave, things to avoid, etc.]

Conversation starters (optional) — Add a few example prompts to help users get started:

• "What topics do I have in Obris?"
• "Summarize the knowledge in my [topic name] topic"
• "Find knowledge related to [subject]"

Knowledge — Skip this section. Instead of uploading files directly, you'll connect to your Obris knowledge via Actions below. This way your GPT always has access to the latest content.

Add Obris actions

Scroll down to the Actions section in the Configure tab:

1. Click Create new action.
2. Under Authentication, click the gear icon and select:
   • Authentication type: API Key
   • API Key: paste your Obris API key
   • Auth Type: Custom
   • Custom Header Name: X-API-Key
3. Click Import from URL and paste the following:

https://api.obris.ai/v1/openapi/spec.json

4. Click Save.

The GPT will now have two actions available:

• listTopics (GET /v1/topics) returns all of your Obris topics
• getTopicKnowledge (GET /v1/topics/{topic_id}/knowledge) returns the curated knowledge for a specific topic

Test it

Save your GPT and start a new conversation with it. Try these prompts to verify the connection:

What topics do I have in Obris?

Summarize the knowledge in my [topic name] topic.

Find knowledge related to [subject] across my topics.

Your GPT should call the Obris actions and return results from your saved knowledge.