Component
core/ai-agent/vapi
A voice-agent platform reached over Vapi's REST API, so an application holds a spoken conversation with an assistant Vapi hosts and runs. The developer names the assistant and, optionally, the version to pin; the operator supplies the API base address and the platform-held number a call originates from. Wire here rather than to a carrier: a carrier moves the call, an agent platform conducts the conversation, and many Releases want both. Consumers read the base address, the assistant identifier, the version and the number. Realized by reference: no compute runs here.
Provenance
- Content digest
- sha256:aafe1e5bb06955307618a5cd4e026b4b67292eb2ab51bf27d0cde541c130b589
- Published
- 2026-11-10T10:08:53Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:7a763ee4fec3dce67e9b855a463807e3a86bce875a7b12a175dab426d7bac7fc
Reference at this version
oci://hub.aggrega.ai/component/core/ai-agent/vapi:1.0.0Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseAgentParameter
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| assistant_id | string | — | yes | The identifier of the saved assistant a call runs, as the platform's dashboard reports it. |
| assistant_version | string | — | no | The assistant version to pin a call to; unset, the platform follows its own latest. |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| endpoint | string | https://api.vapi.ai | no | — |
| phone_number_id | string | — | no | The platform-issued identifier of the number an outbound call originates from. |
Output contract
Values this component publishes to consumers over the uses topology.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| endpoint | string | — | yes | Base URL of the platform's API an application calls to hold a spoken conversation. The Release supplies it, so an operator may point it at a different host without the application changing. |
| assistant_id | string | — | yes | Identifier of the assistant a call is conducted by, carried through from the value the Aggregate declared. An application sends it to address this assistant rather than another on the same account. |
| assistant_version | string | — | no | Version of that assistant to pin a call to instead of the one the platform serves by default. It is absent unless the Aggregate pinned one, so an application sends it only when it is set. |
| phone_number_id | string | — | no | Platform-issued identifier of the number an outbound call originates from. An application sends the identifier rather than the number itself, which the platform holds. |
Uses sockets
The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.
No uses sockets declared.
Attachment slots
Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.
| Slot | Selector | Required | Inject | Sensitive | Description |
|---|---|---|---|---|---|
| api_key | feature.aggrega.ai/kind=secret | no | env | yes | The private API key presented as a bearer token in the Authorization header on every request to the platform. |
Self-inject allowlist
No self-inject pipes declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- $refextends schema (values)
BaseComponents#/schemas/BaseAgentParameter
Used by
uses socket «runner»
uses socket «api»
uses socket «runner»
uses socket «api»
uses socket «services»
uses socket «api»
uses socket «services»
uses socket «services»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «api»
uses socket «ssrf_proxy»
uses socket «api»
uses socket «api»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «target_agent»
implements
implements