Loading...
    • Construir
    • Admin
    • Modelos e preços
    • SDKs do cliente
    • Referência da API
    Search...
    ⌘K
    Log in
    Início 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/Primeiros passos

    Comece com Claude Managed Agents

    Crie seu primeiro agente autônomo.

    Was this page helpful?

    • Conceitos principais
    • Pré-requisitos
    • Instalar a CLI
    • Instalar o SDK
    • Crie sua primeira sessão
    • O que está acontecendo
    • Próximos passos

    Este guia orienta você na criação de um agente, configuração de um ambiente, início de uma sessão e transmissão de respostas do agente.

    Conceitos principais

    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)

    Pré-requisitos

    • Uma conta no Console da Anthropic
    • Uma chave de API

    Instalar a CLI

    Verifique a instalação:

    ant --version

    Instalar o SDK

    Defina sua chave de API como uma variável de ambiente:

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

    Crie sua primeira sessão

    Todas as requisições à API do Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente.

    O que está acontecendo

    Quando você envia um evento de usuário, o Claude Managed Agents:

    1. Provisiona um contêiner: Sua configuração de ambiente determina como ele é construído.
    2. Executa o loop do agente: Claude decide quais ferramentas usar com base na sua mensagem
    3. Executa ferramentas: Gravações de arquivos, comandos bash e outras chamadas de ferramentas são executadas dentro do contêiner
    4. Transmite eventos: Você recebe atualizações em tempo real enquanto o agente trabalha
    5. Fica ocioso: O agente emite um evento session.status_idle quando não tem mais nada a fazer

    Próximos passos

    Defina seu agente

    Crie configurações de agente reutilizáveis e versionadas

    1. 1

      Criar um agente

      Crie um agente que define o modelo, o prompt do sistema e as ferramentas disponíveis.

      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}'

      O tipo de ferramenta agent_toolset_20260401 habilita o conjunto completo de ferramentas de agente pré-construídas (bash, operações de arquivo, pesquisa na web e mais). Consulte Ferramentas para a lista completa e opções de configuração por ferramenta.

      Salve o agent.id retornado. Você o referenciará em cada sessão que criar.

    2. 2

      Criar um ambiente

      Um ambiente define o contêiner onde seu agente é executado.

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

      Salve o environment.id retornado. Você o referenciará em cada sessão que criar.

    3. 3

      Iniciar uma sessão

      Crie uma sessão que referencia seu agente e ambiente.

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

      Enviar uma mensagem e transmitir a resposta

      Abra um stream, envie um evento de usuário e processe os eventos conforme chegam:

      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

      O agente escreverá um script Python, o executará no contêiner e verificará se o arquivo de saída foi criado. Sua saída será semelhante a esta:

      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.
    Configure ambientes

    Personalize configurações de rede e contêiner

    Ferramentas do agente

    Habilite ferramentas específicas para seu agente

    Eventos e streaming

    Gerencie eventos e direcione o agente durante a execução