inspiria-agentic-starter 0.1.0__tar.gz

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.

Potentially problematic release.


This version of inspiria-agentic-starter might be problematic. Click here for more details.

Files changed (25) hide show
  1. inspiria_agentic_starter-0.1.0/PKG-INFO +137 -0
  2. inspiria_agentic_starter-0.1.0/README.md +130 -0
  3. inspiria_agentic_starter-0.1.0/pyproject.toml +24 -0
  4. inspiria_agentic_starter-0.1.0/setup.cfg +4 -0
  5. inspiria_agentic_starter-0.1.0/src/ias/__init__.py +1 -0
  6. inspiria_agentic_starter-0.1.0/src/ias/__main__.py +3 -0
  7. inspiria_agentic_starter-0.1.0/src/ias/cli.py +54 -0
  8. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/.gitignore +9 -0
  9. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/README.md +103 -0
  10. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/README.md +304 -0
  11. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/agent_definition.yaml +122 -0
  12. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/.env.example +3 -0
  13. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/main.py +237 -0
  14. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/requirements.txt +1 -0
  15. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/test_definition.yaml +34 -0
  16. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/.env.example +3 -0
  17. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/main.py +128 -0
  18. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/requirements.txt +1 -0
  19. inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/test_definition.yaml +35 -0
  20. inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/PKG-INFO +137 -0
  21. inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/SOURCES.txt +23 -0
  22. inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/dependency_links.txt +1 -0
  23. inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/entry_points.txt +2 -0
  24. inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/top_level.txt +1 -0
  25. inspiria_agentic_starter-0.1.0/tests/test_cli.py +52 -0
