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
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
- ### **BasicClient**
28
+ ### **BiaClient**
29
29
 
30
- A classe `BasicClient` tem o objetivo de criar um cliente HTTP para comunicação com servidores MCP (Model Context Protocol).
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
- ### **Util**
37
+ ### **BiaUtil**
38
38
 
39
- A classe `Util` fornece métodos auxiliares para gerenciar headers de requisições e parâmetros de configuração em servidores MCP.
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 BasicClient
131
+ from biatoolkit.basic_client import BiaClient
132
132
 
133
133
  MCP_SERVER_URL = "http://0.0.0.0:8000/mcp"
134
- client = BasicClient(MCP_SERVER_URL)
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
- - **BasicClient**: É uma classe da biblioteca **Bia Toolkit** que encapsula um cliente HTTP para comunicação com servidores MCP.
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 BasicClient
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 = BasicClient(MCP_SERVER_URL, headers=headers)
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
- #### **Entendendo o código**
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 `Util` conforme a seguir:
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 Util
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 = Util(mcp)
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 `Util`.
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 Util
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 = Util(mcp)
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.3.dist-info/METADATA,sha256=3kUZGId145VtBiInuRnFqwdy9sJMEqbKqAHUAGYB0BA,13181
7
- biatoolkit-1.0.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
8
- biatoolkit-1.0.3.dist-info/top_level.txt,sha256=DyrMS0X6u1FDA9uT854LxoT3X7gzMAlsFQabE-WuKMc,11
9
- biatoolkit-1.0.3.dist-info/RECORD,,
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,,