Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
AgentCore Referencia de CLI
Esta referencia documenta las versiones públicas de la AgentCore CLI de Amazon Bedrock.
Temas
Ciclo vital del proyecto
Auto-generated a partir de la @aws/agentcore versión 0.28.1: no edite a mano.
agentcore create
agentcore create [options]
Crea un nuevo proyecto AgentCore
Parámetros
-
--name <name>(opcional) -
Nombre del recurso [no interactivo]
-
--project-name <name>(opcional) -
Nombre del proyecto (comienza con una letra, solo alfanumérico, máximo 23 caracteres) [no interactivo]
-
--no-agent(opcional) -
Omitir la creación de agentes [no interactivo]
-
--defaults(opcional) -
Cree un proyecto de arnés con la configuración predeterminada (esta es la configuración predeterminada) [no interactivo]
-
--build <type>(opcional) -
Tipo de compilación: CodeZip o contenedor (predeterminado: CodeZip) [no interactivo]
-
--language <language>(opcional) -
Idioma de destino: Python o TypeScript (predeterminado: Python) [no interactivo]
-
--framework <framework>(opcional) -
Marco de agentes (Strands, LangChain _LangGraph, GoogleAdk, OpenAIAgents, VercelAI) [no interactivo]
-
--model-provider <provider>(opcional) -
Proveedor de modelos (Bedrock, Anthropic, OpenAI, Gemini) [no interactivo]
-
--api-key <key>(opcional) -
Clave de API para proveedores que no son de Bedrock [no interactiva]
-
--memory <option>(opcional) -
Opción de memoria (ninguna, a corto plazo, a largo plazoAndShortTerm) [no interactiva]
-
--protocol <protocol>(opcional) -
Protocolo: HTTP, MCP, A2A, AGUI (predeterminado: HTTP) [no interactivo]
-
--type <type>(opcional) -
Tipo de agente: crear o importar (predeterminado: crear) [no interactivo]
-
--agent-id <id>(opcional) -
ID de agente de Bedrock (obligatorio para importar --type) [no interactivo]
-
--agent-alias-id <id>(opcional) -
ID de alias del agente de Bedrock (obligatorio para importar --type) [no interactivo]
-
--region <region>(opcional) -
La AWS región de Bedrock Agent (requerida para importar --type) [no interactiva]
-
--network-mode <mode>(opcional) -
Modo de red (PUBLIC, VPC) [no interactivo]
-
--subnets <ids>(opcional) -
Comma-separated identificadores de subred (necesarios para el modo VPC) [no interactivos]
-
--security-groups <ids>(opcional) -
Comma-separated identificadores de grupos de seguridad (necesarios para el modo VPC) [no interactivos]
-
--vpc-id <id>(opcional) -
ID de VPC (obligatorio para las compilaciones de contenedores con modo VPC) [no interactivo]
-
--idle-timeout <seconds>(opcional) -
Tiempo de espera de sesión inactiva en segundos (60-28800) [no interactiva]
-
--max-lifetime <seconds>(opcional) -
Duración máxima de la instancia en segundos (60 a 28800) [no interactiva]
-
--session-storage-mount-path <path>(opcional) -
Ruta de montaje absoluta para el almacenamiento del sistema de archivos de sesión en /mnt (por ejemplo,/mnt/data) [no interactiva]
-
--efs-access-point-arn <arn>(opcional) -
ARN del punto de acceso EFS (repetible, emparejado con --efs-mount-path) [no interactivo] (predeterminado: [])
-
--efs-mount-path <path>(opcional) -
Ruta de montaje de EFS (por ejemplo,/mnt/tools, combinada con --efs-access-point-arn) [no interactiva] (predeterminada: [])
-
--s3-access-point-arn <arn>(opcional) -
ARN del punto de acceso a los archivos S3 (repetible, emparejado con --s3-mount-path) [no interactivo] (predeterminado: [])
-
--s3-mount-path <path>(opcional) -
Ruta de montaje de los archivos S3 (por ejemplo,/mnt/datasets, junto con --s3-access-point-arn) [no interactiva] (predeterminada: [])
-
--with-config-bundle(opcional) -
Cree un paquete de configuración conectado a la plantilla del agente [no interactivo]
-
--output-dir <dir>(opcional) -
Directorio de salida (predeterminado: directorio actual) [no interactivo]
-
--skip-git(opcional) -
Omitir la inicialización del repositorio git [no interactivo]
-
--skip-python-setup(opcional) -
Omitir la configuración del entorno virtual de Python [no interactivo]
-
--skip-install(opcional) -
Omita toda la instalación de dependencias (npm install, uv sync) [no interactiva]
-
--dry-run(opcional) -
Obtenga una vista previa de lo que se crearía sin hacer cambios [no interactivo]
-
--json(opcional) -
Salida como JSON [no interactiva]
-
--model-id <id>(opcional) -
ID del modelo del arnés [no interactivo]
-
--api-key-arn <arn>(opcional) -
ARN de clave de API para proveedores de arneses que no son de Bedrock [no interactiva]
-
--api-base <url>(opcional) -
URL base del punto final de la API del proveedor de modelos de arneses (lite_llm) [no interactiva]
-
--additional-params <json>(opcional) -
Provider-specific aprovecha los parámetros como un objeto JSON (lite_llm) [no interactivo]
-
--no-harness-memory(opcional) -
Desactiva la memoria del arnés (esta es la opción predeterminada) [no interactiva]
-
--max-iterations <n>(opcional) -
Número máximo de iteraciones del bucle del agente (arnés) [no interactivo]
-
--max-tokens <n>(opcional) -
Número máximo de fichas por iteración (arnés) [no interactivo]
-
--timeout <seconds>(opcional) -
Duración máxima de la ejecución en segundos (arnés) [no interactivo]
-
--truncation-strategy <strategy>(opcional) -
Estrategia de truncamiento: sliding_window o summary (harness) [no interactiva]
-
--container <uri-or-path>(opcional) -
URI de la imagen del contenedor o ruta de Dockerfile (arnés) [no interactiva]
implementación de agentcore
agentcore deploy|dp [options]
Implemente la infraestructura del proyecto a AWS través de CDK.
Parámetros
-
--target <target>(opcional) -
Nombre del objetivo de implementación (predeterminado: «predeterminado») [no interactivo]
-
-y, --yes(opcional) -
Auto-confirm solicita, lee las credenciales de env [no interactivo]
-
-v, --verbose(opcional) -
Mostrar eventos de implementación a nivel de recursos [no interactivos]
-
--json(opcional) -
Salida como JSON [no interactiva]
-
--dry-run(opcional) -
Obtenga una vista previa de la implementación sin implementarla [no interactiva]
-
--diff(opcional) -
Mostrar la diferencia del CDK sin implementar [no interactivo]
agentcore dev
agentcore dev|d [options] [prompt]
Inicie un servidor de desarrollo local o invoque un agente localmente.
Parámetros
-
prompt -
Envía un mensaje a un servidor de desarrollo en ejecución [no interactivo]
-
-p, --port <port>(opcional) -
Puerto para servidor de desarrollo. Se usa tal cual cuando se establece explícitamente; el valor predeterminado se compensa con el índice de tiempo de ejecución en proyectos con varios tiempos de ejecución. (predeterminado: «8080")
-
-r, --runtime <name>(opcional) -
Tiempo de ejecución para ejecutar o invocar (obligatorio si hay varios tiempos de ejecución)
-
-s, --stream(opcional) -
Respuesta de transmisión al invocar [no interactivo]
-
-l, --logs(opcional) -
Ejecute el servidor de desarrollo con los registros en la salida estándar [no interactivo]
-
--exec(opcional) -
Ejecute un comando de shell en el contenedor de desarrollo en ejecución (solo para agentes contenedores) [no interactivo]
-
--tool <name>(opcional) -
Nombre de la herramienta MCP (se usa con el mensaje «call-tool») [no interactivo]
-
--input <json>(opcional) -
Argumentos de la herramienta MCP como JSON (usados con --tool) [no interactivos]
-
--skip-deploy(opcional) -
Omita el despliegue automático de recursos antes de iniciar el servidor de desarrollo
-
-H, --header <header>(opcional) -
Encabezado personalizado para reenviar al agente (formato: «Nombre: Valor», repetible) [no interactivo] (predeterminado: [])
-
-b, --no-browser(opcional) -
Utilice la TUI del terminal en lugar de la interfaz de usuario de chat basada en la web
-
--no-traces(opcional) -
Desactivar la recopilación local de trazas de OTEL
paquete agentcore
agentcore package|pkg [options]
Empaqueta los artefactos del agente sin desplegarlos.
Parámetros
-
-d, --directory <path>(opcional) -
Directorio del proyecto que contiene la configuración del agentcore
-
-r, --runtime <name>(opcional) -
Empaquete solo el tiempo de ejecución especificado
exportación de agentcore
agentcore export [options] [command]
Exporta un arnés a un agente de ejecución de Strands.
actualización de agentcore
agentcore update [options] [command]
Busque e instale las actualizaciones de la CLI
Parámetros
-
-c, --check(opcional) -
Compruebe si hay actualizaciones sin instalar
agentcore validate
agentcore validate [options]
Valide los archivos de configuración de agentcore/.
Parámetros
-
-d, --directory <path>(opcional) -
Directorio del proyecto que contiene la configuración del agentcore
-
--json(opcional) -
Salida como JSON [no interactiva]
Tiempo de ejecución de la invocación &
Auto-generated a partir de la @aws/agentcore versión 0.28.1: no edite a mano.
invocar agentcore
agentcore invoke|i [options] [prompt]
Invoca un punto final de agente desplegado.
Parámetros
-
prompt -
Solicita el envío al agente. También acepta stdin canalizado cuando no se proporciona ningún mensaje y stdin no es un TTY [no interactivo]
-
--prompt <text>(opcional) -
Solicitud para enviar al agente [no interactiva]
-
--prompt-file <path>(opcional) -
Lea el mensaje desde un archivo (para cargas largas o estructuradas que superen los límites de arg de shell) [no interactivo]
-
--runtime <name>(opcional) -
Seleccione un tiempo de ejecución específico [no interactivo]
-
--gateway <name>(opcional) -
Invocar a través de una puerta de enlace [no interactiva]
-
--gateway-target-name <name>(opcional) -
Destino de tiempo de ejecución HTTP en la puerta de enlace [no interactivo]
-
--target <name>(opcional) -
Seleccione el objetivo de despliegue [no interactivo]
-
--session-id <id>(opcional) -
Usa un identificador de sesión específico para la continuidad de la conversación
-
--user-id <id>(opcional) -
ID de usuario para la invocación en tiempo de ejecución (predeterminado: «default-user»)
-
--api-base <url>(opcional) -
La URL base de la API LitellM se anula para las invocaciones de arneses. Disponible solo en modo no interactivo
lite_llm. -
--additional-params <json>(opcional) -
Los parámetros LitellM adicionales, como objeto JSON, para las invocaciones de arneses. Disponible solo en modo no interactivo
lite_llm. -
--payment-user-id <id>(opcional) -
End-user/wallet-owner identity (el valor predeterminado es --user-id)
-
--payment-instrument-id <id>(opcional) -
ID del instrumento de pago (monedero)
-
--payment-session-id <id>(opcional) -
ID de sesión de pago para el seguimiento del presupuesto
-
--auto-session(opcional) -
Auto-create/reuse una sesión de pago para realizar pruebas
-
--json(opcional) -
Salida como JSON
-
--stream(opcional) -
Transmite la respuesta en tiempo real
-
--tool <name>(opcional) -
Nombre de la herramienta MCP (úselo con el mensaje «call-tool»)
-
--input <json>(opcional) -
Argumentos de la herramienta MCP como JSON (utilícelos con --tool)
-
--exec(opcional) -
Ejecute un comando de shell en el contenedor de tiempo de ejecución
-
--timeout <seconds>(opcional) -
Tiempo de espera en segundos para los comandos --exec
-
-H, --header <header>(opcional) -
Encabezado personalizado «Nombre: Valor» (repetible)
-
--bearer-token <token>(opcional) -
Token de portador para la autenticación CUSTOM_JWT (omite SIGv4)
-
--harness <name>(opcional) -
Seleccione un arnés específico para invocar
-
--harness-arn <arn>(opcional) -
Invoca un arnés mediante ARN (no se requiere ningún proyecto)
-
--region <region>(opcional) -
La AWS región (obligatorio con --harness-arn)
-
--verbose(opcional) -
Imprima eventos JSON de streaming detallados
-
--model-id <id>(opcional) -
Modelo de anulación
-
--model-provider <provider>(opcional) -
El proveedor del modelo. Valores válidos:
bedrock,open_aiogemini. -
--api-key-arn <arn>(opcional) -
Clave de API ARN para open_ai/gemini
-
--tools <tools>(opcional) -
Herramientas de anulación (separadas por comas)
-
--allowed-tools <tools>(opcional) -
Anular las herramientas permitidas (separadas por comas)
-
--skills <paths>(opcional) -
Habilidades (rutas separadas por comas)
-
--system-prompt <text>(opcional) -
Anular el mensaje del sistema
-
--actor-id <id>(opcional) -
Anular el ID del actor de memoria
-
--max-iterations <n>(opcional) -
Anular el número máximo de iteraciones
-
--max-tokens <n>(opcional) -
Anula el máximo de tokens
-
--harness-timeout <seconds>(opcional) -
Anular los segundos de tiempo de espera
agentcore exec
agentcore exec [options] [command...]
Abra un shell interactivo o ejecute un comando único en un contenedor de agentes desplegado.
Parámetros
-
command -
Comando a ejecutar (modo de una sola vez, no interactivo)
-
--it(opcional) -
Abra una sesión interactiva de PTY shell
-
--runtime <name|arn>(opcional) -
Nombre del agente de destino o ARN en tiempo de ejecución (omite el selector de agentes)
-
--harness <name|arn>(opcional) -
Nombre del arnés de destino o ARN del arnés (omite el selector de agentes)
-
--session-id <id>(opcional) -
Anclar a una sesión/máquina virtual en tiempo de ejecución específica
-
--shell-id <id>(opcional) -
Vuelva a conectarse a un shell existente
-
--region <region>(opcional) -
La AWS región
-
--bearer-token <token>(opcional) -
Token de portador para la autenticación CUSTOM_JWT (omite SigV4)
-
--target <name>(opcional) -
Nombre del objetivo de implementación (de agentcore.json)
-
--timeout <seconds>(opcional) -
Tiempo de espera en segundos para los comandos de un solo disparo
-
--json(opcional) -
Muestra el resultado como JSON (solo en modo único, incompatible con --it)
ejecución de agentcore
agentcore run [options] [command]
Ejecute evaluaciones, evaluaciones por lotes o recomendaciones de optimización.
registros principales del agente
agentcore logs|l [options] [command]
Transmita o busque los registros de tiempo de ejecución de los agentes.
Parámetros
-
--runtime <name>(opcional) -
Seleccione un tiempo de ejecución específico
-
--since <time>(opcional) -
Hora de inicio: el valor predeterminado es hace 1 hora en el modo de búsqueda (por ejemplo, «1 hora», «30 minutos», «2 veces», ISO 8601)
-
--until <time>(opcional) -
Hora de finalización: el valor predeterminado es ahora en el modo de búsqueda (por ejemplo, «ahora», ISO 8601)
-
--level <level>(opcional) -
Filtrar por nivel de registro (error, advertencia, información, depuración)
-
-n, --limit <count>(opcional) -
Número máximo de líneas de registro a devolver
-
--query <text>(opcional) -
Server-side filtro de texto
-
--json(opcional) -
Salida como líneas JSON
trazas del núcleo del agente
agentcore traces|t [options] [command]
Ver y descargar los rastros de los agentes.
estado del núcleo del agente
agentcore status|s [options]
Muestra los detalles y el estado de los recursos desplegados.
Parámetros
-
--runtime-id <id>(opcional) -
Busca un tiempo de ejecución específico por ID
-
--target <name>(opcional) -
Seleccione el objetivo de despliegue
-
--type <type>(opcional) -
Filtre por tipo de recurso (agente, punto final de ejecución, memoria, credencial, pasarela, evaluador, evaluación en línea, pago, motor de políticas, política, paquete de configuración, conjunto de datos, base de conocimientos, arnés)
-
--state <state>(opcional) -
Filtrar por estado de implementación (implementada, solo local, pendiente de eliminación)
-
--runtime <name>(opcional) -
Filtrar a un tiempo de ejecución específico
-
--name <name>(opcional) -
Mostrar los detalles de un solo recurso por nombre (base de conocimientos)
-
--json(opcional) -
Salida como JSON
agentcore fetch
agentcore fetch [options] [command]
Obtenga la información de acceso a los recursos desplegados.
vista del núcleo del agente
agentcore view [options] [command]
Ver el historial y los detalles del trabajo
Administración de recursos
Auto-generated a partir de la @aws/agentcore versión 0.28.1: no edite a mano.
agentcore añadir
agentcore add [options] [command] [subcommand]
Agregue recursos a la configuración del proyecto.
agentcore eliminar
agentcore remove [options] [command] [subcommand]
Elimine los recursos de la configuración del proyecto.
importación de agentcore
agentcore import [options] [command]
Importe un kit de herramientas de ejecución, memoria o inicio a este proyecto.
Parámetros
-
--source <path>(opcional) -
Ruta al archivo de configuración .bedrock_agentcore.yaml
-
--target <target>(opcional) -
Nombre del objetivo de implementación (solo es necesario si el proyecto tiene varios objetivos)
-
-y, --yes(opcional) -
Auto-confirm indicaciones
Conjuntos de datos de evaluación &
Auto-generated a partir de la @aws/agentcore v0.28.1: no edite a mano.
Evaluaciones agentcore
agentcore evals [options] [command]
Vea los resultados de las evaluaciones guardadas y las evaluaciones por lotes de ejecuciones anteriores.
evaluaciones por lotes de agentcore
agentcore batch-evaluations [options] [command] <id>
Vea los trabajos de evaluación por lotes y sus resultados.
Parámetros
-
id -
ID del trabajo de evaluación por lotes para ver
-
--json(opcional) -
Salida como JSON
conjunto de datos agentcore
agentcore dataset [options] [command]
Gestione el contenido y las versiones del conjunto de datos
Paquetes de & configuración de optimización
Auto-generated a partir de la @aws/agentcore versión 0.28.1: no edite a mano.
paquete de configuración de agentcore
agentcore config-bundle|cb [options] [command]
Administre los paquetes de configuración (utilice el nombre del paquete de agentcore.json, no el ID)
agentcore promueve
agentcore promote [options] [command]
Promover los recursos
archivo agentcore
agentcore archive [options] [command]
Archive (elimine) una evaluación o recomendación por lotes del servicio y borre el historial local.
&Configuración de operaciones
Auto-generated a partir de la @aws/agentcore v0.28.1: no edite a mano.
pausa de agentcore
agentcore pause [options] [command]
Pausar un recurso desplegado (evaluación, configuración, A/B prueba en línea).
currículum de agentcore
agentcore resume [options] [command]
Reanudar un recurso pausado (evaluación, configuración, A/B prueba en línea).
agentcore stop
agentcore stop [options] [command]
Detenga una evaluación o A/B prueba por lotes en ejecución.
configuración de agentcore
agentcore config [options] [key] [value]
Ajuste los ajustes de configuración global, como el estado de exclusión de la telemetría
Parámetros
-
key -
Clave de configuración en notación de puntos (por ejemplo, telemetry.enabled)
-
value -
Valor que se va a establecer
telemetría del núcleo del agente
agentcore telemetry [options] [command]
Gestione las preferencias de análisis de uso anónimo.
comentarios de agentcore
agentcore feedback [options] [message]
Envíe sus comentarios sobre la AgentCore CLI al equipo.
Parámetros
-
message -
Mensaje de comentarios [no interactivo]
-
--screenshot <path>(opcional) -
Ruta a una captura de pantalla PNG o JPG (máximo 100 MB) [no interactiva]
-
--json(opcional) -
Mostrar el resultado como JSON [no interactivo]
