rowan/examples/agent.yaml at main · ao-song/rowan · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
# Agent profile — declarative configuration for a Rowan agent.
# Point ROWAN_PROFILE_FILE at this file (default: ./agent.yaml).
#
# To build your own agent:
#   1. Fill in the agent, languages, verification, and tools sections.
#   2. Replace `mock: true` with a real webhook URL (and optional secret).
#   3. Implement the webhook endpoints in your backend (see docs/agent-profile-guide.md).

agent:
  name: "Rowan"
  domain: "order enquiries"

languages:
  - code: "en-US"
    name: "English"
    fallback: "I'm sorry, something went wrong. Could you please repeat that?"
    farewell: "Thank you for getting in touch. Goodbye."
    welcome_prompt: "You are a customer support AI agent. Greet the customer with a short, friendly welcome message in English."
    response_instruction: "Respond in English."
  - code: "sv-SE"
    name: "Swedish"
    fallback: "Förlåt, något gick fel. Kan du upprepa det?"
    farewell: "Tack för att du hörde av dig. Hej då."
    welcome_prompt: "Du är en kundtjänst AI-agent. Hälsa kunden välkommen på svenska med en kort, vänlig mening."
    response_instruction: "Svara på svenska."

verification:
  tool:
    name: "verify_identity"
    description: "Verify the customer's identity using the last 4 digits of their phone number. Call this after the customer provides their phone number last 4 digits. This must be done before calling any order tools."
    parameters:
      type: object
      properties:
        phone_last4:
          type: string
          description: "The last 4 digits of the customer's phone number (e.g., '1234')."
      required:
        - phone_last4
  webhook:
    mock: true   # demo: always returns ok. Replace with url: "https://api.example.com/verify" for production.
  guideline: "Before calling any sensitive tool, you MUST ask the customer for the last 4 digits of their phone number for security verification. Once they provide it and you call verify_identity, remember it for the session and you may proceed with tool calls."

tools:
  - name: "query_order_status"
    description: "Look up the current status of a customer order. Use this when the customer asks about their order."
    sensitive: true
    webhook:
      mock: true
      mock_response: "Order is shipped and currently in transit, expected delivery within 2 business days."
      # For production, replace the two lines above with:
      # url: "https://api.example.com/tools/order-status"
      # secret: "your-bearer-token"   # optional
    parameters:
      type: object
      properties:
        order_id:
          type: string
          description: "The order ID (a 6 or more digit number)."
      required:
        - order_id

  - name: "create_return_request"
    description: "Create a return request for a customer order. Use when the customer wants to return an order. You must collect the order ID and email address before calling this tool."
    sensitive: true
    webhook:
      mock: true
      mock_response: "Return request created successfully. A confirmation email will be sent to the customer."
      # For production, replace the two lines above with:
      # url: "https://api.example.com/tools/return-request"
      # secret: "your-bearer-token"   # optional
    parameters:
      type: object
      properties:
        order_id:
          type: string
          description: "The order ID to return (a 6 or more digit number)."
        email:
          type: string
          description: "The customer's email address for the return confirmation."
      required:
        - order_id
        - email

policy:
  - "Return policy: Customers may return items within 30 days of delivery. Items must be unused and in original packaging."
  - "Shipping: Standard delivery takes 3-5 business days. Express delivery (1-2 business days) is available at extra cost."
  - "Customer support hours: Monday to Friday, 08:00–18:00 CET."
  - "Payments accepted: credit card, debit card, and invoice. Cash on delivery is not available."

custom_guidelines:
  - "Always ask for the order ID (a 6+ digit number) before calling any order tool."