kindgi connection-choices
kindgi connection-choices
Section titled “kindgi connection-choices”Synopsis
kindgi connection-choices <command>Connection choices: which connection an agent or a flow, or one of its tools, uses at an app, the company's or your own (set / list / unset).
Commands
| Command | Description |
|---|---|
kindgi connection-choices set |
Choose the connection an agent or a flow of the project uses at the connection's app, or with --tool the one a tool of it uses, in place of the one chosen before. |
kindgi connection-choices list |
List the project's connection choices: the company's and your own, and every person's for a tenant admin. |
kindgi connection-choices unset |
Remove a connection choice: the company's, a project admin's, or your own. |
See also
kindgi connection-choices set
Section titled “kindgi connection-choices set”Synopsis
kindgi connection-choices set <connection>... (--agent=<id> | --flow=<id>) [--tool=<tool-id> [--need=<name>]] [--default=<connection>] [--mine] [--project=<project-id>] [--app=<app>]Choose the connection an agent or a flow of the project uses at the connection's app, or with --tool the one a tool of it uses, in place of the one chosen before. Several connections make a tool's set, when the tool can take one: a call names one of them, else uses --default. A company choice is a project admin's; --mine makes your own, for your own runs.
Options
| Option | Default | Description |
|---|---|---|
--agent <value> |
none (--agent or --flow is required) |
The agent it is for, by id. |
--app <value> |
none | With a name: only connections at this app, by its entry id (google). |
--default <value> |
none (required with several connections) | With several connections: the one a call that names none uses, by id or name; one of them. |
--flow <value> |
none (--agent or --flow is required) |
The flow it is for, by id. |
--mine |
off | Your own choice, of your own connections, for your own runs. |
--need <value> |
none (required when the tool uses the app twice) | With --tool: the tool's name for the connection, when the tool uses the app more than once. |
--project <value> |
the workspace's default project | The project, by id (default: the workspace's default project). |
--tool <value> |
none (the agent's or flow's own choice) | One of the agent's or flow's tools, by id: the choice is that tool's own, ahead of the agent's or flow's. |
Every command also takes the global flags.
Examples
Have an agent use the company connection named support, in the Default project.
kindgi connection-choices set support --agent=acme.order-deskHave a flow of a project use one of the project's company Google connections.
kindgi connection-choices set sales --flow=acme.triage --project=<project-id> --app=googleHave one tool of an agent use the company connection named sales, ahead of the agent's own choice.
kindgi connection-choices set sales --agent=acme.order-desk --tool=acme.mail.sendGive a tool that only reads three of your own connections, work by default: each call names the one it reads.
kindgi connection-choices set work home school --agent=acme.assistant --tool=acme.calendar.events --default=work --mineFrom Choose a connection:
pnpm exec kindgi connection-choices set support --agent=acme.mail-helperpnpm exec kindgi connection-choices set sales --agent=acme.mail-helper --tool=acme.mail.sendSee also
kindgi connection-choices list
Section titled “kindgi connection-choices list”Synopsis
kindgi connection-choices list [--project=<project-id>] [--agent=<id>] [--flow=<id>] [--tool=<tool-id>] [--app=<app>] [--mine] [--include-removed] [--limit=<n>] [--cursor=<c>] [--table]List the project's connection choices: the company's and your own, and every person's for a tenant admin. --mine keeps to your own. Removed ones are left out unless --include-removed.
Options
| Option | Default | Description |
|---|---|---|
--agent <value> |
none | Only this agent's. |
--app <value> |
none | Only this app's, by its entry id (google). |
--cursor <value> |
none | The next page, from nextCursor. |
--flow <value> |
none | Only this flow's. |
--include-removed |
off | Removed and replaced choices too, with when (removedAt). |
--limit <value> |
25 (at most 100) |
Page size. |
--mine |
off | Only your own, even as a tenant admin. |
--project <value> |
the workspace's default project | The project, by id (default: the workspace's default project). |
--tool <value> |
none | Only this tool's own choices, by its id. |
Every command also takes the global flags.
Examples
List a project's connection choices, as a table.
kindgi connection-choices list --project=<project-id> --tableList an agent's choices, removed and replaced ones too.
kindgi connection-choices list --agent=acme.order-desk --include-removed --tableList only your own choices, as a table.
kindgi connection-choices list --mine --tableFrom Choose a connection:
pnpm exec kindgi connection-choices list --tableSee also
kindgi connection-choices unset
Section titled “kindgi connection-choices unset”Synopsis
kindgi connection-choices unset <choice-id> [--yes]Remove a connection choice: the company's, a project admin's, or your own. A tool's choice gives way to its agent's or flow's. An agent's or flow's gives way to the project's only company connection at the app, and stops with connection-not-chosen when there are several; your own gives way to your main connection, else your only one. Asks first, unless --yes.
Options
| Option | Default | Description |
|---|---|---|
--yes |
off | Don't ask first (for scripts). |
Every command also takes the global flags.
Examples
Remove a connection choice without being asked (for scripts).
kindgi connection-choices unset <choice-id> --yesFrom Choose a connection:
pnpm exec kindgi connection-choices unset 8e2a4b13-…See also