Honee – cruise · honeefy

Asks the provider's cruise advisor for a short, honest opinion on ONE offer from find_cruises: overall fit, or which cabin category or fare suits the travellers. Use it ONLY when the user asks about ONE specific offer ('is this right for me', 'which cabin', 'which fare') -- not after every find_cruises and never for a whole list. Quote the opinion as the advisor's. It does NOT search, book or compare several offers; it is limited to a few calls per consultation.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "cruise_id": {
      "type": "string",
      "description": "cruise_id of an offer returned by find_cruises."
    },
    "focus": {
      "type": "string",
      "enum": [
        "overall",
        "cabins",
        "fares"
      ],
      "description": "What the opinion should focus on."
    },
    "travellers": {
      "type": "string",
      "description": "Optional short description of the travel party, e.g. 'couple, first cruise'."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": [
    "cruise_id"
  ]
}

Returns the provider's own statement on booking: who the tour operator is, who acts as agent, how the customer's payment is protected (insolvency cover), how payment and cancellation work -- plus links to the legal pages. Use it when the user asks whether booking here is safe, who they are contracting with, or how payment is protected. It does NOT give legal advice and returns nothing if the provider has not published these facts.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": []
}

Returns the consulting profile of a cruise line: who it suits, who it suits less, its style and fleet. Use it when the user asks which cruise line fits them or what a line is like. It does NOT return prices, offers or booking conditions.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "cruise_line": {
      "type": "string",
      "description": "Cruise line name, e.g. 'MSC Cruises'."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": [
    "cruise_line"
  ]
}

Searches the provider's LIVE, bookable sea and river cruise offers for a destination, a travel period and a travel party. Use it whenever the user asks about cruise offers, prices, dates or availability, wants to see, compare or book cruises: prices and availability change several times a day and this tool has the live availability for the traveller's party. Requires adults, period (or from_date/to_date) and destination — if any is missing, unusable or not a region this provider can search, the result lists a question for it and no search runs; ask the user, then call again with the same handle. For river cruises pass cruise_type='river' (a river name such as 'Danube' is recognised too). Sea cruises are shown WITHOUT a flight package by default; pass flight='with' to get the flight packages instead. Returns a summary plus up to 10 offers with cruise_id, ship, cruise line, dates, nights, price with currency (per person; for families the cabin total for the whole party where the provider computes it) and the booking link. Where the provider supports it, availability is checked LIVE for the top offers and each says whether it is confirmed; sold-out ones are removed. The list is a SAMPLE of the provider's matches: the result says how many exist and which cruise lines have sailings -- never conclude that a line is not offered because it is not listed; pass cruise_line to look for it. It does NOT show anything to the user, book, hold or price cabins, know availability beyond what it returns, or search by price alone. If you are recommending cruises, call show_offers ONCE afterward with the cruise_id values of your recommendation (3-5). Never invent offers that are not in the result.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "destination": {
      "type": "string",
      "description": "Region, country, sea or river in any language, e.g. 'Mediterranean', 'Norwegian fjords', 'Caribbean', 'Danube'. For a river cruise on any river pass 'river cruise'."
    },
    "cruise_type": {
      "type": "string",
      "enum": [
        "ocean",
        "river"
      ],
      "description": "'ocean': sea cruises. 'river': river cruises (Danube, Rhine, Moselle, Nile, ...). Omit it to derive it from the destination."
    },
    "period": {
      "type": "string",
      "description": "Travel period as free text, e.g. 'summer 2027', 'October 2027', '2027-06-01 to 2027-06-30'."
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest departure, ISO date. Alternative to period."
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest departure, ISO date. Alternative to period."
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "description": "Number of adults travelling."
    },
    "children_ages": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 17
      },
      "description": "Age of each child at travel time. A child without an age is not searched for."
    },
    "nights_min": {
      "type": "integer",
      "minimum": 1,
      "description": "Minimum nights. Only if the user names a trip length."
    },
    "nights_max": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum nights. Only if the user names a trip length; below 4 nights asks for short cruises first."
    },
    "departure_port": {
      "type": "string",
      "description": "A single port that must be on the route (start, stop or end), e.g. 'Barcelona'. For several required ports use `ports` instead."
    },
    "ports": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ports, islands or countries that must ALL be on the route (start, a stop or the end), e.g. ['Barbados', 'St. Lucia'] or the port cities ['Bridgetown', 'Castries'] -- an island/country entry matches any of its ports on the route. Names are matched in English; a translated name may find nothing, try the English or the specific port city instead."
    },
    "cruise_line": {
      "type": "string",
      "description": "Cruise line(s) by name, e.g. 'MSC' or 'MSC, AIDA' (comma-separated). The search is filtered AT THE PROVIDER, so use it to look for a line the default list does not show."
    },
    "flight": {
      "type": "string",
      "enum": [
        "with",
        "without"
      ],
      "description": "'without' (default): cruise only. 'with': the provider's flight packages."
    },
    "limit": {
      "type": "integer",
      "minimum": 3,
      "maximum": 10,
      "description": "How many offers to return as data (3-10, default 10). The result also carries `total` and `links.all` (every match on the provider's search page)."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": []
}

