mirror of
https://github.com/FunnyWolf/agentic-soc-platform.git
synced 2026-08-22 13:12:56 +02:00
4.1 KiB
4.1 KiB
name, description, argument-hint, compatibility, metadata
| name | description | argument-hint | compatibility | metadata | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| asp-ticket-en | Sync external tickets into ASP, attach tickets to cases, list synced tickets, or update existing ticket records. | list tickets [filters] | create ticket <uid> | attach ticket to case <case_id> | update ticket <ticket_id> <fields> | connect to asp mcp server |
|
ASP Ticket
Use this skill when the user needs to sync external tickets on ASP.
When to Use
- The user wants to create a synced external ticket record.
- The user wants to attach a ticket to a case.
- The user wants to list synced tickets by status, type, or external UID.
- The user wants to update synced ticket fields.
Operating Rules
- Treat tickets as synced external workflow records, not as the platform's main investigation object.
- Use
create_ticketto create the synced ticket record. - Use
attach_ticket_to_caseto link an existing ticket record to a case after you already have the ticket rowid. - Use
list_ticketsfor browsing and lookup. - Use
update_ticketonly for fields the user explicitly wants changed.
Decision Flow
- If the user wants to create a synced ticket record, call
create_ticket. - If the user wants to attach a ticket to a case, create the ticket when needed or retrieve the existing ticket rowid first, then call
attach_ticket_to_case. - If the user wants to browse or compare synced tickets, call
list_tickets. - If the user wants to update synced ticket fields, call
update_ticket.
SOP
List Tickets
- Extract the narrowest useful filters from the request.
- Call
list_tickets. - Parse the returned JSON strings.
- Present a compact workflow-oriented view, and surface the ticket rowid when the user will likely attach or reuse the ticket next.
Preferred response structure:
| Ticket ID | External UID | Type | Status | Title | Summary |
|---|
Then add one short explanation line when needed.
Create Ticket
- Collect the external ticket details the user wants to sync.
- Call
create_ticket. - Confirm the created ticket rowid.
- If the ticket should be linked to a case, suggest attaching it next.
Attach Ticket To Case
- Require
case_id. - If the user does not already have a ticket rowid, either call
create_ticketfor a new ticket or retrieve the existing ticket first. - Call
attach_ticket_to_case(case_id=<case_id>, ticket_rowid=<ticket_rowid>). - Confirm that the ticket is attached.
Update Ticket
- Require
ticket_id. - Extract only the fields the user explicitly wants to change.
- Call
update_ticketwith only the changed fields. - If the result is
None, state that the ticket was not found. - Confirm only the changed fields.
Preferred response structure:
Updated ticket: ticket ID or returned rowidChanged fields: only the fields sent in the requestNext useful step: optional, usually to attach it to a case or review the refreshed ticket
Clarification Rules
- Ask for
case_idonly when the user wants case attachment and did not provide it. - Ask for
ticket_idonly when the user wants to update a specific synced ticket and did not provide it. - If the user wants to create a ticket and attach it in one request, do both steps without forcing them to separate the workflow.
Output Rules
- Be concise.
- Do not output raw JSON unless the user explicitly asks for it.
- Prefer workflow wording over storage wording.
- When many tickets match, show the best subset and explain the pattern briefly.
Tip: there is no direct case_id filter for list_tickets; use list_cases(case_id=..., lazy_load=false) to inspect attached tickets when needed.
Failure Handling
- If no tickets match, say that directly and suggest the most useful refinement.
- If the target case does not exist, say that directly.
- If the target ticket does not exist, say that directly.
- If the requested update is incomplete, ask one focused follow-up instead of guessing.