Funções Internas
Funções internas são ferramentas prontas para uso que não requerem configuração—apenas habilite-as e seu agente ganha novas capacidades instantaneamente. Estas ferramentas tratam tarefas comuns que LLMs notoriamente têm dificuldade.
Funções Disponíveis
| Ferramenta | O que faz | Sempre disponível |
|---|---|---|
calculator | Avalia uma expressão matemática e devolve o resultado numérico | Sim |
current_datetime | Devolve a data e a hora atuais para um fuso informado | Sim |
web_search | Busca na web e devolve resultados com títulos, URLs e trechos | Sim |
web_fetch | Busca uma URL e devolve o conteúdo como texto legível | Sim |
code_execution | Executa código em sandbox e devolve stdout, erros e arquivos gerados | Não |
As ferramentas marcadas como sempre disponíveis são carregadas mesmo com o carregamento sob demanda ligado; code_execution entra na busca.
Calculadora
Dá ao seu agente a capacidade de realizar cálculos matemáticos com precisão.
| Recurso | Descrição |
|---|---|
| Operações básicas | Adição, subtração, multiplicação, divisão |
| Matemática avançada | Porcentagens, expoentes, raízes |
| Precisão | Trata cálculos decimais corretamente |
Por Que Isso Importa
LLMs são notoriamente não confiáveis em matemática. Sem a ferramenta calculadora, perguntar "Quanto é 17% de R$234,50?" pode dar uma resposta errada. Com a calculadora, o agente delega matemática para um motor de cálculo confiável.
Exemplo de conversa:
Usuário: "Quero deixar 20% de gorjeta em uma conta de jantar de R$87,50. Quanto é?"
Agente: [Usa calculadora: 87.50 × 0.20 = 17.50] "Uma gorjeta de 20% em R$87,50 seria R$17,50, totalizando R$105,00."
Quando Habilitar
Sempre habilite a calculadora se seu agente pode encontrar:
- Cálculos de preços
- Perguntas sobre porcentagens
- Totais de pedidos
- Discussões financeiras
- Qualquer comparação numérica
Data e Hora Atual
Fornece ao seu agente consciência da data e hora atuais.
| Recurso | Descrição |
|---|---|
| Data atual | Data de hoje no fuso horário configurado |
| Hora atual | Hora atual com consciência de fuso horário |
| Dia da semana | Útil para contexto de agendamento |
Por Que Isso Importa
LLMs têm uma data de corte de conhecimento e não sabem inerentemente a data de "hoje". Sem esta ferramenta, um agente perguntado "A loja está aberta agora?" não conseguiria verificar contra o horário de funcionamento.
Exemplo de conversa:
Usuário: "Vocês abrem aos sábados?"
Agente: [Usa data/hora: Sábado, 18 de Janeiro de 2025, 14:30] "Sim, estamos abertos aos sábados! Na verdade, hoje é sábado e estamos abertos até as 18h. Como posso ajudar você hoje?"
Quando Habilitar
Habilite data/hora se seu agente trata:
- Perguntas sobre horário de funcionamento
- Agendamento de compromissos
- Ofertas sensíveis ao tempo
- Discussões sobre prazos
- Qualquer pergunta "quando"
Busca na Web
Permite que o agente pesquise na web e use os resultados, com títulos, URLs e trechos, para responder com informação atual.
Leitura de Páginas
web_fetch busca uma URL e devolve o conteúdo como texto legível, útil para ler uma página específica encontrada pela busca ou informada pelo usuário.
Execução de Código
code_execution roda código em sandbox e devolve stdout, erros e arquivos gerados. É a opção para cálculos e transformações que a calculadora não cobre.
Aliases depreciados
Os nomes antigos browser e code_interpreter continuam funcionando: browser aponta para web_search e code_interpreter para code_execution. Agentes criados antes da renomeação seguem válidos; use os nomes novos em agentes novos.
Configuração
Funções internas requerem setup mínimo:
- Navegue para Configuração do Agente > Ferramentas
- Encontre a seção Funções Internas
- Ative as funções que você precisa
- Salve as mudanças
É isso—nenhuma chave de API, nenhum endpoint, nenhuma configuração necessária.
Ao salvar, a plataforma valida os nomes das funções internas e recusa nomes desconhecidos com o erro unknown_internal_tool.
Melhores Práticas
1. Habilite Ambas por Padrão
A menos que você tenha uma razão específica para não habilitar, ative tanto calculadora quanto data/hora. Elas adicionam overhead mínimo e previnem erros constrangedores.
2. Confie no Julgamento do Agente
Você não precisa instruir o agente quando usar estas ferramentas. O agente usará automaticamente a calculadora para matemática e data/hora quando contexto temporal for necessário.
3. Combine com Instruções
Para negócios sensíveis ao tempo, inclua horário de funcionamento nas suas instruções:
## Horário de Funcionamento
- Segunda a Sexta: 9h - 18h
- Sábado: 10h - 16h
- Domingo: Fechado
Use a ferramenta de data/hora atual para determinar se estamos abertos
quando clientes perguntarem sobre disponibilidade.4. Trate Casos de Borda
Para cálculos complexos, adicione orientação:
## Cálculos de Preços
- Sempre calcule preços finais incluindo imposto (8,5%)
- Arredonde para duas casas decimais para valores monetários
- Para pedidos em atacado (10+ itens), aplique 15% de desconto antes do impostoLimitações
Limitações da Calculadora
- Trata aritmética padrão, não matemática simbólica
- Não resolverá equações (ex: "resolva para x")
- Conversões de unidades podem precisar de instruções explícitas
Limitações de Data/Hora
- Retorna fuso horário do servidor por padrão
- Não trata automaticamente o fuso horário local do usuário
- Não pode acessar dados históricos ou eventos futuros
Contornando Problemas de Fuso Horário
Se seus clientes estão em múltiplos fusos horários, instrua seu agente a perguntar:
Ao discutir horários, confirme o fuso horário do cliente:
"Só para garantir que eu dê o horário correto, em qual fuso horário você está?"Documentação Relacionada
- Visão Geral de Ferramentas - Entendendo ferramentas de agentes
- Integração com API - Conecte a APIs externas
- Instruções - Escrevendo prompts eficazes