How to Summarise Linear with OpenAI Agents SDK

import os

import requests
from agents import Agent, Runner, function_tool

ENCONVERT_API_KEY = os.environ["ENCONVERT_API_KEY"]
# A Linear issue or project URL that opens without signing in. Distill renders
# the page in a headless browser with no session, so a login wall returns nothing.
LINEAR_URL = os.environ["LINEAR_URL"]


@function_tool
def summarise_linear_page(url: str) -> str:
    """Takes a Linear issue or project URL and returns a clean summary of its
    title, description, and comment thread.

    Args:
        url: The Linear issue or project URL to summarise.
    """
    # Step 1: Summarise the Linear page with EnConvert Distill
    response = requests.post(
        "https://api.enconvert.com/v2/distill",
        headers={
            "X-API-Key": ENCONVERT_API_KEY,
            "Content-Type": "application/json",
        },
        json={
            "urls": [url],
            "schema": {
                "summary": (
                    "a thorough summary of the page, covering its title, "
                    "its description, and the discussion in its comment thread"
                ),
            },
        },
        timeout=60,
    )
    response.raise_for_status()

    item = response.json()["results"][0]
    summary = (item.get("data") or {}).get("summary")
    if item.get("error") or not summary:
        reason = item.get("error") or item.get("warnings") or "no summary extracted"
        raise RuntimeError(f"Distill failed for {url}: {reason}")
    return summary


# Step 2: Give the tool to an OpenAI Agents SDK agent
# (the SDK reads OPENAI_API_KEY from the environment)
agent = Agent(
    name="Linear Assistant",
    instructions=(
        "You help engineering teams understand their Linear work. "
        "Use the summarise_linear_page tool to read a Linear URL before answering."
    ),
    tools=[summarise_linear_page],
)

result = Runner.run_sync(
    agent,
    f"Summarise {LINEAR_URL} and list any open questions in its comment thread.",
)
print(result.final_output)