Comece a usar o Claude Managed Agents

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

Conceitos principais

Pré-requisitos

• Uma conta do Claude Console
• Uma chave de API

Instale a CLI

brew install anthropics/tap/ant

VERSION=1.38.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

go install github.com/anthropics/anthropic-cli/cmd/ant@latest

export PATH="$PATH:$(go env GOPATH)/bin"

Verifique a instalação:

ant --version

Instale o SDK

pip install anthropic

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

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

Crie sua primeira sessão

1. 1

   Crie um agente

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

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply coding-assistant.md

   coding-assistant.md

   

   ---
   name: Coding Assistant
   model: claude-opus-5-5
   tools:
     - type: agent_toolset_20260401
   ---
   
   You are a helpful coding assistant. Write clean, well-documented code.

   ant apply exibe o ID do agente e o registra em claude-lock.json. Você fará referência a ele em todas as sessões que criar.

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

2. 2

   Crie um ambiente

   Um ambiente define o sandbox onde seu agente é executado.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply environment.yaml

   environment.yaml

   

   # yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
   name: quickstart-env
   config:
     type: cloud
     networking:
       type: limited
       allow_package_managers: true

   ant apply também registra o ID do ambiente em claude-lock.json. Para criar o agente e o ambiente com um único comando, passe os dois arquivos: ant apply coding-assistant.md environment.yaml.

3. 3

   Inicie uma sessão

   Crie uma sessão que faça referência ao seu agente e ao seu ambiente.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

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

4. 4

   Envie uma mensagem e faça o streaming da resposta

   Abra um stream, envie um evento de usuário e, em seguida, processe os eventos à medida que chegam:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   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:
                       if block.type == "text":
                           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 escreve um script Python, executa-o no sandbox e verifica 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.

   

O que está acontecendo

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

1. Provisiona um sandbox: A configuração do seu ambiente determina como ele é construído.
2. Executa o loop do agente: Claude determina 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 sandbox.
4. Faz streaming de 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.

Construa um aplicativo completo

Cada um destes quickstarts combina o Claude Managed Agents com um framework de chat popular para criar um aplicativo completo e executável. Em cada um, o framework renderiza a interface de chat enquanto uma sessão gerenciada executa o loop do agente no lado do servidor: a sessão mantém a transcrição, executa ferramentas em um sandbox e faz streaming de eventos que o front end renderiza.

Próximos passos