Create your Hypergraph

import os
import requests

API_KEY = os.environ["RIPPLETIDE_API_KEY"]
BASE_URL = "https://agent.rippletide.com/api/sdk"
headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}

# Create the agent
response = requests.post(f"{BASE_URL}/agent", headers=headers, json={
    "name": "order-taking-agent",
    "prompt": "You are an order-taking assistant for an electronics store. Help customers choose products, place orders, and track deliveries."
})
agent_id = response.json()["id"]
print(f"Agent created: {agent_id}")

qa_pairs = [
    {
        "question": "What products can be ordered?",
        "answer": "You can order our latest Samsung TV RED43."
    },
    {
        "question": "What is the price?",
        "answer": "The Samsung TV RED43 costs $990."
    },
    {
        "question": "How long will it take for my order to be delivered?",
        "answer": "Your Samsung TV can be delivered the next day."
    }
]

for qa in qa_pairs:
    requests.post(f"{BASE_URL}/q-and-a", headers=headers, json={
        "question": qa["question"],
        "answer": qa["answer"],
        "agent_id": agent_id
    })

# Create tags
tags = {}
for tag_name, description in [
    ("high-tech-products", "All products in the high-tech category"),
    ("pricing", "Product prices and discounts"),
    ("delivery", "Delivery dates and shipping information"),
    ("discount", "All types of discounts that can apply on products"),
]:
    resp = requests.post(f"{BASE_URL}/tag", headers=headers, json={
        "name": tag_name,
        "description": description
    })
    tags[tag_name] = resp.json()["id"]

# Link Q&A pairs to tags
# Example: link the pricing Q&A to "high-tech-products" and "pricing" tags
requests.post(f"{BASE_URL}/q-and-a-tag", headers=headers, json={
    "q_and_a_id": "<qa-id-for-price-question>",
    "tag_id": tags["pricing"]
})

actions = [
    {
        "name": "answer_product_question",
        "description": "Answer a question about a product",
        "what_to_do": "Look up the product in the knowledge base and provide accurate information. Requirement: access to the product documentation."
    },
    {
        "name": "add_to_cart",
        "description": "Add a product to the cart",
        "what_to_do": "Add the selected product to the user's cart. Requirement: at least one product must be chosen."
    },
    {
        "name": "checkout",
        "description": "Process checkout",
        "what_to_do": "Process the order checkout. Requirements: at least one product in the cart, discount has been applied if applicable."
    },
    {
        "name": "open_ticket",
        "description": "Open a support ticket when the agent cannot answer",
        "what_to_do": "Create a support ticket for human follow-up. Requirement: collect a contact method (email or phone)."
    },
    {
        "name": "book_meeting",
        "description": "Book a meeting with a sales person",
        "what_to_do": "Schedule a meeting with an available sales person. Requirement: check sales person availability."
    }
]

for action in actions:
    requests.post(f"{BASE_URL}/action", headers=headers, json={
        "agent_id": agent_id,
        **action
    })

state_predicate = {
    "transition_kind": "branch",
    "question_to_evaluate": "What is the user trying to do?",
    "possible_values": ["browse_products", "checkout", "change_delivery"],
    "re_evaluate": True,
    "value_to_node": {
        "browse_products": {
            "transition_kind": "branch",
            "question_to_evaluate": "Has the user chosen a product?",
            "possible_values": ["yes", "no"],
            "value_to_node": {
                "yes": {
                    "transition_kind": "end",
                    "question_to_evaluate": "Great choice! Would you like to add it to your cart?"
                },
                "no": {
                    "transition_kind": "end",
                    "question_to_evaluate": "Let me recommend some products based on your needs."
                }
            }
        },
        "checkout": {
            "transition_kind": "end",
            "question_to_evaluate": "I'll help you complete your purchase."
        },
        "change_delivery": {
            "transition_kind": "branch",
            "question_to_evaluate": "Has the order already been shipped?",
            "possible_values": ["yes", "no"],
            "value_to_node": {
                "yes": {
                    "transition_kind": "end",
                    "question_to_evaluate": "The order has already shipped. Please contact support for address changes."
                },
                "no": {
                    "transition_kind": "end",
                    "question_to_evaluate": "What is the new delivery address?"
                }
            }
        }
    }
}

requests.put(f"{BASE_URL}/state-predicate/{agent_id}", headers=headers, json={
    "state_predicate": state_predicate
})

guardrails = [
    "Never reveal internal pricing logic or discount algorithms.",
    "Always direct customers to official policies for legal matters.",
    "Do not process orders for customers who have not confirmed their delivery address."
]

for instruction in guardrails:
    requests.post(f"{BASE_URL}/guardrail", headers=headers, json={
        "agent_id": agent_id,
        "type": "action",
        "instruction": instruction
    })