К содержимому

Markdown-файл и after_run ​

Агент готовит ответ в файле, а скрипт отправляет его в хелпдеск. Токен публикации передаётся только хукам через верхнеуровневый services.

Создание задачи ​

before_run записывает путь replies/<run_id>.md в reply-path.txt. Инструкция просит агента прочитать этот путь и атомарно сохранить готовый Markdown. Отдельный путь для каждого запуска предотвращает отправку старого ответа.

py
"""Illustrative admission request, not a webhook server."""
import json
import os
from pathlib import Path
from urllib.request import Request, urlopen

body = {
    "namespace": "helpdesk",
    "external_key": "support.example.com:ticket:4821",
    "configuration": {
        "agent": {
            "profile": "default",
            "instructions": "Prepare an internal reply. Read reply-path.txt and atomically save the finished Markdown reply to that path. Do not publish it yourself.",
        },
        "sandbox": {"template": "codex"},
        "hooks": {
            "before_run": '#!/bin/sh\nset -eu\nmkdir -p replies\nprintf "replies/%s.md\\n" "$ORPHEUS_RUN_ID" > reply-path.txt\n',
            "after_run": Path(__file__).with_name("publish.py").read_text(),
        },
    },
    "env": {"TICKET_ID": "4821"},
    "services": ["helpdesk"],
    "messages": [{"text": "Ticket 4821: export permission denied. Suggest what the operator should check."}],
}
request = Request(
    os.environ["ORPHEUS_URL"].rstrip("/") + "/api/v1/sessions",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['ORPHEUS_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": "helpdesk:ticket:4821:event:105",
    },
    method="POST",
)
with urlopen(request, timeout=30) as response:
    print(response.read().decode())

Скрипт публикации ​

Сохраните рядом с create.py файл publish.py:

py
#!/usr/bin/env python3
"""Illustrative hook. Adapt the URL and payload to your helpdesk API."""
import json
import os
from pathlib import Path
from urllib.request import Request, urlopen

if os.environ.get("ORPHEUS_AGENT_STATUS") != "completed":
    raise SystemExit("Agent did not complete. No comment published.")
reply = Path(os.environ["ORPHEUS_WORKSPACE_PATH"], "replies", os.environ["ORPHEUS_RUN_ID"] + ".md")
text = reply.read_text().strip()
if not text:
    raise SystemExit("Reply file is empty.")
request = Request(
    f"{os.environ['HELPDESK_URL'].rstrip('/')}/tickets/{os.environ['TICKET_ID']}/comments",
    data=json.dumps({"body": text, "internal": True}).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['HELPDESK_TOKEN']}",
        "Content-Type": "application/json",
        "Idempotency-Key": os.environ["ORPHEUS_HOOK_OPERATION_ID"],
    },
    method="POST",
)
with urlopen(request, timeout=30) as response:
    print(f"Comment published: HTTP {response.status}")

Перед запуском задайте ORPHEUS_URL и ORPHEUS_API_KEY в окружении коннектора. Опишите сервис helpdesk на API и worker, а значения его HELPDESK_URL и HELPDESK_TOKEN передайте worker. Пример выбирает сервис только для хуков запуска. В шаблоне нужен Python 3.

Код использует условный контракт хелпдеска. Если ваша система не поддерживает Idempotency-Key, добавьте проверку опубликованного комментария перед повтором. Не считайте произвольный заголовок гарантией защиты от дублей.

Проверка ​

Проверьте обычный ответ, отсутствие файла, пустой файл и отказ API хелпдеска. При ошибке публикации изучите результат after_run в карточке запуска. Не повторяйте всю задачу вслепую: сначала выясните, был ли комментарий создан.

Выбор только для хуков в этом запросе не запрещает выбрать тот же сервис каталога для агента в другой сессии. Если токен публикации не должен попадать в выбор сервисов, учитывайте области запроса и доступность каталога.