HumanFirst icon

HumanFirst

Call HumanFirst playbook API

Trigger Package With Input

AI-generated

Overview

This node operation triggers a specific package (prompt) within a playbook in the HumanFirst platform, using mention overrides as input to customize the package execution. It waits for the package to generate a completion and returns the generated output. This is useful for dynamically generating content or responses based on customized input parameters in automation workflows.

Use Case Examples

  1. Trigger a package with specific mention overrides to generate a customized response in a chatbot workflow.
  2. Use mention overrides to substitute values dynamically in a package and retrieve the generated completion for further processing.

Properties

Name Meaning
Namespace The namespace in which the playbook and package exist, used to scope the API request.
Playbook ID The identifier of the playbook containing the package to trigger.
Package ID The identifier of the specific package (prompt) to trigger within the playbook.
Mention Overrides A collection of key-value pairs to override mentions in the package, allowing dynamic substitution of values during package execution.
Timeout (Seconds) Maximum time to wait for the package generation to complete, with a default of 1800 seconds (30 minutes). Set to 0 for no timeout limit.

Output

JSON

  • json - The JSON response from the HumanFirst API containing the generated completion result of the triggered package.

Dependencies

  • Requires an API key credential for HumanFirst API authentication.

Troubleshooting

  • Timeout errors may occur if the package generation exceeds the specified timeout limit. To resolve, increase the timeout parameter, reduce input data size, or optimize the package configuration.
  • Errors related to missing or invalid mention overrides may cause the package trigger to fail.
  • Network or authentication errors may result in failed API requests; ensure the API key is valid and network connectivity is stable.

Discussion