@@ -0,0 +1,137 @@
1
+ Metadata-Version: 2.4
2
+ Name: inspiria-agentic-starter
3
+ Version: 0.1.0
4
+ Summary: Inspiria Agentic Starter: inicializador de projetos de agentes Weni
5
+ Requires-Python: >=3.10
6
+ Description-Content-Type: text/markdown
7
+
8
+ # IAS — Inspiria Agentic Starter
9
+
10
+ O IAS (Inspiria Agentic Starter) é uma ferramenta de linha de comando em Python que cria a estrutura inicial de projetos de agentes para a Weni Platform. Com `ias init`, você recebe um agente de exemplo, suas ferramentas e a documentação para começar a desenvolver.
11
+
12
+ O exemplo é um concierge de produtos com duas ferramentas: `search_products`, para pesquisar produtos, e `recommend_products`, para recomendar produtos conforme uma necessidade e um orçamento. Ambas usam o catálogo de demonstração da DummyJSON.
13
+
14
+ ## Requisitos
15
+
16
+ - Python 3.10 ou superior, com pip.
17
+ - Weni CLI para testar e publicar o agente. Consulte a [documentação de instalação](https://weni-ai.github.io/weni-cli/getting-started/installation/).
18
+
19
+ O IAS gera os arquivos. O Weni CLI e as dependências das ferramentas devem ser instalados separadamente.
20
+
21
+ ## Instalação via Python
22
+
23
+ Depois que este pacote estiver publicado no PyPI com o nome `inspiria-agentic-starter`:
24
+
25
+ ```bash
26
+ python -m pip install inspiria-agentic-starter
27
+ ```
28
+
29
+ Enquanto ele não estiver publicado, instale a partir da pasta deste repositório:
30
+
31
+ ```bash
32
+ python -m pip install .
33
+ ```
34
+
35
+ Para desenvolver o IAS com as alterações locais refletidas sem reinstalar:
36
+
37
+ ```bash
38
+ python -m pip install -e .
39
+ ```
40
+
41
+ Recomenda-se usar um ambiente virtual. Crie com `python -m venv .venv` e ative com `source .venv/bin/activate` no Linux/macOS ou `.venv\Scripts\Activate.ps1` no PowerShell.
42
+
43
+ ## Inicializar um projeto
44
+
45
+ Para criar o projeto em uma nova pasta:
46
+
47
+ ```bash
48
+ ias init meu-projeto
49
+ cd meu-projeto
50
+ ```
51
+
52
+ Para criar os arquivos na pasta atual:
53
+
54
+ ```bash
55
+ ias init
56
+ ```
57
+
58
+ Se o comando `ias` não estiver no PATH, use o Python diretamente:
59
+
60
+ ```bash
61
+ python -m ias init meu-projeto
62
+ ```
63
+
64
+ A estrutura gerada é:
65
+
66
+ ```text
67
+ meu-projeto/
68
+ ├── .gitignore
69
+ ├── README.md
70
+ └── agents/
71
+ └── concierge-agent/
72
+ ├── README.md
73
+ ├── agent_definition.yaml
74
+ └── tools/
75
+ ├── search_products/
76
+ │ ├── .env.example
77
+ │ ├── main.py
78
+ │ ├── requirements.txt
79
+ │ └── test_definition.yaml
80
+ └── recommend_products/
81
+ ├── .env.example
82
+ ├── main.py
83
+ ├── requirements.txt
84
+ └── test_definition.yaml
85
+ ```
86
+
87
+ O comando verifica os conflitos antes de criar os arquivos e recusa sobrescrever arquivos existentes, incluindo `README.md` e `.gitignore`. Se houver conflito, escolha outra pasta. Ele não inicializa um repositório Git automaticamente.
88
+
89
+ ## Configurar e executar o agente
90
+
91
+ 1. Leia `agents/concierge-agent/README.md` para conhecer as ferramentas e suas configurações.
92
+ 2. Copie o `.env.example` de cada ferramenta para um arquivo `.env` na mesma pasta e preencha as credenciais e a URL da API conforme essa documentação.
93
+ 3. Instale as dependências das ferramentas no ambiente de desenvolvimento, conforme seus arquivos `requirements.txt`.
94
+ 4. Com o Weni CLI instalado e configurado, execute os cenários de exemplo a partir da pasta do agente:
95
+
96
+ ```bash
97
+ cd agents/concierge-agent
98
+ weni run agent_definition.yaml concierge_agent search_products -v
99
+ weni run agent_definition.yaml concierge_agent recommend_products -v
100
+ ```
101
+
102
+ O `.gitignore` gerado ignora os arquivos de credenciais locais. Não inclua segredos reais nos arquivos versionados. O agente é um exemplo para aprendizado; revise sua documentação e limitações antes de adaptá-lo para produção.
103
+
104
+ ## Ajuda
105
+
106
+ ```bash
107
+ ias --help
108
+ ias init --help
109
+ ias --version
110
+ ```
111
+
112
+ ## Manutenção dos templates
113
+
114
+ Os arquivos copiados pelo comando ficam em `src/ias/templates/starter/`. O README dessa pasta é a documentação inicial entregue ao usuário do projeto gerado.
115
+
116
+ A pasta `agents/` preserva o exemplo original. Ao alterar o exemplo, atualize os arquivos correspondentes nos templates. Não inclua `.env`, `.globals`, credenciais reais ou arquivos ZIP nos templates.
117
+
118
+ Para executar os testes após instalar o pacote:
119
+
120
+ ```bash
121
+ python -m unittest discover -s tests
122
+ ```
123
+
124
+ ## Publicação no PyPI
125
+
126
+ O nome da distribuição no PyPI é `inspiria-agentic-starter`; o comando instalado continua sendo `ias`. Verifique a disponibilidade desse nome antes da primeira publicação.
127
+
128
+ Crie uma conta no PyPI, configure a autenticação de dois fatores e gere um token de API. Gere os arquivos em `dist/inspiria/` e envie somente os artefatos dessa distribuição:
129
+
130
+ ```bash
131
+ python -m pip install --upgrade build twine
132
+ python -m build --outdir dist/inspiria
133
+ python -m twine check dist/inspiria/*
134
+ python -m twine upload --username __token__ dist/inspiria/*
135
+ ```
136
+
137
+ Informe o token quando solicitado (usuário `__token__`, se solicitado). Não salve o token no repositório. Para experimentar, use uma conta e token separados no TestPyPI e `python -m twine upload --repository testpypi dist/inspiria/*`. Incremente `project.version` para cada nova publicação.
@@ -0,0 +1,130 @@
1
+ # IAS — Inspiria Agentic Starter
2
+
3
+ O IAS (Inspiria Agentic Starter) é uma ferramenta de linha de comando em Python que cria a estrutura inicial de projetos de agentes para a Weni Platform. Com `ias init`, você recebe um agente de exemplo, suas ferramentas e a documentação para começar a desenvolver.
4
+
5
+ O exemplo é um concierge de produtos com duas ferramentas: `search_products`, para pesquisar produtos, e `recommend_products`, para recomendar produtos conforme uma necessidade e um orçamento. Ambas usam o catálogo de demonstração da DummyJSON.
6
+
7
+ ## Requisitos
8
+
9
+ - Python 3.10 ou superior, com pip.
10
+ - Weni CLI para testar e publicar o agente. Consulte a [documentação de instalação](https://weni-ai.github.io/weni-cli/getting-started/installation/).
11
+
12
+ O IAS gera os arquivos. O Weni CLI e as dependências das ferramentas devem ser instalados separadamente.
13
+
14
+ ## Instalação via Python
15
+
16
+ Depois que este pacote estiver publicado no PyPI com o nome `inspiria-agentic-starter`:
17
+
18
+ ```bash
19
+ python -m pip install inspiria-agentic-starter
20
+ ```
21
+
22
+ Enquanto ele não estiver publicado, instale a partir da pasta deste repositório:
23
+
24
+ ```bash
25
+ python -m pip install .
26
+ ```
27
+
28
+ Para desenvolver o IAS com as alterações locais refletidas sem reinstalar:
29
+
30
+ ```bash
31
+ python -m pip install -e .
32
+ ```
33
+
34
+ Recomenda-se usar um ambiente virtual. Crie com `python -m venv .venv` e ative com `source .venv/bin/activate` no Linux/macOS ou `.venv\Scripts\Activate.ps1` no PowerShell.
35
+
36
+ ## Inicializar um projeto
37
+
38
+ Para criar o projeto em uma nova pasta:
39
+
40
+ ```bash
41
+ ias init meu-projeto
42
+ cd meu-projeto
43
+ ```
44
+
45
+ Para criar os arquivos na pasta atual:
46
+
47
+ ```bash
48
+ ias init
49
+ ```
50
+
51
+ Se o comando `ias` não estiver no PATH, use o Python diretamente:
52
+
53
+ ```bash
54
+ python -m ias init meu-projeto
55
+ ```
56
+
57
+ A estrutura gerada é:
58
+
59
+ ```text
60
+ meu-projeto/
61
+ ├── .gitignore
62
+ ├── README.md
63
+ └── agents/
64
+ └── concierge-agent/
65
+ ├── README.md
66
+ ├── agent_definition.yaml
67
+ └── tools/
68
+ ├── search_products/
69
+ │ ├── .env.example
70
+ │ ├── main.py
71
+ │ ├── requirements.txt
72
+ │ └── test_definition.yaml
73
+ └── recommend_products/
74
+ ├── .env.example
75
+ ├── main.py
76
+ ├── requirements.txt
77
+ └── test_definition.yaml
78
+ ```
79
+
80
+ O comando verifica os conflitos antes de criar os arquivos e recusa sobrescrever arquivos existentes, incluindo `README.md` e `.gitignore`. Se houver conflito, escolha outra pasta. Ele não inicializa um repositório Git automaticamente.
81
+
82
+ ## Configurar e executar o agente
83
+
84
+ 1. Leia `agents/concierge-agent/README.md` para conhecer as ferramentas e suas configurações.
85
+ 2. Copie o `.env.example` de cada ferramenta para um arquivo `.env` na mesma pasta e preencha as credenciais e a URL da API conforme essa documentação.
86
+ 3. Instale as dependências das ferramentas no ambiente de desenvolvimento, conforme seus arquivos `requirements.txt`.
87
+ 4. Com o Weni CLI instalado e configurado, execute os cenários de exemplo a partir da pasta do agente:
88
+
89
+ ```bash
90
+ cd agents/concierge-agent
91
+ weni run agent_definition.yaml concierge_agent search_products -v
92
+ weni run agent_definition.yaml concierge_agent recommend_products -v
93
+ ```
94
+
95
+ O `.gitignore` gerado ignora os arquivos de credenciais locais. Não inclua segredos reais nos arquivos versionados. O agente é um exemplo para aprendizado; revise sua documentação e limitações antes de adaptá-lo para produção.
96
+
97
+ ## Ajuda
98
+
99
+ ```bash
100
+ ias --help
101
+ ias init --help
102
+ ias --version
103
+ ```
104
+
105
+ ## Manutenção dos templates
106
+
107
+ Os arquivos copiados pelo comando ficam em `src/ias/templates/starter/`. O README dessa pasta é a documentação inicial entregue ao usuário do projeto gerado.
108
+
109
+ A pasta `agents/` preserva o exemplo original. Ao alterar o exemplo, atualize os arquivos correspondentes nos templates. Não inclua `.env`, `.globals`, credenciais reais ou arquivos ZIP nos templates.
110
+
111
+ Para executar os testes após instalar o pacote:
112
+
113
+ ```bash
114
+ python -m unittest discover -s tests
115
+ ```
116
+
117
+ ## Publicação no PyPI
118
+
119
+ O nome da distribuição no PyPI é `inspiria-agentic-starter`; o comando instalado continua sendo `ias`. Verifique a disponibilidade desse nome antes da primeira publicação.
120
+
121
+ Crie uma conta no PyPI, configure a autenticação de dois fatores e gere um token de API. Gere os arquivos em `dist/inspiria/` e envie somente os artefatos dessa distribuição:
122
+
123
+ ```bash
124
+ python -m pip install --upgrade build twine
125
+ python -m build --outdir dist/inspiria
126
+ python -m twine check dist/inspiria/*
127
+ python -m twine upload --username __token__ dist/inspiria/*
128
+ ```
129
+
130
+ Informe o token quando solicitado (usuário `__token__`, se solicitado). Não salve o token no repositório. Para experimentar, use uma conta e token separados no TestPyPI e `python -m twine upload --repository testpypi dist/inspiria/*`. Incremente `project.version` para cada nova publicação.
@@ -0,0 +1,24 @@
1
+ [build-system]
2
+ requires = ["setuptools>=77"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "inspiria-agentic-starter"
7
+ version = "0.1.0"
8
+ description = "Inspiria Agentic Starter: inicializador de projetos de agentes Weni"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ dependencies = []
12
+
13
+ [project.scripts]
14
+ ias = "ias.cli:main"
15
+
16
+ [tool.setuptools]
17
+ include-package-data = false
18
+
19
+ [tool.setuptools.packages.find]
20
+ where = ["src"]
21
+ namespaces = false
22
+
23
+ [tool.setuptools.package-data]
24
+ ias = ["templates/**/*.md", "templates/**/*.yaml", "templates/**/main.py", "templates/**/requirements.txt", "templates/**/.env.example", "templates/**/.gitignore"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1 @@
1
+ """IAS: inicializador de projetos de agentes Weni."""
@@ -0,0 +1,3 @@
1
+ from .cli import main
2
+
3
+ raise SystemExit(main())
@@ -0,0 +1,54 @@
1
+ """Interface de terminal do IAS, sem dependencias externas."""
2
+
3
+ import argparse
4
+ from importlib import resources
5
+ from importlib.metadata import version
6
+ from pathlib import Path
7
+ import sys
8
+
9
+
10
+ def _files(directory, relative=Path()):
11
+ for item in directory.iterdir():
12
+ path = relative / item.name
13
+ if item.is_dir():
14
+ yield from _files(item, path)
15
+ else:
16
+ yield path, item
17
+
18
+
19
+ def initialize(destination):
20
+ destination = Path(destination).absolute()
21
+ template = resources.files("ias").joinpath("templates", "starter")
22
+ files = list(_files(template))
23
+ # Check every destination before writing anything, including parent files
24
+ # and symlinks, which must never redirect template writes elsewhere.
25
+ for relative, _ in files:
26
+ target = destination / relative
27
+ if target.exists() or target.is_symlink():
28
+ raise FileExistsError(f"Arquivo ja existe: {target}")
29
+ for parent in target.parents:
30
+ if parent.is_symlink() or (parent.exists() and not parent.is_dir()):
31
+ raise FileExistsError(f"Destino invalido: {parent}")
32
+ for relative, source in files:
33
+ target = destination / relative
34
+ target.parent.mkdir(parents=True, exist_ok=True)
35
+ with target.open("xb") as output:
36
+ output.write(source.read_bytes())
37
+ return destination
38
+
39
+
40
+ def main(argv=None):
41
+ parser = argparse.ArgumentParser(description="Inicialize um projeto de agentes Weni.")
42
+ parser.add_argument("--version", action="version", version=version("inspiria-agentic-starter"))
43
+ commands = parser.add_subparsers(dest="command", required=True)
44
+ init = commands.add_parser("init", help="Cria o projeto inicial sem sobrescrever arquivos.")
45
+ init.add_argument("directory", nargs="?", default=".", help="Pasta de destino (padrao: pasta atual).")
46
+ args = parser.parse_args(argv)
47
+ try:
48
+ destination = initialize(args.directory)
49
+ except OSError as error:
50
+ print(f"Erro: {error}", file=sys.stderr)
51
+ return 1
52
+ print(f"Projeto criado em {destination}")
53
+ print("Consulte README.md para os primeiros passos e agents/concierge-agent/README.md para configurar o agente.")
54
+ return 0
@@ -0,0 +1,9 @@
1
+ .env
2
+ **/.env
3
+ .globals
4
+ **/.globals
5
+ .venv/
6
+ venv/
7
+ __pycache__/
8
+ *.pyc
9
+ *.zip
@@ -0,0 +1,103 @@
1
+ # IAS — Inspiria Agentic Starter
2
+
3
+ O IAS (Inspiria Agentic Starter) é uma ferramenta de linha de comando em Python que cria a estrutura inicial de projetos de agentes para a Weni Platform. Com `ias init`, você recebe um agente de exemplo, suas ferramentas e a documentação para começar a desenvolver.
4
+
5
+ O exemplo é um concierge de produtos com duas ferramentas: `search_products`, para pesquisar produtos, e `recommend_products`, para recomendar produtos conforme uma necessidade e um orçamento. Ambas usam o catálogo de demonstração da DummyJSON.
6
+
7
+ ## Requisitos
8
+
9
+ - Python 3.10 ou superior, com pip.
10
+ - Weni CLI para testar e publicar o agente. Consulte a [documentação de instalação](https://weni-ai.github.io/weni-cli/getting-started/installation/).
11
+
12
+ O IAS gera os arquivos. O Weni CLI e as dependências das ferramentas devem ser instalados separadamente.
13
+
14
+ ## Instalação via Python
15
+
16
+ Depois que este pacote estiver publicado no PyPI com o nome `inspiria-agentic-starter`:
17
+
18
+ ```bash
19
+ python -m pip install inspiria-agentic-starter
20
+ ```
21
+
22
+ Enquanto ele não estiver publicado, instale a partir da pasta deste repositório:
23
+
24
+ ```bash
25
+ python -m pip install .
26
+ ```
27
+
28
+ Para desenvolver o IAS com as alterações locais refletidas sem reinstalar:
29
+
30
+ ```bash
31
+ python -m pip install -e .
32
+ ```
33
+
34
+ Recomenda-se usar um ambiente virtual. Crie com `python -m venv .venv` e ative com `source .venv/bin/activate` no Linux/macOS ou `.venv\Scripts\Activate.ps1` no PowerShell.
35
+
36
+ ## Inicializar um projeto
37
+
38
+ Para criar o projeto em uma nova pasta:
39
+
40
+ ```bash
41
+ ias init meu-projeto
42
+ cd meu-projeto
43
+ ```
44
+
45
+ Para criar os arquivos na pasta atual:
46
+
47
+ ```bash
48
+ ias init
49
+ ```
50
+
51
+ Se o comando `ias` não estiver no PATH, use o Python diretamente:
52
+
53
+ ```bash
54
+ python -m ias init meu-projeto
55
+ ```
56
+
57
+ A estrutura gerada é:
58
+
59
+ ```text
60
+ meu-projeto/
61
+ ├── .gitignore
62
+ ├── README.md
63
+ └── agents/
64
+ └── concierge-agent/
65
+ ├── README.md
66
+ ├── agent_definition.yaml
67
+ └── tools/
68
+ ├── search_products/
69
+ │ ├── .env.example
70
+ │ ├── main.py
71
+ │ ├── requirements.txt
72
+ │ └── test_definition.yaml
73
+ └── recommend_products/
74
+ ├── .env.example
75
+ ├── main.py
76
+ ├── requirements.txt
77
+ └── test_definition.yaml
78
+ ```
79
+
80
+ O comando verifica os conflitos antes de criar os arquivos e recusa sobrescrever arquivos existentes, incluindo `README.md` e `.gitignore`. Se houver conflito, escolha outra pasta. Ele não inicializa um repositório Git automaticamente.
81
+
82
+ ## Configurar e executar o agente
83
+
84
+ 1. Leia `agents/concierge-agent/README.md` para conhecer as ferramentas e suas configurações.
85
+ 2. Copie o `.env.example` de cada ferramenta para um arquivo `.env` na mesma pasta e preencha as credenciais e a URL da API conforme essa documentação.
86
+ 3. Instale as dependências das ferramentas no ambiente de desenvolvimento, conforme seus arquivos `requirements.txt`.
87
+ 4. Com o Weni CLI instalado e configurado, execute os cenários de exemplo a partir da pasta do agente:
88
+
89
+ ```bash
90
+ cd agents/concierge-agent
91
+ weni run agent_definition.yaml concierge_agent search_products -v
92
+ weni run agent_definition.yaml concierge_agent recommend_products -v
93
+ ```
94
+
95
+ O `.gitignore` gerado ignora os arquivos de credenciais locais. Não inclua segredos reais nos arquivos versionados. O agente é um exemplo para aprendizado; revise sua documentação e limitações antes de adaptá-lo para produção.
96
+
97
+ ## Ajuda
98
+
99
+ ```bash
100
+ ias --help
101
+ ias init --help
102
+ ias --version
103
+ ```