Returns facts about a cruise port: country, port code, coordinates and how many routes call there. Use it when the user asks about a port of call or departure port. It does NOT provide excursions, sights, weather or transfer advice, and it knows only ports in the provider's catalogue.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "port": {
      "type": "string",
      "description": "Port name, e.g. 'Barcelona'."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": [
    "port"
  ]
}

Prepares a callback request to the provider's team and shows it to the user as a card with the details and a send button. Use it only when the user explicitly asks to be called back or to speak to a person, and has told you in this chat their first name and ONE way to reach them (a phone number or an email address); ask for these first, and for a preferred time if they have one. Pass cruise_ids (from find_cruises, up to 5) only if the request is about those offers. It does NOT send anything: the user checks the details and presses the button on the card. It does not book, hold or price a cruise, and the draft is deleted after 30 minutes.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "first_name": {
      "type": "string",
      "maxLength": 60,
      "description": "The user's first name, as they gave it. Letters only."
    },
    "phone": {
      "type": "string",
      "maxLength": 40,
      "description": "Phone number with area code. Pass phone OR email, one of them."
    },
    "email": {
      "type": "string",
      "maxLength": 160,
      "description": "Email address. Pass it only if the user prefers email to a call."
    },
    "preferred_time": {
      "type": "string",
      "maxLength": 80,
      "description": "When the user would like to be reached, in their own words, e.g. 'weekdays after 5 pm'. Optional."
    },
    "cruise_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "description": "cruise_id values from find_cruises the request is about. Optional."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": []
}

Sends the callback request that the user confirmed on the card shown by prepare_callback to the provider's team: one entry in the provider's request list and one email to its service desk. It is called by the card's send button with the request_id the card carries, once per request. It does NOT create or change a request, and it needs a request that the user prepared in this consultation.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "request_id": {
      "type": "string",
      "maxLength": 64,
      "description": "The request_id carried by the card."
    }
  },
  "required": [
    "request_id"
  ]
}

Returns the profile of a cruise ship: cruise line, year built, size, passengers, crew and the consulting description. Use it when the user asks what a ship is like or wants to compare ships. It does NOT return deck plans, cabin numbers, live prices or availability.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "ship": {
      "type": "string",
      "description": "Ship name, e.g. 'AIDAcosma'."
    },
    "cruise_line": {
      "type": "string",
      "description": "Optional cruise line to disambiguate."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": [
    "ship"
  ]
}

Shows the user the cruises you are recommending, as cards with ship photo, route, dates, price and booking link -- drawn by the host, not by you. Call it ONCE, as the LAST step of your answer, with the cruise_id values of a previous find_cruises result that you recommend (3-5, in your recommended order). Never call it before you have decided what to recommend, and never more than once per answer. It does NOT search; an unknown or expired cruise_id is left out and named in the result -- call find_cruises again if that happens.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call."
    },
    "cruise_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 3,
      "maxItems": 5,
      "description": "cruise_id values from a previous find_cruises result, 3-5, in your recommended order."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ],
      "description": "Language of the answer. Defaults to the provider's language."
    }
  },
  "required": [
    "cruise_ids"
  ]
}