biatoolkit 1.0.3__py3-none-any.whl → 1.0.4__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: biatoolkit
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.4
|
|
4
4
|
Summary: Biblioteca para desenvolvedores que utilizam o BiaAgentBuilder
|
|
5
5
|
Author: Bia Platform Team
|
|
6
6
|
Author-email: data.platform@sankhya.com.br
|
|
@@ -25,18 +25,18 @@ Biblioteca Python para facilitar o desenvolvimento de servidores MCP integrados
|
|
|
25
25
|
|
|
26
26
|
Nesta seção você encontrará uma breve descrição de cada classe da biblioteca **Bia Toolkit**.
|
|
27
27
|
|
|
28
|
-
### **
|
|
28
|
+
### **BiaClient**
|
|
29
29
|
|
|
30
|
-
A classe `
|
|
30
|
+
A classe `BiaClient` tem o objetivo de criar um cliente HTTP para comunicação com servidores MCP (Model Context Protocol).
|
|
31
31
|
|
|
32
32
|
**Principais métodos**:
|
|
33
33
|
|
|
34
34
|
- **list_tools**: Lista todas as ferramentas disponíveis no servidor MCP.
|
|
35
35
|
- **call_tool**: Executa uma ferramenta específica no servidor MCP.
|
|
36
36
|
|
|
37
|
-
### **
|
|
37
|
+
### **BiaUtil**
|
|
38
38
|
|
|
39
|
-
A classe `
|
|
39
|
+
A classe `BiaUtil` fornece métodos auxiliares para gerenciar headers de requisições e parâmetros de configuração em servidores MCP.
|
|
40
40
|
|
|
41
41
|
**Principais métodos**:
|
|
42
42
|
|
|
@@ -128,10 +128,10 @@ Crie um novo arquivo chamado `local.py` com o seguinte conteúdo:
|
|
|
128
128
|
|
|
129
129
|
```python
|
|
130
130
|
import asyncio
|
|
131
|
-
from biatoolkit.basic_client import
|
|
131
|
+
from biatoolkit.basic_client import BiaClient
|
|
132
132
|
|
|
133
133
|
MCP_SERVER_URL = "http://0.0.0.0:8000/mcp"
|
|
134
|
-
client =
|
|
134
|
+
client = BiaClient(MCP_SERVER_URL)
|
|
135
135
|
|
|
136
136
|
async def list_tools() -> None:
|
|
137
137
|
tools = await client.list_tools()
|
|
@@ -153,7 +153,7 @@ asyncio.run(main())
|
|
|
153
153
|
|
|
154
154
|
#### **Entendendo o código**
|
|
155
155
|
|
|
156
|
-
- **
|
|
156
|
+
- **BiaClient**: É uma classe da biblioteca **Bia Toolkit** que encapsula um cliente HTTP para comunicação com servidores MCP.
|
|
157
157
|
- **list_tools**: Executa a instrução `client.list_tools()` para recuperar todas as ferramentas disponíveis no servidor MCP.
|
|
158
158
|
- **call_tool**: Executa a instrução `client.call_tool(tool_name, params)` para executar uma ferramenta específica do servidor MCP.
|
|
159
159
|
|
|
@@ -204,7 +204,7 @@ Se seu servidor MCP estiver sendo executado **localmente**, você conseguirá in
|
|
|
204
204
|
|
|
205
205
|
```python
|
|
206
206
|
import asyncio
|
|
207
|
-
from biatoolkit.basic_client import
|
|
207
|
+
from biatoolkit.basic_client import BiaClient
|
|
208
208
|
|
|
209
209
|
MCP_SERVER_URL = "http://0.0.0.0:8000/mcp"
|
|
210
210
|
|
|
@@ -226,7 +226,7 @@ headers = {
|
|
|
226
226
|
"Content-Type": "application/json"
|
|
227
227
|
}
|
|
228
228
|
|
|
229
|
-
client =
|
|
229
|
+
client = BiaClient(MCP_SERVER_URL, headers=headers)
|
|
230
230
|
|
|
231
231
|
async def list_tools() -> None:
|
|
232
232
|
tools = await client.list_tools()
|
|
@@ -246,19 +246,13 @@ async def main():
|
|
|
246
246
|
asyncio.run(main())
|
|
247
247
|
```
|
|
248
248
|
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
- **headers**: Veja que a variável `headers` é definida com a lista de parâmetros válidos e depois utilizada em `client = BasicClient(MCP_SERVER_URL, headers=headers)`.
|
|
252
|
-
|
|
253
|
-
⚠️ IMPORTANTE: Ao utilizar os serviços de interação com a Bia (**/agent/stream**, **/agent/message** ou **/agent/invoke**), os parâmetros já são automaticamente preenchidos e enviados pelos serviços.
|
|
254
|
-
|
|
255
|
-
### **Recuperando os parâmetros no MCP Server enviados via header**
|
|
249
|
+
...existing code...
|
|
256
250
|
|
|
257
|
-
Para recuperar os parâmetros no MCP Server que foram enviados por meio do `header` da requisição, basta utilizar a classe `
|
|
251
|
+
Para recuperar os parâmetros no MCP Server que foram enviados por meio do `header` da requisição, basta utilizar a classe `BiaUtil` conforme a seguir:
|
|
258
252
|
|
|
259
253
|
```python
|
|
260
254
|
from mcp.server.fastmcp import FastMCP
|
|
261
|
-
from biatoolkit.util import
|
|
255
|
+
from biatoolkit.util import BiaUtil
|
|
262
256
|
|
|
263
257
|
mcp = FastMCP(host="0.0.0.0", stateless_http=True)
|
|
264
258
|
|
|
@@ -266,7 +260,7 @@ mcp = FastMCP(host="0.0.0.0", stateless_http=True)
|
|
|
266
260
|
def processar() -> str:
|
|
267
261
|
"""Executa o processamento de algo"""
|
|
268
262
|
|
|
269
|
-
util =
|
|
263
|
+
util = BiaUtil(mcp)
|
|
270
264
|
header = util.get_header()
|
|
271
265
|
|
|
272
266
|
# Exemplo de uso dos parâmetros do header. Utilize conforme a necessidade
|
|
@@ -296,11 +290,11 @@ Você pode utilizar parâmetros sensíveis de duas formas:
|
|
|
296
290
|
- Usando o cofre de segredos do Bia Agent Builder para execução em ambiente produtivo.
|
|
297
291
|
- Você pode adicionar parâmetros sensíveis no cofre de segredos do Bia Agent Builder. Para adicionar, alterar e excluir os parâmetros do cofre, utilize as funcionalidades da Plataforma Bia Agent Builder UI.
|
|
298
292
|
|
|
299
|
-
Para recuperar um valor sensível no seu MCP Server, utilize o método `get_parameter(parameter_name: str)` da classe `
|
|
293
|
+
Para recuperar um valor sensível no seu MCP Server, utilize o método `get_parameter(parameter_name: str)` da classe `BiaUtil`.
|
|
300
294
|
|
|
301
295
|
```python
|
|
302
296
|
from mcp.server.fastmcp import FastMCP
|
|
303
|
-
from biatoolkit.util import
|
|
297
|
+
from biatoolkit.util import BiaUtil
|
|
304
298
|
|
|
305
299
|
mcp = FastMCP(host="0.0.0.0", stateless_http=True)
|
|
306
300
|
|
|
@@ -308,7 +302,7 @@ mcp = FastMCP(host="0.0.0.0", stateless_http=True)
|
|
|
308
302
|
def processar() -> str:
|
|
309
303
|
"""Executa o processamento de algo"""
|
|
310
304
|
|
|
311
|
-
util =
|
|
305
|
+
util = BiaUtil(mcp)
|
|
312
306
|
valor = util.get_parameter("meu_parametro")
|
|
313
307
|
|
|
314
308
|
# Exemplo de uso do parâmetro recuperado. Utilize conforme a necessidade
|
|
@@ -3,7 +3,7 @@ biatoolkit/basic_client.py,sha256=_N2-NcrVWfm-rUuJUksOdR8GONmLYzooMhX1El49A3c,25
|
|
|
3
3
|
biatoolkit/util.py,sha256=wP1r29MLVk27iMnMG_Xywa6Yt6H-XfHdlrb4u8Tmg6c,3288
|
|
4
4
|
biatoolkit/schema/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
5
5
|
biatoolkit/schema/header.py,sha256=COJPlqK1cFvvWzDcCw2ru1jszWPgyyvabkjzDCc8AjM,683
|
|
6
|
-
biatoolkit-1.0.
|
|
7
|
-
biatoolkit-1.0.
|
|
8
|
-
biatoolkit-1.0.
|
|
9
|
-
biatoolkit-1.0.
|
|
6
|
+
biatoolkit-1.0.4.dist-info/METADATA,sha256=gvwk1ZY8qMHWxqsBfhIyO5t7yeWkr31m2zxXGJV0I5Q,12724
|
|
7
|
+
biatoolkit-1.0.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
|
|
8
|
+
biatoolkit-1.0.4.dist-info/top_level.txt,sha256=DyrMS0X6u1FDA9uT854LxoT3X7gzMAlsFQabE-WuKMc,11
|
|
9
|
+
biatoolkit-1.0.4.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|