Conversation Tags

import os
import requests

CLOUD = "https://app.all-hands.dev"
cloud_headers = {"X-Session-API-Key": os.environ["OH_API_KEY"]}

task = requests.post(
    f"{CLOUD}/api/v1/app-conversations",
    headers=cloud_headers,
    json={"initial_message": {"role": "user", "content": [{"type": "text", "text": "Hello"}]}},
).json()

# Poll until conversation is ready, then fetch conversation details
conv = requests.get(
    f"{CLOUD}/api/v1/app-conversations",
    headers=cloud_headers,
    params={"ids": conversation_id},
).json()[0]

conversation_url = conv["conversation_url"]   # full agent resource URL
session_api_key = conv["session_api_key"]
agent_headers = {"X-Session-API-Key": session_api_key}

# Read existing tags first to avoid clobbering them
existing = requests.get(conversation_url, headers=agent_headers).json()
merged_tags = {**existing.get("tags", {}), "environmenturl": "https://env.example.com", "jobid": "42"}

requests.patch(
    conversation_url,
    headers=agent_headers,
    json={"tags": merged_tags},
)

# The Cloud reflects the agent server's tags (eventually consistent)
import time
for _ in range(10):
    conv = requests.get(
        f"{CLOUD}/api/v1/app-conversations",
        headers=cloud_headers,
        params={"ids": conversation_id},
    ).json()[0]
    if conv.get("tags"):
        break
    time.sleep(2)

print(conv["tags"])
# {"environmenturl": "https://env.example.com", "jobid": "42"}

export OH_API_KEY="your-api-key"
pip install requests
python tag_conversation.py

python tag_conversation.py \
    --tag environmenturl=https://staging.example.com \
    --tag jobid=ci-run-1234 \
    --keep   # don't delete the conversation after the demo