fix: correct code example language inconsistency in pt-BR docs (#3088)

* fix: correct code example language inconsistency in pt-BR docs

* fix: fix: fully standardize code example language and naming in pt-BR docs

* fix: fix: fully standardize code example language and naming in pt-BR docs fixed variables

* fix: fix: fully standardize code example language and naming in pt-BR docs fixed params

---------

Co-authored-by: Lucas Gomide <lucaslg200@gmail.com>
This commit is contained in:
Irineu Brito
2025-07-02 12:18:32 -04:00
committed by GitHub
parent ceb310bcde
commit 7f83947020
37 changed files with 545 additions and 634 deletions

View File

@@ -35,78 +35,18 @@ from crewai_tools import LinkupSearchTool
from crewai import Agent
import os
# Initialize the tool with your API key
linkup_tool = LinkupSearchTool(api_key=os.getenv("LINKUP_API_KEY"))
# Inicialize a ferramenta com sua chave de API
linkup_ferramenta = LinkupSearchTool(api_key=os.getenv("LINKUP_API_KEY"))
# Define an agent that uses the tool
# Defina um agente que usa a ferramenta
@agent
def researcher(self) -> Agent:
def pesquisador(self) -> Agent:
'''
This agent uses the LinkupSearchTool to retrieve contextual information
from the Linkup API.
Este agente usa o LinkupSearchTool para recuperar informações contextuais
da API do Linkup.
'''
return Agent(
config=self.agents_config["researcher"],
tools=[linkup_tool]
config=self.agentes_config["pesquisador"],
tools=[linkup_ferramenta]
)
```
## Parâmetros
O `LinkupSearchTool` aceita os seguintes parâmetros:
### Parâmetros do Construtor
- **api_key**: Obrigatório. Sua chave de API do Linkup.
### Parâmetros de Execução
- **query**: Obrigatório. O termo ou frase de busca.
- **depth**: Opcional. A profundidade da busca. O padrão é "standard".
- **output_type**: Opcional. O tipo de saída. O padrão é "searchResults".
## Uso Avançado
Você pode personalizar os parâmetros de busca para resultados mais específicos:
```python Code
# Perform a search with custom parameters
results = linkup_tool.run(
query="Women Nobel Prize Physics",
depth="deep",
output_type="searchResults"
)
```
## Formato de Retorno
A ferramenta retorna resultados no seguinte formato:
```json
{
"success": true,
"results": [
{
"name": "Result Title",
"url": "https://example.com/result",
"content": "Content of the result..."
},
// Additional results...
]
}
```
Se ocorrer um erro, a resposta será:
```json
{
"success": false,
"error": "Error message"
}
```
## Tratamento de Erros
A ferramenta lida com erros de API de forma amigável e fornece feedback estruturado. Se a requisição à API falhar, a ferramenta retornará um dicionário com `success: false` e uma mensagem de erro.
## Conclusão
O `LinkupSearchTool` oferece uma forma integrada de incorporar as capacidades de busca de informações contextuais do Linkup aos seus agentes CrewAI. Ao utilizar esta ferramenta, os agentes podem acessar informações relevantes e atualizadas para aprimorar sua tomada de decisão e execução de tarefas.
```