Griptape

Run AI agents built with the Griptape framework.

AutomationAPI key5 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (5)
createAssistantRun
createStructureRun
getAssistantRun
getStructureRun
custom_api_call
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("griptape", "createAssistantRun", {
    "assistant_id": "<assistant_id>",
    "input": "<input>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Griptape answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "griptape-createassistantrun",
  name: "Griptape: Create Assistant Run",
  description: "Calls Griptape when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("griptape", {
      "action": "createAssistantRun",
      "assistant_id": "<assistant_id>",
      "input": "<input>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/griptape/createAssistantRun" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"assistant_id":"<assistant_id>","input":"<input>"}}'

Actions

createAssistantRunin catalog

Create Assistant Run. Create a run for an assistant with optional additional resources

Input	Type	Description
`assistant_id`required	id (picked from your account)	Select the assistant
`input`required	long text	Input to provide to the assistant
`knowledgeBaseIds`optional	ids (picked from your account)	Select knowledge bases to use
`rulesets`optional	ids (picked from your account)	Select rulesets to apply
`structures`optional	ids (picked from your account)	Select structures to use
`tools`optional	ids (picked from your account)	Select tools to use
`thread`optional	ids (picked from your account)	Select the thread
`create_new_thread`optional	boolean	Create a new thread for this run

createStructureRunin catalog

Create Structure Run. Create a run for a structure and wait for completion

Input	Type	Description
`structure_id`required	id (picked from your account)	Select the structure
`input_args`required	array	Input arguments for the structure run

getAssistantRunin catalog

Get Assistant Run. Get details of a specific assistant run

Input	Type	Description
`assistant_id`required	id (picked from your account)	Select the assistant
`assistant_run_id`required	id (picked from your account)	Select the assistant run

getStructureRunin catalog

Get Structure Run. Get details of a specific structure run

Input	Type	Description
`structure_id`required	id (picked from your account)	Select the structure
`structure_run_id`required	id (picked from your account)	Select the structure run

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

Details

Id: griptape
Category: Automation
Tags: automation, agents, griptape, framework, ai
Package: @activepieces/piece-griptape@0.1.4
Tier: Community