Loading...
    • Construir
    • Administración
    • Modelos y precios
    • SDKs de cliente
    • Referencia de API
    Search...
    ⌘K
    Log in
    Inicio rápido
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Construir/Primeros pasos

    Comenzar con Claude Managed Agents

    Crea tu primer agente autónomo.

    Esta guía te lleva a través de la creación de un agente, la configuración de un entorno, el inicio de una sesión y la transmisión de respuestas del agente.

    Conceptos principales

    ConceptDescription
    AgentThe model, system prompt, tools, MCP servers, and skills
    EnvironmentA configured container template (packages, network access)
    SessionA running agent instance within an environment, performing a specific task and generating outputs
    EventsMessages exchanged between your application and the agent (user turns, tool results, status updates)

    Requisitos previos

    • Una cuenta de Console de Anthropic
    • Una clave de API

    Instalar la CLI

    Verifica la instalación:

    ant --version

    Instalar el SDK

    Establece tu clave de API como variable de entorno:

    export ANTHROPIC_API_KEY="your-api-key-here"

    Crea tu primera sesión

    Todas las solicitudes a la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.

    Qué está ocurriendo

    Cuando envías un evento de usuario, Claude Managed Agents:

    1. Aprovisiona un contenedor: Tu configuración de entorno determina cómo se construye.
    2. Ejecuta el bucle del agente: Claude decide qué herramientas usar según tu mensaje
    3. Ejecuta herramientas: Las escrituras de archivos, los comandos bash y otras llamadas a herramientas se ejecutan dentro del contenedor
    4. Transmite eventos: Recibes actualizaciones en tiempo real mientras el agente trabaja
    5. Entra en reposo: El agente emite un evento session.status_idle cuando no tiene nada más que hacer

    Próximos pasos

    Define tu agente

    Crea configuraciones de agente reutilizables y versionadas

    Was this page helpful?

    • Conceptos principales
    • Requisitos previos
    • Instalar la CLI
    • Instalar el SDK
    • Crea tu primera sesión
    • Qué está ocurriendo
    • Próximos pasos
    1. 1

      Crear un agente

      Crea un agente que defina el modelo, el prompt del sistema y las herramientas disponibles.

      ant beta:agents create \
        --name "Coding Assistant" \
        --model '{id: claude-opus-4-7}' \
        --system "You are a helpful coding assistant. Write clean, well-documented code." \
        --tool '{type: agent_toolset_20260401}'

      El tipo de herramienta agent_toolset_20260401 habilita el conjunto completo de herramientas de agente predefinidas (bash, operaciones de archivos, búsqueda web y más). Consulta Herramientas para ver la lista completa y las opciones de configuración por herramienta.

      Guarda el agent.id devuelto. Lo referenciarás en cada sesión que crees.

    2. 2

      Crear un entorno

      Un entorno define el contenedor donde se ejecuta tu agente.

      ant beta:environments create \
        --name "quickstart-env" \
        --config '{type: cloud, networking: {type: unrestricted}}'

      Guarda el environment.id devuelto. Lo referenciarás en cada sesión que crees.

    3. 3

      Iniciar una sesión

      Crea una sesión que haga referencia a tu agente y entorno.

      session = client.beta.sessions.create(
          agent=agent.id,
          environment_id=environment.id,
          title="Quickstart session",
      )
      
      print(f"Session ID: {session.id}")
    4. 4

      Enviar un mensaje y transmitir la respuesta

      Abre un stream, envía un evento de usuario y luego procesa los eventos a medida que llegan:

      with client.beta.sessions.events.stream(session.id) as stream:
          # Send the user message after the stream opens
          client.beta.sessions.events.send(
              session.id,
              events=[
                  {
                      "type": "user.message",
                      "content": [
                          {
                              "type": "text",
                              "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                          },
                      ],
                  },
              ],
          )
      
          # Process streaming events
          for event in stream:
              match event.type:
                  case "agent.message":
                      for block in event.content:
                          print(block.text, end="")
                  case "agent.tool_use":
                      print(f"\n[Using tool: {event.name}]")
                  case "session.status_idle":
                      print("\n\nAgent finished.")
                      break

      El agente escribirá un script de Python, lo ejecutará en el contenedor y verificará que el archivo de salida fue creado. Tu salida se verá similar a esto:

      I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
      [Using tool: write]
      [Using tool: bash]
      The script ran successfully. Let me verify the output file.
      [Using tool: bash]
      fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).
      
      Agent finished.
    Configurar entornos

    Personaliza la configuración de red y del contenedor

    Herramientas del agente

    Habilita herramientas específicas para tu agente

    Eventos y streaming

    Maneja eventos y dirige al agente durante la ejecución