AWS's bedrockagent service · portable interface driver.BedrockAgent · AWS index
| Operation | Description |
|---|---|
CreateAgent |
|
CreateAgentAlias |
|
CreateDataSource |
|
CreateFlow |
|
CreateKnowledgeBase |
|
CreatePrompt |
|
DeleteAgent |
|
DeleteDataSource |
|
DeleteFlow |
|
DeleteKnowledgeBase |
|
DeletePrompt |
|
GetAgent |
|
GetDataSource |
|
GetFlow |
|
GetKnowledgeBase |
|
GetPrompt |
|
ListAgents |
|
ListDataSources |
|
ListFlows |
|
ListKnowledgeBases |
|
ListPrompts |
|
ListTagsForResource |
|
PrepareAgent |
|
PrepareFlow |
|
StartIngestionJob |
|
TagResource |
|
UntagResource |
|
UpdateAgent |
|
UpdateDataSource |
|
UpdateFlow |
|
UpdateKnowledgeBase |
|
UpdatePrompt |
Discovered by type assertion; only some providers implement these.
ActionGroups manages the action groups (tools) of an agent version.
| Operation | Description |
|---|---|
CreateAgentActionGroup |
|
DeleteAgentActionGroup |
|
GetAgentActionGroup |
|
ListAgentActionGroups |
|
UpdateAgentActionGroup |
AgentCollaborators manages the collaborator agents of a supervisor agent.
| Operation | Description |
|---|---|
AssociateAgentCollaborator |
|
DisassociateAgentCollaborator |
|
GetAgentCollaborator |
|
ListAgentCollaborators |
|
UpdateAgentCollaborator |
AgentInUseDeleter deletes an agent the way DeleteAgent's
| Operation | Description |
|---|---|
DeleteAgentChecked |
AgentKnowledgeBases associates knowledge bases with an agent version.
| Operation | Description |
|---|---|
AssociateAgentKnowledgeBase |
|
DisassociateAgentKnowledgeBase |
|
GetAgentKnowledgeBase |
|
ListAgentKnowledgeBases |
|
UpdateAgentKnowledgeBase |
AgentVersions manages agent versions and the rest of the alias lifecycle.
| Operation | Description |
|---|---|
DeleteAgentAlias |
|
DeleteAgentVersion |
|
GetAgentAlias |
|
GetAgentVersion |
|
ListAgentAliases |
|
ListAgentVersions |
|
UpdateAgentAlias |
FlowValidator checks a flow definition without storing it.
| Operation | Description |
|---|---|
ValidateFlowDefinition |
FlowVersions publishes flow versions and manages the aliases routing to them.
| Operation | Description |
|---|---|
CreateFlowAlias |
|
CreateFlowVersion |
|
DeleteFlowAlias |
|
DeleteFlowVersion |
|
GetFlowAlias |
|
GetFlowVersion |
|
ListFlowAliases |
|
ListFlowVersions |
|
UpdateFlowAlias |
IngestionJobs reads, lists and stops data-source ingestion jobs.
| Operation | Description |
|---|---|
GetIngestionJob |
|
ListIngestionJobs |
|
StopIngestionJob |
KnowledgeBaseDocuments manages the documents of a data source directly.
| Operation | Description |
|---|---|
DeleteKnowledgeBaseDocuments |
|
GetKnowledgeBaseDocuments |
|
IngestKnowledgeBaseDocuments |
|
ListKnowledgeBaseDocuments |
PromptVersions publishes immutable numbered versions of a prompt's DRAFT.
| Operation | Description |
|---|---|
CreatePromptVersion |
|
DeletePromptVersion |
|
GetPromptVersion |
|
ListPromptVersions |
ResourcePolicies attaches resource-based policies to knowledge bases.
| Operation | Description |
|---|---|
DeleteResourcePolicy |
|
GetResourcePolicy |
|
PutResourcePolicy |
- Aliases, versions, knowledge bases and data sources are created directly in their final state (
PREPARED,ACTIVE,AVAILABLE). Agents and flows startNOT_PREPARED/NotPrepared; PrepareAgent and PrepareFlow prepare them at once, any change to the draft makes it unprepared again, and cutting an agent version (an alias created or updated withoutroutingConfiguration) prepares the draft too. Ingestion jobs complete at once; with--async-settlethey reportIN_PROGRESSfor two seconds first, which is the only window in whichStopIngestionJobsucceeds. A stop of a finished job is aConflictException. PrepareAgentdoes not cut a version, as in AWS. A version is cut whenCreateAgentAliasorUpdateAgentAliasis called withoutroutingConfiguration; it copies DRAFT with its action groups, knowledge-base associations and collaborators. Agent and flow versions reportPREPARED/Preparedwhatever DRAFT's status was.- Every agent has the
TSTALIASIDtest alias routed to DRAFT; it is listed and readable and can't be updated or deleted. Flows have no synthesized test alias. promptOverrideConfigurationreturns what the caller set. AWS's default prompt templates are not reproduced, so an agent created without overrides reports an emptypromptConfigurationslist.guardrailConfiguration,memoryConfiguration,customOrchestration, action-group executors and schemas, flow definitions and document content are stored and returned as sent; nothing runs them. Knowledge-base documents are tracked by identifier and reportedINDEXED; their text is kept whole (no chunking or embedding) for the agent runtime's word-overlap search. An ingestion job over an S3 data source syncs the bucket from cloudemu S3: text objects (.txt,.md,.html,.csv,.jsonor atext/*content type) under the inclusion prefixes are indexed with their<key>.metadata.jsonattributes, changed and removed objects are re-indexed or dropped, and other formats count as failed. The sync runs when the job starts (under--async-settlethe documents are searchable while the job still reportsIN_PROGRESS); a bucket that can't be listed makes the jobFAILEDwith afailureReasonsentry and leaves the index unchanged. Under--enforce-auththe job reads S3 as the knowledge base's service role: a role that does not exist or lackss3:ListBucketfails the job, and objects it lackss3:GetObjecton count as failed. Other data-source types (web, Confluence, SharePoint, Salesforce) are not crawled; their ingestion statistics count the documents ingested into them directly.ValidateFlowDefinitionchecks structure only: a missing Input or Output node, connections to unknown nodes, duplicate connections, and nodes not reachable from an Input node. Node configurations, expressions, data types, conditions and loops are not checked, and the messages are the emulator's own wording.skipResourceInUseCheckmatters forDeleteAgentVersionandDeleteFlowVersion(a version an alias routes to is in use) and forDeleteAgent(an agent whose alias another agent's collaborator uses is in use). Deleting a flow, prompt or knowledge base cascades to its children without an in-use check, andDeleteAgentActionGroupdoes not require the action group to be disabled.- Deleting a knowledge base leaves agent associations to it in place. Deleting an alias, or an agent with
skipResourceInUseCheck, leaves other agents' collaborators that point at that alias in place. - Document
metadata(inline attributes, or anS3_LOCATIONmetadata file read from cloudemu S3) is stored and used by the runtime's retrieval filters, but not returned by GetKnowledgeBaseDocuments or ListKnowledgeBaseDocuments. - Where AWS does not document the exact message (for example a missing VECTOR
storageConfiguration, a badnextToken, an alias name in use, a version in use, a non-supervisor agent given a collaborator), the emulator returns the documented exception with its own wording. clientTokenis validated but does not make a create idempotent.- The operations served are the 75 of the pinned SDK (
aws-sdk-go-v2/service/bedrockagentv1.58.0). Newer API operations, such as Create/Get/List/DeleteVpcConfiguration, are not served. - The Go library's plain
DeleteAgentdeletes without the in-use check; the wire handler andDeleteAgentCheckedapply it. An alias of a regular (non-test) agent may route toDRAFT, which the API's routing pattern allows. - StartIngestionJob is refused (ConflictException) while another job of the same data source is still running.