Markdown-файл и after_run
Агент готовит ответ в файле, а скрипт отправляет его в хелпдеск. Токен публикации передаётся только хукам через верхнеуровневый services.
Создание задачи
before_run записывает путь replies/<run_id>.md в reply-path.txt. Инструкция просит агента прочитать этот путь и атомарно сохранить готовый Markdown. Отдельный путь для каждого запуска предотвращает отправку старого ответа.
"""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:
#!/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 в карточке запуска. Не повторяйте всю задачу вслепую: сначала выясните, был ли комментарий создан.
Выбор только для хуков в этом запросе не запрещает выбрать тот же сервис каталога для агента в другой сессии. Если токен публикации не должен попадать в выбор сервисов, учитывайте области запроса и доступность каталога.